From db267bc191f906f55eaef21a27110cce2ec57fdf Mon Sep 17 00:00:00 2001 From: The Android Open Source Project Date: Tue, 12 Jan 2010 15:18:32 -0800 Subject: [PATCH] android-2.1_r1 snapshot --- README | 33 + bin/proguard.bat | 10 + bin/proguard.sh | 9 + bin/proguardgui.bat | 10 + bin/proguardgui.sh | 9 + bin/retrace.bat | 10 + bin/retrace.sh | 9 + build/build.sh | 94 + build/build.xml | 171 + build/makefile | 94 + docs/FAQ.html | 254 ++ docs/GPL.html | 406 ++ docs/GPL_exception.html | 52 + docs/acknowledgements.html | 68 + docs/alternatives.html | 657 ++++ docs/checkmark.gif | Bin 0 -> 63 bytes docs/downloads.html | 521 +++ docs/drop1.gif | Bin 0 -> 803 bytes docs/drop2.gif | Bin 0 -> 620 bytes docs/drop3.gif | Bin 0 -> 175 bytes docs/favicon.ico | Bin 0 -> 7406 bytes docs/feedback.html | 106 + docs/index.html | 72 + docs/license.html | 47 + docs/luciadlogo.png | Bin 0 -> 2356 bytes docs/main.html | 92 + docs/manual/ant.html | 610 +++ docs/manual/attention.gif | Bin 0 -> 896 bytes docs/manual/examples.html | 1302 +++++++ docs/manual/gui.html | 474 +++ docs/manual/index.html | 39 + docs/manual/introduction.html | 156 + docs/manual/limitations.html | 64 + docs/manual/optimizations.html | 158 + docs/manual/refcard.html | 465 +++ docs/manual/retrace/examples.html | 336 ++ docs/manual/retrace/index.html | 25 + docs/manual/retrace/introduction.html | 68 + docs/manual/retrace/usage.html | 117 + docs/manual/sections.html | 64 + docs/manual/style.css | 92 + docs/manual/troubleshooting.html | 592 +++ docs/manual/usage.html | 1231 ++++++ docs/manual/wtk.html | 58 + docs/quality.html | 44 + docs/results.html | 155 + docs/sanawarelogo.png | Bin 0 -> 8552 bytes docs/screenshot_console.gif | Bin 0 -> 18930 bytes docs/screenshot_console_small.gif | Bin 0 -> 19730 bytes docs/screenshot_gui1.gif | Bin 0 -> 42755 bytes docs/screenshot_gui2.gif | Bin 0 -> 36887 bytes docs/screenshot_gui3.gif | Bin 0 -> 37080 bytes docs/screenshot_gui4.gif | Bin 0 -> 40769 bytes docs/screenshot_gui5.gif | Bin 0 -> 35909 bytes docs/screenshot_gui6.gif | Bin 0 -> 37123 bytes docs/screenshot_gui7.gif | Bin 0 -> 41922 bytes docs/screenshot_gui8.gif | Bin 0 -> 31454 bytes docs/screenshots.html | 56 + docs/screenshots_gui_small.gif | Bin 0 -> 161022 bytes docs/sections.html | 62 + docs/sflogo.png | Bin 0 -> 469 bytes docs/steel.gif | Bin 0 -> 2759 bytes docs/style.css | 210 ++ docs/testimonials.html | 122 + docs/title.gif | Bin 0 -> 2613 bytes docs/title.html | 17 + examples/annotations/examples.pro | 61 + examples/annotations/examples/Applet.java | 22 + .../annotations/examples/Application.java | 20 + examples/annotations/examples/Bean.java | 56 + .../annotations/examples/NativeCallBack.java | 44 + examples/annotations/lib/annotations.jar | Bin 0 -> 6123 bytes examples/annotations/lib/annotations.pro | 118 + .../src/proguard/annotation/Keep.java | 18 + .../proguard/annotation/KeepApplication.java | 18 + .../annotation/KeepClassMemberNames.java | 18 + .../proguard/annotation/KeepClassMembers.java | 18 + .../annotation/KeepGettersSetters.java | 18 + .../annotation/KeepImplementations.java | 18 + .../src/proguard/annotation/KeepName.java | 18 + .../KeepPublicClassMemberNames.java | 18 + .../annotation/KeepPublicClassMembers.java | 18 + .../annotation/KeepPublicGettersSetters.java | 18 + .../annotation/KeepPublicImplementations.java | 18 + .../KeepPublicProtectedClassMemberNames.java | 18 + .../KeepPublicProtectedClassMembers.java | 19 + examples/ant/applets.xml | 81 + examples/ant/applications1.xml | 15 + examples/ant/applications2.xml | 68 + examples/ant/applications3.xml | 92 + examples/ant/library.xml | 102 + examples/ant/midlets.xml | 45 + examples/ant/proguard.xml | 73 + examples/ant/servlets.xml | 81 + examples/applets.pro | 60 + examples/applications.pro | 66 + examples/dictionaries/compact.txt | 18 + examples/dictionaries/keywords.txt | 58 + examples/dictionaries/shakespeare.txt | 23 + examples/dictionaries/windows.txt | 209 + examples/library.pro | 78 + examples/midlets.pro | 56 + examples/proguard.pro | 57 + examples/proguardall.pro | 62 + examples/proguardgui.pro | 55 + examples/retrace.pro | 43 + examples/servlets.pro | 61 + lib/proguard.jar | Bin 0 -> 664512 bytes lib/proguardgui.jar | Bin 0 -> 137516 bytes lib/retrace.jar | Bin 0 -> 6888 bytes src/proguard/ArgumentWordReader.java | 110 + src/proguard/ClassPath.java | 94 + src/proguard/ClassPathEntry.java | 149 + src/proguard/ClassSpecification.java | 259 ++ .../ClassSpecificationVisitorFactory.java | 502 +++ src/proguard/Configuration.java | 321 ++ src/proguard/ConfigurationConstants.java | 121 + src/proguard/ConfigurationParser.java | 1257 +++++++ src/proguard/ConfigurationWriter.java | 643 ++++ src/proguard/DataEntryReaderFactory.java | 155 + src/proguard/DataEntryWriterFactory.java | 164 + src/proguard/DescriptorKeepChecker.java | 163 + src/proguard/DuplicateClassPrinter.java | 63 + src/proguard/FileWordReader.java | 89 + .../FullyQualifiedClassNameChecker.java | 190 + src/proguard/GPL.java | 191 + src/proguard/Initializer.java | 411 ++ src/proguard/InputReader.java | 233 ++ src/proguard/KeepClassSpecification.java | 137 + src/proguard/MANIFEST.MF | 2 + src/proguard/MemberSpecification.java | 114 + src/proguard/OutputWriter.java | 256 ++ src/proguard/ParseException.java | 51 + src/proguard/ProGuard.java | 519 +++ src/proguard/SubclassedClassFilter.java | 62 + src/proguard/Targeter.java | 88 + src/proguard/UpToDateChecker.java | 153 + src/proguard/WordReader.java | 326 ++ src/proguard/ant/ClassPathElement.java | 191 + .../ant/ClassSpecificationElement.java | 257 ++ src/proguard/ant/ConfigurationElement.java | 53 + src/proguard/ant/ConfigurationTask.java | 440 +++ src/proguard/ant/FilterElement.java | 85 + .../ant/KeepSpecificationElement.java | 87 + .../ant/MemberSpecificationElement.java | 215 ++ src/proguard/ant/ProGuardTask.java | 320 ++ src/proguard/ant/package.html | 3 + src/proguard/ant/task.properties | 2 + src/proguard/classfile/ClassConstants.java | 255 ++ src/proguard/classfile/ClassPool.java | 147 + src/proguard/classfile/Clazz.java | 232 ++ src/proguard/classfile/Field.java | 32 + src/proguard/classfile/LibraryClass.java | 489 +++ src/proguard/classfile/LibraryField.java | 77 + src/proguard/classfile/LibraryMember.java | 108 + src/proguard/classfile/LibraryMethod.java | 83 + src/proguard/classfile/Member.java | 57 + src/proguard/classfile/Method.java | 32 + src/proguard/classfile/ProgramClass.java | 494 +++ src/proguard/classfile/ProgramField.java | 93 + src/proguard/classfile/ProgramMember.java | 168 + src/proguard/classfile/ProgramMethod.java | 99 + src/proguard/classfile/VisitorAccepter.java | 47 + .../classfile/attribute/Attribute.java | 142 + .../classfile/attribute/CodeAttribute.java | 202 + .../attribute/ConstantValueAttribute.java | 62 + .../attribute/DeprecatedAttribute.java | 66 + .../attribute/EnclosingMethodAttribute.java | 132 + .../classfile/attribute/ExceptionInfo.java | 100 + .../attribute/ExceptionsAttribute.java | 80 + .../attribute/InnerClassesAttribute.java | 80 + .../classfile/attribute/InnerClassesInfo.java | 122 + .../classfile/attribute/LineNumberInfo.java | 50 + .../attribute/LineNumberTableAttribute.java | 100 + .../attribute/LocalVariableInfo.java | 83 + .../LocalVariableTableAttribute.java | 79 + .../attribute/LocalVariableTypeInfo.java | 91 + .../LocalVariableTypeTableAttribute.java | 79 + .../attribute/SignatureAttribute.java | 100 + .../attribute/SourceDirAttribute.java | 62 + .../attribute/SourceFileAttribute.java | 62 + .../attribute/SyntheticAttribute.java | 66 + .../classfile/attribute/UnknownAttribute.java | 82 + .../attribute/annotation/Annotation.java | 143 + .../AnnotationDefaultAttribute.java | 73 + .../annotation/AnnotationElementValue.java | 76 + .../annotation/AnnotationsAttribute.java | 100 + .../annotation/ArrayElementValue.java | 82 + .../annotation/ClassElementValue.java | 95 + .../annotation/ConstantElementValue.java | 71 + .../attribute/annotation/ElementValue.java | 126 + .../annotation/EnumConstantElementValue.java | 99 + .../ParameterAnnotationsAttribute.java | 83 + .../RuntimeInvisibleAnnotationsAttribute.java | 70 + ...nvisibleParameterAnnotationsAttribute.java | 62 + .../RuntimeVisibleAnnotationsAttribute.java | 70 + ...eVisibleParameterAnnotationsAttribute.java | 62 + .../attribute/annotation/package.html | 4 + .../visitor/AllAnnotationVisitor.java | 100 + .../visitor/AnnotatedClassVisitor.java | 62 + .../visitor/AnnotationToMemberVisitor.java | 62 + .../visitor/AnnotationTypeFilter.java | 102 + .../annotation/visitor/AnnotationVisitor.java | 40 + .../visitor/ElementValueVisitor.java | 51 + .../attribute/annotation/visitor/package.html | 3 + src/proguard/classfile/attribute/package.html | 3 + .../attribute/preverification/DoubleType.java | 66 + .../attribute/preverification/FloatType.java | 66 + .../attribute/preverification/FullFrame.java | 202 + .../preverification/IntegerType.java | 66 + .../preverification/LessZeroFrame.java | 103 + .../attribute/preverification/LongType.java | 66 + .../preverification/MoreZeroFrame.java | 161 + .../attribute/preverification/NullType.java | 66 + .../attribute/preverification/ObjectType.java | 107 + .../preverification/SameOneFrame.java | 115 + .../preverification/SameZeroFrame.java | 74 + .../preverification/StackMapAttribute.java | 91 + .../preverification/StackMapFrame.java | 117 + .../StackMapTableAttribute.java | 93 + .../attribute/preverification/TopType.java | 66 + .../UninitializedThisType.java | 66 + .../preverification/UninitializedType.java | 106 + .../preverification/VerificationType.java | 103 + .../VerificationTypeFactory.java | 112 + .../visitor/StackMapFrameVisitor.java | 40 + .../visitor/VerificationTypeVisitor.java | 65 + .../visitor/AllAttributeVisitor.java | 117 + .../visitor/AllExceptionInfoVisitor.java | 55 + .../visitor/AttributeNameFilter.java | 345 ++ .../attribute/visitor/AttributeVisitor.java | 89 + .../visitor/ExceptionInfoVisitor.java | 37 + .../visitor/InnerClassesInfoVisitor.java | 38 + .../visitor/LineNumberInfoVisitor.java | 38 + .../visitor/LocalVariableInfoVisitor.java | 38 + .../visitor/LocalVariableTypeInfoVisitor.java | 38 + .../visitor/MultiAttributeVisitor.java | 356 ++ .../visitor/RequiredAttributeFilter.java | 351 ++ .../attribute/visitor/StackSizeComputer.java | 379 ++ .../classfile/attribute/visitor/package.html | 3 + .../classfile/constant/ClassConstant.java | 105 + src/proguard/classfile/constant/Constant.java | 68 + .../classfile/constant/DoubleConstant.java | 82 + .../classfile/constant/FieldrefConstant.java | 71 + .../classfile/constant/FloatConstant.java | 82 + .../classfile/constant/IntegerConstant.java | 82 + .../constant/InterfaceMethodrefConstant.java | 71 + .../classfile/constant/LongConstant.java | 82 + .../classfile/constant/MethodrefConstant.java | 71 + .../constant/NameAndTypeConstant.java | 119 + .../classfile/constant/RefConstant.java | 130 + .../classfile/constant/StringConstant.java | 135 + .../classfile/constant/Utf8Constant.java | 285 ++ .../constant/visitor/AllConstantVisitor.java | 53 + .../constant/visitor/ConstantVisitor.java | 46 + .../visitor/ExceptClassConstantFilter.java | 69 + .../classfile/constant/visitor/package.html | 3 + .../classfile/editor/AccessFixer.java | 164 + .../classfile/editor/AnnotationAdder.java | 153 + .../editor/AnnotationsAttributeEditor.java | 67 + .../classfile/editor/AttributeAdder.java | 457 +++ .../classfile/editor/AttributeSorter.java | 89 + .../classfile/editor/AttributesEditor.java | 269 ++ .../classfile/editor/ClassEditor.java | 255 ++ .../classfile/editor/ClassElementSorter.java | 52 + .../classfile/editor/ClassMemberSorter.java | 69 + .../classfile/editor/ClassReferenceFixer.java | 546 +++ .../editor/CodeAttributeComposer.java | 845 +++++ .../classfile/editor/CodeAttributeEditor.java | 1163 ++++++ .../editor/CodeAttributeEditorResetter.java | 60 + .../classfile/editor/ComparableConstant.java | 200 + .../classfile/editor/ConstantAdder.java | 194 + .../classfile/editor/ConstantPoolEditor.java | 665 ++++ .../editor/ConstantPoolRemapper.java | 617 +++ .../classfile/editor/ConstantPoolSorter.java | 126 + .../classfile/editor/ElementValueAdder.java | 217 ++ .../classfile/editor/ElementValuesEditor.java | 238 ++ .../classfile/editor/ExceptionAdder.java | 65 + .../classfile/editor/ExceptionInfoAdder.java | 67 + .../editor/ExceptionsAttributeEditor.java | 68 + .../classfile/editor/InstructionAdder.java | 76 + .../classfile/editor/InstructionWriter.java | 278 ++ .../classfile/editor/InterfaceAdder.java | 62 + .../classfile/editor/InterfaceSorter.java | 67 + .../classfile/editor/InterfacesEditor.java | 122 + .../classfile/editor/LineNumberInfoAdder.java | 59 + .../LineNumberTableAttributeEditor.java | 67 + .../editor/LocalVariableInfoAdder.java | 67 + .../LocalVariableTableAttributeEditor.java | 67 + .../editor/LocalVariableTypeInfoAdder.java | 68 + ...LocalVariableTypeTableAttributeEditor.java | 68 + .../classfile/editor/MemberAdder.java | 257 ++ .../editor/MemberReferenceFixer.java | 456 +++ .../editor/MethodInvocationFixer.java | 254 ++ .../editor/NamedAttributeDeleter.java | 54 + .../ParameterAnnotationsAttributeEditor.java | 71 + .../classfile/editor/StackSizeUpdater.java | 54 + .../classfile/editor/SubclassAdder.java | 59 + .../classfile/editor/SubclassToAdder.java | 60 + .../classfile/editor/VariableCleaner.java | 135 + .../classfile/editor/VariableEditor.java | 129 + .../classfile/editor/VariableRemapper.java | 197 + .../classfile/editor/VariableSizeUpdater.java | 98 + src/proguard/classfile/editor/package.html | 3 + .../instruction/BranchInstruction.java | 180 + .../instruction/ConstantInstruction.java | 303 ++ .../classfile/instruction/Instruction.java | 920 +++++ .../instruction/InstructionConstants.java | 449 +++ .../instruction/InstructionFactory.java | 299 ++ .../instruction/InstructionUtil.java | 67 + .../instruction/LookUpSwitchInstruction.java | 135 + .../instruction/SimpleInstruction.java | 255 ++ .../instruction/SwitchInstruction.java | 83 + .../instruction/TableSwitchInstruction.java | 139 + .../instruction/VariableInstruction.java | 372 ++ .../classfile/instruction/package.html | 9 + .../visitor/AllInstructionVisitor.java | 56 + .../visitor/InstructionCounter.java | 59 + .../visitor/InstructionVisitor.java | 42 + .../visitor/MultiInstructionVisitor.java | 131 + .../instruction/visitor/package.html | 3 + .../classfile/io/LibraryClassReader.java | 362 ++ .../classfile/io/ProgramClassReader.java | 862 +++++ .../classfile/io/ProgramClassWriter.java | 690 ++++ .../classfile/io/RuntimeDataInput.java | 223 ++ .../classfile/io/RuntimeDataOutput.java | 224 ++ src/proguard/classfile/io/package.html | 3 + src/proguard/classfile/package.html | 15 + src/proguard/classfile/util/AccessUtil.java | 105 + .../util/ClassReferenceInitializer.java | 545 +++ .../util/ClassSubHierarchyInitializer.java | 77 + .../util/ClassSuperHierarchyInitializer.java | 168 + src/proguard/classfile/util/ClassUtil.java | 1154 ++++++ .../util/DescriptorClassEnumeration.java | 236 ++ .../DynamicClassReferenceInitializer.java | 478 +++ .../DynamicMemberReferenceInitializer.java | 604 +++ .../util/ExternalTypeEnumeration.java | 106 + .../util/InstructionSequenceMatcher.java | 634 ++++ .../util/InternalTypeEnumeration.java | 204 + src/proguard/classfile/util/MemberFinder.java | 197 + src/proguard/classfile/util/MethodLinker.java | 165 + .../classfile/util/SimplifiedVisitor.java | 810 ++++ .../util/StringReferenceInitializer.java | 89 + src/proguard/classfile/util/StringSharer.java | 155 + .../classfile/util/WarningPrinter.java | 136 + src/proguard/classfile/util/package.html | 3 + .../classfile/visitor/AllClassVisitor.java | 47 + .../classfile/visitor/AllFieldVisitor.java | 55 + .../classfile/visitor/AllMemberVisitor.java | 57 + .../classfile/visitor/AllMethodVisitor.java | 55 + .../classfile/visitor/BottomClassFilter.java | 69 + .../classfile/visitor/ClassAccessFilter.java | 88 + .../classfile/visitor/ClassCleaner.java | 275 ++ .../classfile/visitor/ClassCollector.java | 58 + .../classfile/visitor/ClassCounter.java | 56 + .../visitor/ClassForNameClassVisitor.java | 66 + .../visitor/ClassHierarchyTraveler.java | 91 + .../classfile/visitor/ClassNameFilter.java | 112 + .../classfile/visitor/ClassPoolFiller.java | 55 + .../classfile/visitor/ClassPoolVisitor.java | 37 + .../visitor/ClassPresenceFilter.java | 93 + .../classfile/visitor/ClassPrinter.java | 954 +++++ .../classfile/visitor/ClassVersionFilter.java | 72 + .../classfile/visitor/ClassVersionSetter.java | 83 + .../classfile/visitor/ClassVisitor.java | 36 + .../visitor/ConcreteClassDownTraveler.java | 100 + .../visitor/DotClassClassVisitor.java | 91 + .../classfile/visitor/ExceptClassFilter.java | 69 + .../visitor/ExceptClassesFilter.java | 90 + .../classfile/visitor/ExceptionCounter.java | 52 + .../ExceptionExcludedOffsetFilter.java | 64 + .../ExceptionHandlerConstantVisitor.java | 62 + .../visitor/ExceptionHandlerFilter.java | 70 + .../visitor/ExceptionOffsetFilter.java | 64 + .../visitor/ExceptionRangeFilter.java | 68 + .../ImplementedClassConstantFilter.java | 69 + .../visitor/ImplementedClassFilter.java | 71 + .../ImplementingClassConstantFilter.java | 70 + .../classfile/visitor/LibraryClassFilter.java | 60 + .../visitor/LibraryMemberFilter.java | 73 + .../classfile/visitor/MemberAccessFilter.java | 122 + .../visitor/MemberClassAccessFilter.java | 106 + .../classfile/visitor/MemberCollector.java | 59 + .../classfile/visitor/MemberCounter.java | 72 + .../visitor/MemberDescriptorFilter.java | 113 + .../classfile/visitor/MemberNameFilter.java | 113 + .../visitor/MemberToClassVisitor.java | 90 + .../classfile/visitor/MemberVisitor.java | 40 + .../visitor/MethodImplementationFilter.java | 70 + .../visitor/MethodImplementationTraveler.java | 128 + .../visitor/MultiClassPoolVisitor.java | 88 + .../classfile/visitor/MultiClassVisitor.java | 97 + .../classfile/visitor/MultiMemberVisitor.java | 113 + .../classfile/visitor/NamedClassVisitor.java | 49 + .../classfile/visitor/NamedFieldVisitor.java | 61 + .../classfile/visitor/NamedMethodVisitor.java | 61 + .../classfile/visitor/ProgramClassFilter.java | 60 + .../visitor/ProgramMemberFilter.java | 73 + .../visitor/ReferencedClassVisitor.java | 248 ++ .../visitor/ReferencedMemberVisitor.java | 73 + .../visitor/SimilarMemberVisitor.java | 125 + .../classfile/visitor/SimpleClassPrinter.java | 167 + .../classfile/visitor/SubclassFilter.java | 91 + .../classfile/visitor/SubclassTraveler.java | 60 + .../visitor/VariableClassVisitor.java | 78 + .../visitor/VariableMemberVisitor.java | 96 + src/proguard/classfile/visitor/package.html | 40 + src/proguard/evaluation/BasicBranchUnit.java | 126 + .../evaluation/BasicInvocationUnit.java | 380 ++ src/proguard/evaluation/BranchUnit.java | 63 + src/proguard/evaluation/InvocationUnit.java | 62 + src/proguard/evaluation/Processor.java | 979 +++++ src/proguard/evaluation/Stack.java | 561 +++ src/proguard/evaluation/TracedStack.java | 342 ++ src/proguard/evaluation/TracedVariables.java | 229 ++ src/proguard/evaluation/Variables.java | 348 ++ .../evaluation/value/Category1Value.java | 41 + .../evaluation/value/Category2Value.java | 41 + .../evaluation/value/ComparisonValue.java | 69 + .../value/CompositeDoubleValue.java | 81 + .../evaluation/value/CompositeFloatValue.java | 81 + .../value/CompositeIntegerValue.java | 87 + .../evaluation/value/CompositeLongValue.java | 87 + .../evaluation/value/ConvertedByteValue.java | 64 + .../value/ConvertedCharacterValue.java | 64 + .../value/ConvertedDoubleValue.java | 64 + .../evaluation/value/ConvertedFloatValue.java | 64 + .../value/ConvertedIntegerValue.java | 64 + .../evaluation/value/ConvertedLongValue.java | 64 + .../evaluation/value/ConvertedShortValue.java | 64 + .../evaluation/value/DoubleValue.java | 364 ++ src/proguard/evaluation/value/FloatValue.java | 359 ++ .../value/IdentifiedDoubleValue.java | 67 + .../value/IdentifiedFloatValue.java | 67 + .../value/IdentifiedIntegerValue.java | 67 + .../evaluation/value/IdentifiedLongValue.java | 67 + .../value/IdentifiedReferenceValue.java | 91 + .../value/IdentifiedValueFactory.java | 75 + .../value/InstructionOffsetValue.java | 307 ++ .../evaluation/value/IntegerValue.java | 1002 +++++ src/proguard/evaluation/value/LongValue.java | 554 +++ .../evaluation/value/NegatedDoubleValue.java | 71 + .../evaluation/value/NegatedFloatValue.java | 71 + .../evaluation/value/NegatedIntegerValue.java | 71 + .../evaluation/value/NegatedLongValue.java | 71 + .../value/ParticularDoubleValue.java | 210 ++ .../value/ParticularFloatValue.java | 210 ++ .../value/ParticularIntegerValue.java | 383 ++ .../evaluation/value/ParticularLongValue.java | 271 ++ .../evaluation/value/ReferenceValue.java | 526 +++ .../evaluation/value/SpecificDoubleValue.java | 183 + .../evaluation/value/SpecificFloatValue.java | 183 + .../value/SpecificIntegerValue.java | 354 ++ .../evaluation/value/SpecificLongValue.java | 259 ++ .../value/SpecificValueFactory.java | 89 + src/proguard/evaluation/value/TopValue.java | 79 + .../evaluation/value/UnknownDoubleValue.java | 125 + .../evaluation/value/UnknownFloatValue.java | 125 + .../evaluation/value/UnknownIntegerValue.java | 216 ++ .../evaluation/value/UnknownLongValue.java | 160 + src/proguard/evaluation/value/Value.java | 169 + .../evaluation/value/ValueFactory.java | 193 + src/proguard/evaluation/value/package.html | 3 + src/proguard/gui/ClassPathPanel.java | 441 +++ .../gui/ClassSpecificationDialog.java | 542 +++ .../gui/ClassSpecificationsPanel.java | 231 ++ src/proguard/gui/ExtensionFileFilter.java | 78 + src/proguard/gui/FilterBuilder.java | 208 + src/proguard/gui/FilterDialog.java | 320 ++ src/proguard/gui/GUIResources.java | 56 + src/proguard/gui/GUIResources.properties | 631 ++++ src/proguard/gui/KeepSpecificationsPanel.java | 81 + src/proguard/gui/ListPanel.java | 341 ++ src/proguard/gui/MANIFEST.MF | 3 + .../gui/MemberSpecificationDialog.java | 497 +++ .../gui/MemberSpecificationsPanel.java | 304 ++ src/proguard/gui/MessageDialogRunnable.java | 90 + src/proguard/gui/OptimizationsDialog.java | 251 ++ src/proguard/gui/ProGuardGUI.java | 1738 +++++++++ src/proguard/gui/ProGuardRunnable.java | 154 + src/proguard/gui/ReTraceRunnable.java | 149 + src/proguard/gui/SwingUtil.java | 82 + src/proguard/gui/TabbedPane.java | 229 ++ src/proguard/gui/TextAreaOutputStream.java | 81 + src/proguard/gui/arrow.gif | Bin 0 -> 112 bytes src/proguard/gui/boilerplate.pro | 410 ++ src/proguard/gui/default.pro | 318 ++ src/proguard/gui/package.html | 3 + src/proguard/gui/splash/BufferedSprite.java | 145 + src/proguard/gui/splash/CircleSprite.java | 74 + src/proguard/gui/splash/ClipSprite.java | 85 + src/proguard/gui/splash/ColorSprite.java | 65 + src/proguard/gui/splash/CompositeSprite.java | 56 + src/proguard/gui/splash/ConstantColor.java | 51 + src/proguard/gui/splash/ConstantDouble.java | 49 + src/proguard/gui/splash/ConstantFont.java | 46 + src/proguard/gui/splash/ConstantInt.java | 49 + src/proguard/gui/splash/ConstantString.java | 49 + src/proguard/gui/splash/ConstantTiming.java | 57 + src/proguard/gui/splash/FontSprite.java | 65 + src/proguard/gui/splash/ImageSprite.java | 76 + src/proguard/gui/splash/LinearColor.java | 72 + src/proguard/gui/splash/LinearDouble.java | 55 + src/proguard/gui/splash/LinearInt.java | 55 + src/proguard/gui/splash/LinearTiming.java | 55 + .../gui/splash/OverrideGraphics2D.java | 598 +++ src/proguard/gui/splash/RectangleSprite.java | 114 + src/proguard/gui/splash/SawToothTiming.java | 53 + src/proguard/gui/splash/ShadowedSprite.java | 109 + src/proguard/gui/splash/SineTiming.java | 53 + src/proguard/gui/splash/SmoothTiming.java | 66 + src/proguard/gui/splash/SplashPanel.java | 235 ++ src/proguard/gui/splash/Sprite.java | 41 + src/proguard/gui/splash/TextSprite.java | 89 + src/proguard/gui/splash/TimeSwitchSprite.java | 75 + src/proguard/gui/splash/Timing.java | 34 + src/proguard/gui/splash/TypeWriterString.java | 71 + src/proguard/gui/splash/VariableColor.java | 36 + src/proguard/gui/splash/VariableDouble.java | 34 + src/proguard/gui/splash/VariableFont.java | 36 + src/proguard/gui/splash/VariableInt.java | 34 + src/proguard/gui/splash/VariableSizeFont.java | 65 + src/proguard/gui/splash/VariableString.java | 34 + src/proguard/gui/splash/package.html | 4 + src/proguard/gui/vtitle.png | Bin 0 -> 23313 bytes src/proguard/io/CascadingDataEntryWriter.java | 94 + src/proguard/io/ClassFilter.java | 59 + src/proguard/io/ClassReader.java | 115 + src/proguard/io/ClassRewriter.java | 80 + src/proguard/io/DataEntry.java | 62 + src/proguard/io/DataEntryCopier.java | 247 ++ src/proguard/io/DataEntryDirectoryFilter.java | 40 + src/proguard/io/DataEntryFilter.java | 38 + src/proguard/io/DataEntryNameFilter.java | 54 + src/proguard/io/DataEntryObfuscator.java | 131 + src/proguard/io/DataEntryParentFilter.java | 51 + src/proguard/io/DataEntryPump.java | 43 + src/proguard/io/DataEntryReader.java | 38 + src/proguard/io/DataEntryRenamer.java | 104 + src/proguard/io/DataEntryRewriter.java | 148 + src/proguard/io/DataEntryWriter.java | 73 + src/proguard/io/DirectoryFilter.java | 58 + src/proguard/io/DirectoryPump.java | 78 + src/proguard/io/DirectoryWriter.java | 165 + src/proguard/io/FileDataEntry.java | 96 + src/proguard/io/FilteredDataEntryReader.java | 90 + src/proguard/io/FilteredDataEntryWriter.java | 125 + src/proguard/io/Finisher.java | 37 + src/proguard/io/JarReader.java | 75 + src/proguard/io/JarWriter.java | 235 ++ src/proguard/io/ManifestRewriter.java | 216 ++ src/proguard/io/NameFilter.java | 83 + src/proguard/io/ParentDataEntryWriter.java | 75 + src/proguard/io/RenamedDataEntry.java | 83 + src/proguard/io/ZipDataEntry.java | 98 + src/proguard/io/package.html | 4 + src/proguard/obfuscate/AttributeShrinker.java | 121 + .../obfuscate/AttributeUsageMarker.java | 71 + src/proguard/obfuscate/ClassObfuscator.java | 521 +++ src/proguard/obfuscate/ClassRenamer.java | 109 + .../obfuscate/DictionaryNameFactory.java | 189 + src/proguard/obfuscate/MapCleaner.java | 57 + src/proguard/obfuscate/MappingKeeper.java | 177 + src/proguard/obfuscate/MappingPrinter.java | 147 + src/proguard/obfuscate/MappingProcessor.java | 79 + src/proguard/obfuscate/MappingReader.java | 199 + src/proguard/obfuscate/MemberNameCleaner.java | 60 + .../obfuscate/MemberNameCollector.java | 106 + .../obfuscate/MemberNameConflictFixer.java | 159 + src/proguard/obfuscate/MemberObfuscator.java | 230 ++ .../obfuscate/MemberSpecialNameFilter.java | 101 + .../obfuscate/MultiMappingProcessor.java | 96 + .../obfuscate/NameAndTypeShrinker.java | 112 + .../obfuscate/NameAndTypeUsageMarker.java | 135 + src/proguard/obfuscate/NameFactory.java | 34 + .../obfuscate/NameFactoryResetter.java | 59 + src/proguard/obfuscate/NameMarker.java | 166 + .../obfuscate/NumericNameFactory.java | 49 + src/proguard/obfuscate/Obfuscator.java | 429 +++ src/proguard/obfuscate/SimpleNameFactory.java | 156 + src/proguard/obfuscate/SourceFileRenamer.java | 84 + .../obfuscate/SpecialNameFactory.java | 83 + src/proguard/obfuscate/Utf8Shrinker.java | 110 + src/proguard/obfuscate/Utf8UsageMarker.java | 392 ++ src/proguard/obfuscate/package.html | 3 + src/proguard/optimize/ChangedCodePrinter.java | 291 ++ .../optimize/ConstantMemberFilter.java | 77 + .../optimize/ConstantParameterFilter.java | 79 + .../optimize/DuplicateInitializerFixer.java | 207 + .../DuplicateInitializerInvocationFixer.java | 150 + src/proguard/optimize/KeepMarker.java | 95 + .../optimize/MemberDescriptorSpecializer.java | 138 + .../optimize/MethodDescriptorShrinker.java | 319 ++ src/proguard/optimize/MethodStaticizer.java | 87 + .../OptimizationInfoMemberFilter.java | 94 + src/proguard/optimize/Optimizer.java | 876 +++++ src/proguard/optimize/ParameterShrinker.java | 146 + .../optimize/TailRecursionSimplifier.java | 331 ++ .../optimize/WriteOnlyFieldFilter.java | 65 + .../evaluation/EvaluationShrinker.java | 1912 ++++++++++ .../evaluation/EvaluationSimplifier.java | 968 +++++ .../optimize/evaluation/LivenessAnalyzer.java | 516 +++ .../evaluation/LoadingInvocationUnit.java | 203 + .../optimize/evaluation/PartialEvaluator.java | 1269 +++++++ .../evaluation/StoringInvocationUnit.java | 207 + .../optimize/evaluation/TracedBranchUnit.java | 59 + .../evaluation/VariableOptimizer.java | 244 ++ src/proguard/optimize/evaluation/package.html | 4 + .../optimize/info/AccessMethodMarker.java | 187 + .../optimize/info/BackwardBranchMarker.java | 90 + .../optimize/info/CatchExceptionMarker.java | 69 + .../optimize/info/CaughtClassFilter.java | 63 + .../optimize/info/CaughtClassMarker.java | 63 + .../optimize/info/ClassOptimizationInfo.java | 151 + .../info/ClassOptimizationInfoSetter.java | 47 + .../optimize/info/DotClassFilter.java | 63 + .../optimize/info/DotClassMarker.java | 96 + .../info/ExceptionInstructionChecker.java | 187 + .../optimize/info/FieldOptimizationInfo.java | 162 + .../optimize/info/InstanceofClassFilter.java | 63 + .../optimize/info/InstanceofClassMarker.java | 93 + .../info/InstantiationClassFilter.java | 62 + .../info/InstantiationClassMarker.java | 93 + .../info/MemberOptimizationInfoSetter.java | 59 + .../optimize/info/MethodInvocationMarker.java | 107 + .../optimize/info/MethodOptimizationInfo.java | 302 ++ .../info/NoSideEffectMethodMarker.java | 91 + .../optimize/info/NonPrivateMemberMarker.java | 177 + ...ageVisibleMemberContainingClassMarker.java | 67 + ...ckageVisibleMemberInvokingClassMarker.java | 81 + .../optimize/info/ParameterUsageMarker.java | 285 ++ .../optimize/info/ReadWriteFieldMarker.java | 163 + .../info/SideEffectInstructionChecker.java | 224 ++ .../optimize/info/SideEffectMethodMarker.java | 175 + .../optimize/info/SuperInvocationMarker.java | 93 + .../optimize/info/VariableUsageMarker.java | 95 + src/proguard/optimize/info/package.html | 4 + src/proguard/optimize/package.html | 4 + .../optimize/peephole/BranchTargetFinder.java | 691 ++++ .../optimize/peephole/ClassFinalizer.java | 84 + .../optimize/peephole/ClassMerger.java | 541 +++ .../peephole/GotoCommonCodeReplacer.java | 266 ++ .../optimize/peephole/GotoGotoReplacer.java | 114 + .../optimize/peephole/GotoReturnReplacer.java | 115 + .../peephole/HorizontalClassMerger.java | 90 + .../InstructionSequenceConstants.java | 3351 +++++++++++++++++ .../peephole/InstructionSequenceReplacer.java | 278 ++ .../InstructionSequencesReplacer.java | 138 + .../optimize/peephole/MemberPrivatizer.java | 103 + .../optimize/peephole/MethodFinalizer.java | 93 + .../optimize/peephole/MethodInliner.java | 567 +++ .../optimize/peephole/NopRemover.java | 89 + .../optimize/peephole/PeepholeOptimizer.java | 103 + .../peephole/ReachableCodeMarker.java | 263 ++ .../RetargetedInnerClassAttributeRemover.java | 140 + .../optimize/peephole/TargetClassChanger.java | 439 +++ .../peephole/UnreachableCodeRemover.java | 143 + .../peephole/UnreachableExceptionRemover.java | 163 + .../optimize/peephole/VariableShrinker.java | 129 + .../peephole/VerticalClassMerger.java | 88 + src/proguard/optimize/peephole/package.html | 3 + src/proguard/package.html | 5 + src/proguard/preverify/CodePreverifier.java | 611 +++ .../preverify/CodeSubroutineInliner.java | 405 ++ src/proguard/preverify/Preverifier.java | 74 + src/proguard/preverify/SubroutineInliner.java | 74 + src/proguard/retrace/MANIFEST.MF | 3 + src/proguard/retrace/ReTrace.java | 749 ++++ src/proguard/retrace/package.html | 4 + .../shrink/AnnotationUsageMarker.java | 359 ++ src/proguard/shrink/ClassShrinker.java | 448 +++ src/proguard/shrink/InnerUsageMarker.java | 174 + src/proguard/shrink/InterfaceUsageMarker.java | 152 + src/proguard/shrink/ShortestUsageMark.java | 183 + src/proguard/shrink/ShortestUsageMarker.java | 277 ++ src/proguard/shrink/ShortestUsagePrinter.java | 210 ++ src/proguard/shrink/Shrinker.java | 170 + src/proguard/shrink/UsageMarker.java | 920 +++++ src/proguard/shrink/UsagePrinter.java | 177 + src/proguard/shrink/UsedClassFilter.java | 74 + src/proguard/shrink/UsedMemberFilter.java | 93 + src/proguard/shrink/package.html | 3 + src/proguard/util/AndMatcher.java | 49 + src/proguard/util/ClassNameParser.java | 216 ++ src/proguard/util/ConstantMatcher.java | 48 + src/proguard/util/EmptyStringMatcher.java | 36 + src/proguard/util/ExtensionMatcher.java | 63 + src/proguard/util/FileNameParser.java | 121 + src/proguard/util/FixedStringMatcher.java | 56 + src/proguard/util/ListMatcher.java | 69 + src/proguard/util/ListParser.java | 137 + src/proguard/util/ListUtil.java | 173 + src/proguard/util/NameParser.java | 106 + src/proguard/util/NotMatcher.java | 46 + src/proguard/util/OrMatcher.java | 49 + src/proguard/util/SettableMatcher.java | 46 + src/proguard/util/StringMatcher.java | 38 + src/proguard/util/StringParser.java | 35 + src/proguard/util/VariableStringMatcher.java | 126 + src/proguard/util/package.html | 3 + src/proguard/wtk/ProGuardObfuscator.java | 141 + src/proguard/wtk/default.pro | 114 + src/proguard/wtk/package.html | 3 + 703 files changed, 113006 insertions(+) create mode 100644 README create mode 100644 bin/proguard.bat create mode 100755 bin/proguard.sh create mode 100644 bin/proguardgui.bat create mode 100755 bin/proguardgui.sh create mode 100644 bin/retrace.bat create mode 100755 bin/retrace.sh create mode 100755 build/build.sh create mode 100644 build/build.xml create mode 100644 build/makefile create mode 100644 docs/FAQ.html create mode 100644 docs/GPL.html create mode 100644 docs/GPL_exception.html create mode 100644 docs/acknowledgements.html create mode 100644 docs/alternatives.html create mode 100644 docs/checkmark.gif create mode 100644 docs/downloads.html create mode 100644 docs/drop1.gif create mode 100644 docs/drop2.gif create mode 100644 docs/drop3.gif create mode 100644 docs/favicon.ico create mode 100644 docs/feedback.html create mode 100644 docs/index.html create mode 100644 docs/license.html create mode 100644 docs/luciadlogo.png create mode 100644 docs/main.html create mode 100644 docs/manual/ant.html create mode 100644 docs/manual/attention.gif create mode 100644 docs/manual/examples.html create mode 100644 docs/manual/gui.html create mode 100644 docs/manual/index.html create mode 100644 docs/manual/introduction.html create mode 100644 docs/manual/limitations.html create mode 100644 docs/manual/optimizations.html create mode 100644 docs/manual/refcard.html create mode 100644 docs/manual/retrace/examples.html create mode 100644 docs/manual/retrace/index.html create mode 100644 docs/manual/retrace/introduction.html create mode 100644 docs/manual/retrace/usage.html create mode 100644 docs/manual/sections.html create mode 100644 docs/manual/style.css create mode 100644 docs/manual/troubleshooting.html create mode 100644 docs/manual/usage.html create mode 100644 docs/manual/wtk.html create mode 100644 docs/quality.html create mode 100644 docs/results.html create mode 100644 docs/sanawarelogo.png create mode 100644 docs/screenshot_console.gif create mode 100644 docs/screenshot_console_small.gif create mode 100644 docs/screenshot_gui1.gif create mode 100644 docs/screenshot_gui2.gif create mode 100644 docs/screenshot_gui3.gif create mode 100644 docs/screenshot_gui4.gif create mode 100644 docs/screenshot_gui5.gif create mode 100644 docs/screenshot_gui6.gif create mode 100644 docs/screenshot_gui7.gif create mode 100644 docs/screenshot_gui8.gif create mode 100644 docs/screenshots.html create mode 100644 docs/screenshots_gui_small.gif create mode 100644 docs/sections.html create mode 100644 docs/sflogo.png create mode 100644 docs/steel.gif create mode 100644 docs/style.css create mode 100644 docs/testimonials.html create mode 100644 docs/title.gif create mode 100644 docs/title.html create mode 100644 examples/annotations/examples.pro create mode 100644 examples/annotations/examples/Applet.java create mode 100644 examples/annotations/examples/Application.java create mode 100644 examples/annotations/examples/Bean.java create mode 100644 examples/annotations/examples/NativeCallBack.java create mode 100644 examples/annotations/lib/annotations.jar create mode 100644 examples/annotations/lib/annotations.pro create mode 100644 examples/annotations/src/proguard/annotation/Keep.java create mode 100644 examples/annotations/src/proguard/annotation/KeepApplication.java create mode 100644 examples/annotations/src/proguard/annotation/KeepClassMemberNames.java create mode 100644 examples/annotations/src/proguard/annotation/KeepClassMembers.java create mode 100644 examples/annotations/src/proguard/annotation/KeepGettersSetters.java create mode 100644 examples/annotations/src/proguard/annotation/KeepImplementations.java create mode 100644 examples/annotations/src/proguard/annotation/KeepName.java create mode 100644 examples/annotations/src/proguard/annotation/KeepPublicClassMemberNames.java create mode 100644 examples/annotations/src/proguard/annotation/KeepPublicClassMembers.java create mode 100644 examples/annotations/src/proguard/annotation/KeepPublicGettersSetters.java create mode 100644 examples/annotations/src/proguard/annotation/KeepPublicImplementations.java create mode 100644 examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMemberNames.java create mode 100644 examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMembers.java create mode 100644 examples/ant/applets.xml create mode 100644 examples/ant/applications1.xml create mode 100644 examples/ant/applications2.xml create mode 100644 examples/ant/applications3.xml create mode 100644 examples/ant/library.xml create mode 100644 examples/ant/midlets.xml create mode 100644 examples/ant/proguard.xml create mode 100644 examples/ant/servlets.xml create mode 100644 examples/applets.pro create mode 100644 examples/applications.pro create mode 100644 examples/dictionaries/compact.txt create mode 100644 examples/dictionaries/keywords.txt create mode 100755 examples/dictionaries/shakespeare.txt create mode 100644 examples/dictionaries/windows.txt create mode 100644 examples/library.pro create mode 100644 examples/midlets.pro create mode 100644 examples/proguard.pro create mode 100644 examples/proguardall.pro create mode 100644 examples/proguardgui.pro create mode 100644 examples/retrace.pro create mode 100644 examples/servlets.pro create mode 100644 lib/proguard.jar create mode 100644 lib/proguardgui.jar create mode 100644 lib/retrace.jar create mode 100644 src/proguard/ArgumentWordReader.java create mode 100644 src/proguard/ClassPath.java create mode 100644 src/proguard/ClassPathEntry.java create mode 100644 src/proguard/ClassSpecification.java create mode 100644 src/proguard/ClassSpecificationVisitorFactory.java create mode 100644 src/proguard/Configuration.java create mode 100644 src/proguard/ConfigurationConstants.java create mode 100644 src/proguard/ConfigurationParser.java create mode 100644 src/proguard/ConfigurationWriter.java create mode 100644 src/proguard/DataEntryReaderFactory.java create mode 100644 src/proguard/DataEntryWriterFactory.java create mode 100644 src/proguard/DescriptorKeepChecker.java create mode 100644 src/proguard/DuplicateClassPrinter.java create mode 100644 src/proguard/FileWordReader.java create mode 100644 src/proguard/FullyQualifiedClassNameChecker.java create mode 100644 src/proguard/GPL.java create mode 100644 src/proguard/Initializer.java create mode 100644 src/proguard/InputReader.java create mode 100644 src/proguard/KeepClassSpecification.java create mode 100644 src/proguard/MANIFEST.MF create mode 100644 src/proguard/MemberSpecification.java create mode 100644 src/proguard/OutputWriter.java create mode 100644 src/proguard/ParseException.java create mode 100644 src/proguard/ProGuard.java create mode 100644 src/proguard/SubclassedClassFilter.java create mode 100644 src/proguard/Targeter.java create mode 100644 src/proguard/UpToDateChecker.java create mode 100644 src/proguard/WordReader.java create mode 100644 src/proguard/ant/ClassPathElement.java create mode 100644 src/proguard/ant/ClassSpecificationElement.java create mode 100644 src/proguard/ant/ConfigurationElement.java create mode 100644 src/proguard/ant/ConfigurationTask.java create mode 100644 src/proguard/ant/FilterElement.java create mode 100644 src/proguard/ant/KeepSpecificationElement.java create mode 100644 src/proguard/ant/MemberSpecificationElement.java create mode 100644 src/proguard/ant/ProGuardTask.java create mode 100644 src/proguard/ant/package.html create mode 100644 src/proguard/ant/task.properties create mode 100644 src/proguard/classfile/ClassConstants.java create mode 100644 src/proguard/classfile/ClassPool.java create mode 100644 src/proguard/classfile/Clazz.java create mode 100644 src/proguard/classfile/Field.java create mode 100644 src/proguard/classfile/LibraryClass.java create mode 100644 src/proguard/classfile/LibraryField.java create mode 100644 src/proguard/classfile/LibraryMember.java create mode 100644 src/proguard/classfile/LibraryMethod.java create mode 100644 src/proguard/classfile/Member.java create mode 100644 src/proguard/classfile/Method.java create mode 100644 src/proguard/classfile/ProgramClass.java create mode 100644 src/proguard/classfile/ProgramField.java create mode 100644 src/proguard/classfile/ProgramMember.java create mode 100644 src/proguard/classfile/ProgramMethod.java create mode 100644 src/proguard/classfile/VisitorAccepter.java create mode 100644 src/proguard/classfile/attribute/Attribute.java create mode 100644 src/proguard/classfile/attribute/CodeAttribute.java create mode 100644 src/proguard/classfile/attribute/ConstantValueAttribute.java create mode 100644 src/proguard/classfile/attribute/DeprecatedAttribute.java create mode 100644 src/proguard/classfile/attribute/EnclosingMethodAttribute.java create mode 100644 src/proguard/classfile/attribute/ExceptionInfo.java create mode 100644 src/proguard/classfile/attribute/ExceptionsAttribute.java create mode 100644 src/proguard/classfile/attribute/InnerClassesAttribute.java create mode 100644 src/proguard/classfile/attribute/InnerClassesInfo.java create mode 100644 src/proguard/classfile/attribute/LineNumberInfo.java create mode 100644 src/proguard/classfile/attribute/LineNumberTableAttribute.java create mode 100644 src/proguard/classfile/attribute/LocalVariableInfo.java create mode 100644 src/proguard/classfile/attribute/LocalVariableTableAttribute.java create mode 100644 src/proguard/classfile/attribute/LocalVariableTypeInfo.java create mode 100644 src/proguard/classfile/attribute/LocalVariableTypeTableAttribute.java create mode 100644 src/proguard/classfile/attribute/SignatureAttribute.java create mode 100644 src/proguard/classfile/attribute/SourceDirAttribute.java create mode 100644 src/proguard/classfile/attribute/SourceFileAttribute.java create mode 100644 src/proguard/classfile/attribute/SyntheticAttribute.java create mode 100644 src/proguard/classfile/attribute/UnknownAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/Annotation.java create mode 100644 src/proguard/classfile/attribute/annotation/AnnotationDefaultAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/AnnotationElementValue.java create mode 100644 src/proguard/classfile/attribute/annotation/AnnotationsAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/ArrayElementValue.java create mode 100644 src/proguard/classfile/attribute/annotation/ClassElementValue.java create mode 100644 src/proguard/classfile/attribute/annotation/ConstantElementValue.java create mode 100644 src/proguard/classfile/attribute/annotation/ElementValue.java create mode 100644 src/proguard/classfile/attribute/annotation/EnumConstantElementValue.java create mode 100644 src/proguard/classfile/attribute/annotation/ParameterAnnotationsAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/RuntimeInvisibleAnnotationsAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/RuntimeInvisibleParameterAnnotationsAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/RuntimeVisibleAnnotationsAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/RuntimeVisibleParameterAnnotationsAttribute.java create mode 100644 src/proguard/classfile/attribute/annotation/package.html create mode 100644 src/proguard/classfile/attribute/annotation/visitor/AllAnnotationVisitor.java create mode 100644 src/proguard/classfile/attribute/annotation/visitor/AnnotatedClassVisitor.java create mode 100644 src/proguard/classfile/attribute/annotation/visitor/AnnotationToMemberVisitor.java create mode 100644 src/proguard/classfile/attribute/annotation/visitor/AnnotationTypeFilter.java create mode 100644 src/proguard/classfile/attribute/annotation/visitor/AnnotationVisitor.java create mode 100644 src/proguard/classfile/attribute/annotation/visitor/ElementValueVisitor.java create mode 100644 src/proguard/classfile/attribute/annotation/visitor/package.html create mode 100644 src/proguard/classfile/attribute/package.html create mode 100644 src/proguard/classfile/attribute/preverification/DoubleType.java create mode 100644 src/proguard/classfile/attribute/preverification/FloatType.java create mode 100644 src/proguard/classfile/attribute/preverification/FullFrame.java create mode 100644 src/proguard/classfile/attribute/preverification/IntegerType.java create mode 100644 src/proguard/classfile/attribute/preverification/LessZeroFrame.java create mode 100644 src/proguard/classfile/attribute/preverification/LongType.java create mode 100644 src/proguard/classfile/attribute/preverification/MoreZeroFrame.java create mode 100644 src/proguard/classfile/attribute/preverification/NullType.java create mode 100644 src/proguard/classfile/attribute/preverification/ObjectType.java create mode 100644 src/proguard/classfile/attribute/preverification/SameOneFrame.java create mode 100644 src/proguard/classfile/attribute/preverification/SameZeroFrame.java create mode 100644 src/proguard/classfile/attribute/preverification/StackMapAttribute.java create mode 100644 src/proguard/classfile/attribute/preverification/StackMapFrame.java create mode 100644 src/proguard/classfile/attribute/preverification/StackMapTableAttribute.java create mode 100644 src/proguard/classfile/attribute/preverification/TopType.java create mode 100644 src/proguard/classfile/attribute/preverification/UninitializedThisType.java create mode 100644 src/proguard/classfile/attribute/preverification/UninitializedType.java create mode 100644 src/proguard/classfile/attribute/preverification/VerificationType.java create mode 100644 src/proguard/classfile/attribute/preverification/VerificationTypeFactory.java create mode 100644 src/proguard/classfile/attribute/preverification/visitor/StackMapFrameVisitor.java create mode 100644 src/proguard/classfile/attribute/preverification/visitor/VerificationTypeVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/AllAttributeVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/AllExceptionInfoVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/AttributeNameFilter.java create mode 100644 src/proguard/classfile/attribute/visitor/AttributeVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/ExceptionInfoVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/InnerClassesInfoVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/LineNumberInfoVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/LocalVariableInfoVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/LocalVariableTypeInfoVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/MultiAttributeVisitor.java create mode 100644 src/proguard/classfile/attribute/visitor/RequiredAttributeFilter.java create mode 100644 src/proguard/classfile/attribute/visitor/StackSizeComputer.java create mode 100644 src/proguard/classfile/attribute/visitor/package.html create mode 100644 src/proguard/classfile/constant/ClassConstant.java create mode 100644 src/proguard/classfile/constant/Constant.java create mode 100644 src/proguard/classfile/constant/DoubleConstant.java create mode 100644 src/proguard/classfile/constant/FieldrefConstant.java create mode 100644 src/proguard/classfile/constant/FloatConstant.java create mode 100644 src/proguard/classfile/constant/IntegerConstant.java create mode 100644 src/proguard/classfile/constant/InterfaceMethodrefConstant.java create mode 100644 src/proguard/classfile/constant/LongConstant.java create mode 100644 src/proguard/classfile/constant/MethodrefConstant.java create mode 100644 src/proguard/classfile/constant/NameAndTypeConstant.java create mode 100644 src/proguard/classfile/constant/RefConstant.java create mode 100644 src/proguard/classfile/constant/StringConstant.java create mode 100644 src/proguard/classfile/constant/Utf8Constant.java create mode 100644 src/proguard/classfile/constant/visitor/AllConstantVisitor.java create mode 100644 src/proguard/classfile/constant/visitor/ConstantVisitor.java create mode 100644 src/proguard/classfile/constant/visitor/ExceptClassConstantFilter.java create mode 100644 src/proguard/classfile/constant/visitor/package.html create mode 100644 src/proguard/classfile/editor/AccessFixer.java create mode 100644 src/proguard/classfile/editor/AnnotationAdder.java create mode 100644 src/proguard/classfile/editor/AnnotationsAttributeEditor.java create mode 100644 src/proguard/classfile/editor/AttributeAdder.java create mode 100644 src/proguard/classfile/editor/AttributeSorter.java create mode 100644 src/proguard/classfile/editor/AttributesEditor.java create mode 100644 src/proguard/classfile/editor/ClassEditor.java create mode 100644 src/proguard/classfile/editor/ClassElementSorter.java create mode 100644 src/proguard/classfile/editor/ClassMemberSorter.java create mode 100644 src/proguard/classfile/editor/ClassReferenceFixer.java create mode 100644 src/proguard/classfile/editor/CodeAttributeComposer.java create mode 100644 src/proguard/classfile/editor/CodeAttributeEditor.java create mode 100644 src/proguard/classfile/editor/CodeAttributeEditorResetter.java create mode 100644 src/proguard/classfile/editor/ComparableConstant.java create mode 100644 src/proguard/classfile/editor/ConstantAdder.java create mode 100644 src/proguard/classfile/editor/ConstantPoolEditor.java create mode 100644 src/proguard/classfile/editor/ConstantPoolRemapper.java create mode 100644 src/proguard/classfile/editor/ConstantPoolSorter.java create mode 100644 src/proguard/classfile/editor/ElementValueAdder.java create mode 100644 src/proguard/classfile/editor/ElementValuesEditor.java create mode 100644 src/proguard/classfile/editor/ExceptionAdder.java create mode 100644 src/proguard/classfile/editor/ExceptionInfoAdder.java create mode 100644 src/proguard/classfile/editor/ExceptionsAttributeEditor.java create mode 100644 src/proguard/classfile/editor/InstructionAdder.java create mode 100644 src/proguard/classfile/editor/InstructionWriter.java create mode 100644 src/proguard/classfile/editor/InterfaceAdder.java create mode 100644 src/proguard/classfile/editor/InterfaceSorter.java create mode 100644 src/proguard/classfile/editor/InterfacesEditor.java create mode 100644 src/proguard/classfile/editor/LineNumberInfoAdder.java create mode 100644 src/proguard/classfile/editor/LineNumberTableAttributeEditor.java create mode 100644 src/proguard/classfile/editor/LocalVariableInfoAdder.java create mode 100644 src/proguard/classfile/editor/LocalVariableTableAttributeEditor.java create mode 100644 src/proguard/classfile/editor/LocalVariableTypeInfoAdder.java create mode 100644 src/proguard/classfile/editor/LocalVariableTypeTableAttributeEditor.java create mode 100644 src/proguard/classfile/editor/MemberAdder.java create mode 100644 src/proguard/classfile/editor/MemberReferenceFixer.java create mode 100644 src/proguard/classfile/editor/MethodInvocationFixer.java create mode 100644 src/proguard/classfile/editor/NamedAttributeDeleter.java create mode 100644 src/proguard/classfile/editor/ParameterAnnotationsAttributeEditor.java create mode 100644 src/proguard/classfile/editor/StackSizeUpdater.java create mode 100644 src/proguard/classfile/editor/SubclassAdder.java create mode 100644 src/proguard/classfile/editor/SubclassToAdder.java create mode 100644 src/proguard/classfile/editor/VariableCleaner.java create mode 100644 src/proguard/classfile/editor/VariableEditor.java create mode 100644 src/proguard/classfile/editor/VariableRemapper.java create mode 100644 src/proguard/classfile/editor/VariableSizeUpdater.java create mode 100644 src/proguard/classfile/editor/package.html create mode 100644 src/proguard/classfile/instruction/BranchInstruction.java create mode 100644 src/proguard/classfile/instruction/ConstantInstruction.java create mode 100644 src/proguard/classfile/instruction/Instruction.java create mode 100644 src/proguard/classfile/instruction/InstructionConstants.java create mode 100644 src/proguard/classfile/instruction/InstructionFactory.java create mode 100644 src/proguard/classfile/instruction/InstructionUtil.java create mode 100644 src/proguard/classfile/instruction/LookUpSwitchInstruction.java create mode 100644 src/proguard/classfile/instruction/SimpleInstruction.java create mode 100644 src/proguard/classfile/instruction/SwitchInstruction.java create mode 100644 src/proguard/classfile/instruction/TableSwitchInstruction.java create mode 100644 src/proguard/classfile/instruction/VariableInstruction.java create mode 100644 src/proguard/classfile/instruction/package.html create mode 100644 src/proguard/classfile/instruction/visitor/AllInstructionVisitor.java create mode 100644 src/proguard/classfile/instruction/visitor/InstructionCounter.java create mode 100644 src/proguard/classfile/instruction/visitor/InstructionVisitor.java create mode 100644 src/proguard/classfile/instruction/visitor/MultiInstructionVisitor.java create mode 100644 src/proguard/classfile/instruction/visitor/package.html create mode 100644 src/proguard/classfile/io/LibraryClassReader.java create mode 100644 src/proguard/classfile/io/ProgramClassReader.java create mode 100644 src/proguard/classfile/io/ProgramClassWriter.java create mode 100644 src/proguard/classfile/io/RuntimeDataInput.java create mode 100644 src/proguard/classfile/io/RuntimeDataOutput.java create mode 100644 src/proguard/classfile/io/package.html create mode 100644 src/proguard/classfile/package.html create mode 100644 src/proguard/classfile/util/AccessUtil.java create mode 100644 src/proguard/classfile/util/ClassReferenceInitializer.java create mode 100644 src/proguard/classfile/util/ClassSubHierarchyInitializer.java create mode 100644 src/proguard/classfile/util/ClassSuperHierarchyInitializer.java create mode 100644 src/proguard/classfile/util/ClassUtil.java create mode 100644 src/proguard/classfile/util/DescriptorClassEnumeration.java create mode 100644 src/proguard/classfile/util/DynamicClassReferenceInitializer.java create mode 100644 src/proguard/classfile/util/DynamicMemberReferenceInitializer.java create mode 100644 src/proguard/classfile/util/ExternalTypeEnumeration.java create mode 100644 src/proguard/classfile/util/InstructionSequenceMatcher.java create mode 100644 src/proguard/classfile/util/InternalTypeEnumeration.java create mode 100644 src/proguard/classfile/util/MemberFinder.java create mode 100644 src/proguard/classfile/util/MethodLinker.java create mode 100644 src/proguard/classfile/util/SimplifiedVisitor.java create mode 100644 src/proguard/classfile/util/StringReferenceInitializer.java create mode 100644 src/proguard/classfile/util/StringSharer.java create mode 100644 src/proguard/classfile/util/WarningPrinter.java create mode 100644 src/proguard/classfile/util/package.html create mode 100644 src/proguard/classfile/visitor/AllClassVisitor.java create mode 100644 src/proguard/classfile/visitor/AllFieldVisitor.java create mode 100644 src/proguard/classfile/visitor/AllMemberVisitor.java create mode 100644 src/proguard/classfile/visitor/AllMethodVisitor.java create mode 100644 src/proguard/classfile/visitor/BottomClassFilter.java create mode 100644 src/proguard/classfile/visitor/ClassAccessFilter.java create mode 100644 src/proguard/classfile/visitor/ClassCleaner.java create mode 100644 src/proguard/classfile/visitor/ClassCollector.java create mode 100644 src/proguard/classfile/visitor/ClassCounter.java create mode 100644 src/proguard/classfile/visitor/ClassForNameClassVisitor.java create mode 100644 src/proguard/classfile/visitor/ClassHierarchyTraveler.java create mode 100644 src/proguard/classfile/visitor/ClassNameFilter.java create mode 100644 src/proguard/classfile/visitor/ClassPoolFiller.java create mode 100644 src/proguard/classfile/visitor/ClassPoolVisitor.java create mode 100644 src/proguard/classfile/visitor/ClassPresenceFilter.java create mode 100644 src/proguard/classfile/visitor/ClassPrinter.java create mode 100644 src/proguard/classfile/visitor/ClassVersionFilter.java create mode 100644 src/proguard/classfile/visitor/ClassVersionSetter.java create mode 100644 src/proguard/classfile/visitor/ClassVisitor.java create mode 100644 src/proguard/classfile/visitor/ConcreteClassDownTraveler.java create mode 100644 src/proguard/classfile/visitor/DotClassClassVisitor.java create mode 100644 src/proguard/classfile/visitor/ExceptClassFilter.java create mode 100644 src/proguard/classfile/visitor/ExceptClassesFilter.java create mode 100644 src/proguard/classfile/visitor/ExceptionCounter.java create mode 100644 src/proguard/classfile/visitor/ExceptionExcludedOffsetFilter.java create mode 100644 src/proguard/classfile/visitor/ExceptionHandlerConstantVisitor.java create mode 100644 src/proguard/classfile/visitor/ExceptionHandlerFilter.java create mode 100644 src/proguard/classfile/visitor/ExceptionOffsetFilter.java create mode 100644 src/proguard/classfile/visitor/ExceptionRangeFilter.java create mode 100644 src/proguard/classfile/visitor/ImplementedClassConstantFilter.java create mode 100644 src/proguard/classfile/visitor/ImplementedClassFilter.java create mode 100644 src/proguard/classfile/visitor/ImplementingClassConstantFilter.java create mode 100644 src/proguard/classfile/visitor/LibraryClassFilter.java create mode 100644 src/proguard/classfile/visitor/LibraryMemberFilter.java create mode 100644 src/proguard/classfile/visitor/MemberAccessFilter.java create mode 100644 src/proguard/classfile/visitor/MemberClassAccessFilter.java create mode 100644 src/proguard/classfile/visitor/MemberCollector.java create mode 100644 src/proguard/classfile/visitor/MemberCounter.java create mode 100644 src/proguard/classfile/visitor/MemberDescriptorFilter.java create mode 100644 src/proguard/classfile/visitor/MemberNameFilter.java create mode 100644 src/proguard/classfile/visitor/MemberToClassVisitor.java create mode 100644 src/proguard/classfile/visitor/MemberVisitor.java create mode 100644 src/proguard/classfile/visitor/MethodImplementationFilter.java create mode 100644 src/proguard/classfile/visitor/MethodImplementationTraveler.java create mode 100644 src/proguard/classfile/visitor/MultiClassPoolVisitor.java create mode 100644 src/proguard/classfile/visitor/MultiClassVisitor.java create mode 100644 src/proguard/classfile/visitor/MultiMemberVisitor.java create mode 100644 src/proguard/classfile/visitor/NamedClassVisitor.java create mode 100644 src/proguard/classfile/visitor/NamedFieldVisitor.java create mode 100644 src/proguard/classfile/visitor/NamedMethodVisitor.java create mode 100644 src/proguard/classfile/visitor/ProgramClassFilter.java create mode 100644 src/proguard/classfile/visitor/ProgramMemberFilter.java create mode 100644 src/proguard/classfile/visitor/ReferencedClassVisitor.java create mode 100644 src/proguard/classfile/visitor/ReferencedMemberVisitor.java create mode 100644 src/proguard/classfile/visitor/SimilarMemberVisitor.java create mode 100644 src/proguard/classfile/visitor/SimpleClassPrinter.java create mode 100644 src/proguard/classfile/visitor/SubclassFilter.java create mode 100644 src/proguard/classfile/visitor/SubclassTraveler.java create mode 100644 src/proguard/classfile/visitor/VariableClassVisitor.java create mode 100644 src/proguard/classfile/visitor/VariableMemberVisitor.java create mode 100644 src/proguard/classfile/visitor/package.html create mode 100644 src/proguard/evaluation/BasicBranchUnit.java create mode 100644 src/proguard/evaluation/BasicInvocationUnit.java create mode 100644 src/proguard/evaluation/BranchUnit.java create mode 100644 src/proguard/evaluation/InvocationUnit.java create mode 100644 src/proguard/evaluation/Processor.java create mode 100644 src/proguard/evaluation/Stack.java create mode 100644 src/proguard/evaluation/TracedStack.java create mode 100644 src/proguard/evaluation/TracedVariables.java create mode 100644 src/proguard/evaluation/Variables.java create mode 100644 src/proguard/evaluation/value/Category1Value.java create mode 100644 src/proguard/evaluation/value/Category2Value.java create mode 100644 src/proguard/evaluation/value/ComparisonValue.java create mode 100644 src/proguard/evaluation/value/CompositeDoubleValue.java create mode 100644 src/proguard/evaluation/value/CompositeFloatValue.java create mode 100644 src/proguard/evaluation/value/CompositeIntegerValue.java create mode 100644 src/proguard/evaluation/value/CompositeLongValue.java create mode 100644 src/proguard/evaluation/value/ConvertedByteValue.java create mode 100644 src/proguard/evaluation/value/ConvertedCharacterValue.java create mode 100644 src/proguard/evaluation/value/ConvertedDoubleValue.java create mode 100644 src/proguard/evaluation/value/ConvertedFloatValue.java create mode 100644 src/proguard/evaluation/value/ConvertedIntegerValue.java create mode 100644 src/proguard/evaluation/value/ConvertedLongValue.java create mode 100644 src/proguard/evaluation/value/ConvertedShortValue.java create mode 100644 src/proguard/evaluation/value/DoubleValue.java create mode 100644 src/proguard/evaluation/value/FloatValue.java create mode 100644 src/proguard/evaluation/value/IdentifiedDoubleValue.java create mode 100644 src/proguard/evaluation/value/IdentifiedFloatValue.java create mode 100644 src/proguard/evaluation/value/IdentifiedIntegerValue.java create mode 100644 src/proguard/evaluation/value/IdentifiedLongValue.java create mode 100644 src/proguard/evaluation/value/IdentifiedReferenceValue.java create mode 100644 src/proguard/evaluation/value/IdentifiedValueFactory.java create mode 100644 src/proguard/evaluation/value/InstructionOffsetValue.java create mode 100644 src/proguard/evaluation/value/IntegerValue.java create mode 100644 src/proguard/evaluation/value/LongValue.java create mode 100644 src/proguard/evaluation/value/NegatedDoubleValue.java create mode 100644 src/proguard/evaluation/value/NegatedFloatValue.java create mode 100644 src/proguard/evaluation/value/NegatedIntegerValue.java create mode 100644 src/proguard/evaluation/value/NegatedLongValue.java create mode 100644 src/proguard/evaluation/value/ParticularDoubleValue.java create mode 100644 src/proguard/evaluation/value/ParticularFloatValue.java create mode 100644 src/proguard/evaluation/value/ParticularIntegerValue.java create mode 100644 src/proguard/evaluation/value/ParticularLongValue.java create mode 100644 src/proguard/evaluation/value/ReferenceValue.java create mode 100644 src/proguard/evaluation/value/SpecificDoubleValue.java create mode 100644 src/proguard/evaluation/value/SpecificFloatValue.java create mode 100644 src/proguard/evaluation/value/SpecificIntegerValue.java create mode 100644 src/proguard/evaluation/value/SpecificLongValue.java create mode 100644 src/proguard/evaluation/value/SpecificValueFactory.java create mode 100644 src/proguard/evaluation/value/TopValue.java create mode 100644 src/proguard/evaluation/value/UnknownDoubleValue.java create mode 100644 src/proguard/evaluation/value/UnknownFloatValue.java create mode 100644 src/proguard/evaluation/value/UnknownIntegerValue.java create mode 100644 src/proguard/evaluation/value/UnknownLongValue.java create mode 100644 src/proguard/evaluation/value/Value.java create mode 100644 src/proguard/evaluation/value/ValueFactory.java create mode 100644 src/proguard/evaluation/value/package.html create mode 100644 src/proguard/gui/ClassPathPanel.java create mode 100644 src/proguard/gui/ClassSpecificationDialog.java create mode 100644 src/proguard/gui/ClassSpecificationsPanel.java create mode 100644 src/proguard/gui/ExtensionFileFilter.java create mode 100644 src/proguard/gui/FilterBuilder.java create mode 100644 src/proguard/gui/FilterDialog.java create mode 100644 src/proguard/gui/GUIResources.java create mode 100644 src/proguard/gui/GUIResources.properties create mode 100644 src/proguard/gui/KeepSpecificationsPanel.java create mode 100644 src/proguard/gui/ListPanel.java create mode 100644 src/proguard/gui/MANIFEST.MF create mode 100644 src/proguard/gui/MemberSpecificationDialog.java create mode 100644 src/proguard/gui/MemberSpecificationsPanel.java create mode 100644 src/proguard/gui/MessageDialogRunnable.java create mode 100644 src/proguard/gui/OptimizationsDialog.java create mode 100644 src/proguard/gui/ProGuardGUI.java create mode 100644 src/proguard/gui/ProGuardRunnable.java create mode 100644 src/proguard/gui/ReTraceRunnable.java create mode 100644 src/proguard/gui/SwingUtil.java create mode 100644 src/proguard/gui/TabbedPane.java create mode 100644 src/proguard/gui/TextAreaOutputStream.java create mode 100644 src/proguard/gui/arrow.gif create mode 100644 src/proguard/gui/boilerplate.pro create mode 100644 src/proguard/gui/default.pro create mode 100644 src/proguard/gui/package.html create mode 100644 src/proguard/gui/splash/BufferedSprite.java create mode 100644 src/proguard/gui/splash/CircleSprite.java create mode 100644 src/proguard/gui/splash/ClipSprite.java create mode 100644 src/proguard/gui/splash/ColorSprite.java create mode 100644 src/proguard/gui/splash/CompositeSprite.java create mode 100644 src/proguard/gui/splash/ConstantColor.java create mode 100644 src/proguard/gui/splash/ConstantDouble.java create mode 100644 src/proguard/gui/splash/ConstantFont.java create mode 100644 src/proguard/gui/splash/ConstantInt.java create mode 100644 src/proguard/gui/splash/ConstantString.java create mode 100644 src/proguard/gui/splash/ConstantTiming.java create mode 100644 src/proguard/gui/splash/FontSprite.java create mode 100644 src/proguard/gui/splash/ImageSprite.java create mode 100644 src/proguard/gui/splash/LinearColor.java create mode 100644 src/proguard/gui/splash/LinearDouble.java create mode 100644 src/proguard/gui/splash/LinearInt.java create mode 100644 src/proguard/gui/splash/LinearTiming.java create mode 100644 src/proguard/gui/splash/OverrideGraphics2D.java create mode 100644 src/proguard/gui/splash/RectangleSprite.java create mode 100644 src/proguard/gui/splash/SawToothTiming.java create mode 100644 src/proguard/gui/splash/ShadowedSprite.java create mode 100644 src/proguard/gui/splash/SineTiming.java create mode 100644 src/proguard/gui/splash/SmoothTiming.java create mode 100644 src/proguard/gui/splash/SplashPanel.java create mode 100644 src/proguard/gui/splash/Sprite.java create mode 100644 src/proguard/gui/splash/TextSprite.java create mode 100644 src/proguard/gui/splash/TimeSwitchSprite.java create mode 100644 src/proguard/gui/splash/Timing.java create mode 100644 src/proguard/gui/splash/TypeWriterString.java create mode 100644 src/proguard/gui/splash/VariableColor.java create mode 100644 src/proguard/gui/splash/VariableDouble.java create mode 100644 src/proguard/gui/splash/VariableFont.java create mode 100644 src/proguard/gui/splash/VariableInt.java create mode 100644 src/proguard/gui/splash/VariableSizeFont.java create mode 100644 src/proguard/gui/splash/VariableString.java create mode 100644 src/proguard/gui/splash/package.html create mode 100644 src/proguard/gui/vtitle.png create mode 100644 src/proguard/io/CascadingDataEntryWriter.java create mode 100644 src/proguard/io/ClassFilter.java create mode 100644 src/proguard/io/ClassReader.java create mode 100644 src/proguard/io/ClassRewriter.java create mode 100644 src/proguard/io/DataEntry.java create mode 100644 src/proguard/io/DataEntryCopier.java create mode 100644 src/proguard/io/DataEntryDirectoryFilter.java create mode 100644 src/proguard/io/DataEntryFilter.java create mode 100644 src/proguard/io/DataEntryNameFilter.java create mode 100644 src/proguard/io/DataEntryObfuscator.java create mode 100644 src/proguard/io/DataEntryParentFilter.java create mode 100644 src/proguard/io/DataEntryPump.java create mode 100644 src/proguard/io/DataEntryReader.java create mode 100644 src/proguard/io/DataEntryRenamer.java create mode 100644 src/proguard/io/DataEntryRewriter.java create mode 100644 src/proguard/io/DataEntryWriter.java create mode 100644 src/proguard/io/DirectoryFilter.java create mode 100644 src/proguard/io/DirectoryPump.java create mode 100644 src/proguard/io/DirectoryWriter.java create mode 100644 src/proguard/io/FileDataEntry.java create mode 100644 src/proguard/io/FilteredDataEntryReader.java create mode 100644 src/proguard/io/FilteredDataEntryWriter.java create mode 100644 src/proguard/io/Finisher.java create mode 100644 src/proguard/io/JarReader.java create mode 100644 src/proguard/io/JarWriter.java create mode 100644 src/proguard/io/ManifestRewriter.java create mode 100644 src/proguard/io/NameFilter.java create mode 100644 src/proguard/io/ParentDataEntryWriter.java create mode 100644 src/proguard/io/RenamedDataEntry.java create mode 100644 src/proguard/io/ZipDataEntry.java create mode 100644 src/proguard/io/package.html create mode 100644 src/proguard/obfuscate/AttributeShrinker.java create mode 100644 src/proguard/obfuscate/AttributeUsageMarker.java create mode 100644 src/proguard/obfuscate/ClassObfuscator.java create mode 100644 src/proguard/obfuscate/ClassRenamer.java create mode 100644 src/proguard/obfuscate/DictionaryNameFactory.java create mode 100644 src/proguard/obfuscate/MapCleaner.java create mode 100644 src/proguard/obfuscate/MappingKeeper.java create mode 100644 src/proguard/obfuscate/MappingPrinter.java create mode 100644 src/proguard/obfuscate/MappingProcessor.java create mode 100644 src/proguard/obfuscate/MappingReader.java create mode 100644 src/proguard/obfuscate/MemberNameCleaner.java create mode 100644 src/proguard/obfuscate/MemberNameCollector.java create mode 100644 src/proguard/obfuscate/MemberNameConflictFixer.java create mode 100644 src/proguard/obfuscate/MemberObfuscator.java create mode 100644 src/proguard/obfuscate/MemberSpecialNameFilter.java create mode 100644 src/proguard/obfuscate/MultiMappingProcessor.java create mode 100644 src/proguard/obfuscate/NameAndTypeShrinker.java create mode 100644 src/proguard/obfuscate/NameAndTypeUsageMarker.java create mode 100644 src/proguard/obfuscate/NameFactory.java create mode 100644 src/proguard/obfuscate/NameFactoryResetter.java create mode 100644 src/proguard/obfuscate/NameMarker.java create mode 100644 src/proguard/obfuscate/NumericNameFactory.java create mode 100644 src/proguard/obfuscate/Obfuscator.java create mode 100644 src/proguard/obfuscate/SimpleNameFactory.java create mode 100644 src/proguard/obfuscate/SourceFileRenamer.java create mode 100644 src/proguard/obfuscate/SpecialNameFactory.java create mode 100644 src/proguard/obfuscate/Utf8Shrinker.java create mode 100644 src/proguard/obfuscate/Utf8UsageMarker.java create mode 100644 src/proguard/obfuscate/package.html create mode 100644 src/proguard/optimize/ChangedCodePrinter.java create mode 100644 src/proguard/optimize/ConstantMemberFilter.java create mode 100644 src/proguard/optimize/ConstantParameterFilter.java create mode 100644 src/proguard/optimize/DuplicateInitializerFixer.java create mode 100644 src/proguard/optimize/DuplicateInitializerInvocationFixer.java create mode 100644 src/proguard/optimize/KeepMarker.java create mode 100644 src/proguard/optimize/MemberDescriptorSpecializer.java create mode 100644 src/proguard/optimize/MethodDescriptorShrinker.java create mode 100644 src/proguard/optimize/MethodStaticizer.java create mode 100644 src/proguard/optimize/OptimizationInfoMemberFilter.java create mode 100644 src/proguard/optimize/Optimizer.java create mode 100644 src/proguard/optimize/ParameterShrinker.java create mode 100644 src/proguard/optimize/TailRecursionSimplifier.java create mode 100644 src/proguard/optimize/WriteOnlyFieldFilter.java create mode 100644 src/proguard/optimize/evaluation/EvaluationShrinker.java create mode 100644 src/proguard/optimize/evaluation/EvaluationSimplifier.java create mode 100644 src/proguard/optimize/evaluation/LivenessAnalyzer.java create mode 100644 src/proguard/optimize/evaluation/LoadingInvocationUnit.java create mode 100644 src/proguard/optimize/evaluation/PartialEvaluator.java create mode 100644 src/proguard/optimize/evaluation/StoringInvocationUnit.java create mode 100644 src/proguard/optimize/evaluation/TracedBranchUnit.java create mode 100644 src/proguard/optimize/evaluation/VariableOptimizer.java create mode 100644 src/proguard/optimize/evaluation/package.html create mode 100644 src/proguard/optimize/info/AccessMethodMarker.java create mode 100644 src/proguard/optimize/info/BackwardBranchMarker.java create mode 100644 src/proguard/optimize/info/CatchExceptionMarker.java create mode 100644 src/proguard/optimize/info/CaughtClassFilter.java create mode 100644 src/proguard/optimize/info/CaughtClassMarker.java create mode 100644 src/proguard/optimize/info/ClassOptimizationInfo.java create mode 100644 src/proguard/optimize/info/ClassOptimizationInfoSetter.java create mode 100644 src/proguard/optimize/info/DotClassFilter.java create mode 100644 src/proguard/optimize/info/DotClassMarker.java create mode 100644 src/proguard/optimize/info/ExceptionInstructionChecker.java create mode 100644 src/proguard/optimize/info/FieldOptimizationInfo.java create mode 100644 src/proguard/optimize/info/InstanceofClassFilter.java create mode 100644 src/proguard/optimize/info/InstanceofClassMarker.java create mode 100644 src/proguard/optimize/info/InstantiationClassFilter.java create mode 100644 src/proguard/optimize/info/InstantiationClassMarker.java create mode 100644 src/proguard/optimize/info/MemberOptimizationInfoSetter.java create mode 100644 src/proguard/optimize/info/MethodInvocationMarker.java create mode 100644 src/proguard/optimize/info/MethodOptimizationInfo.java create mode 100644 src/proguard/optimize/info/NoSideEffectMethodMarker.java create mode 100644 src/proguard/optimize/info/NonPrivateMemberMarker.java create mode 100644 src/proguard/optimize/info/PackageVisibleMemberContainingClassMarker.java create mode 100644 src/proguard/optimize/info/PackageVisibleMemberInvokingClassMarker.java create mode 100644 src/proguard/optimize/info/ParameterUsageMarker.java create mode 100644 src/proguard/optimize/info/ReadWriteFieldMarker.java create mode 100644 src/proguard/optimize/info/SideEffectInstructionChecker.java create mode 100644 src/proguard/optimize/info/SideEffectMethodMarker.java create mode 100644 src/proguard/optimize/info/SuperInvocationMarker.java create mode 100644 src/proguard/optimize/info/VariableUsageMarker.java create mode 100644 src/proguard/optimize/info/package.html create mode 100644 src/proguard/optimize/package.html create mode 100644 src/proguard/optimize/peephole/BranchTargetFinder.java create mode 100644 src/proguard/optimize/peephole/ClassFinalizer.java create mode 100644 src/proguard/optimize/peephole/ClassMerger.java create mode 100644 src/proguard/optimize/peephole/GotoCommonCodeReplacer.java create mode 100644 src/proguard/optimize/peephole/GotoGotoReplacer.java create mode 100644 src/proguard/optimize/peephole/GotoReturnReplacer.java create mode 100644 src/proguard/optimize/peephole/HorizontalClassMerger.java create mode 100644 src/proguard/optimize/peephole/InstructionSequenceConstants.java create mode 100644 src/proguard/optimize/peephole/InstructionSequenceReplacer.java create mode 100644 src/proguard/optimize/peephole/InstructionSequencesReplacer.java create mode 100644 src/proguard/optimize/peephole/MemberPrivatizer.java create mode 100644 src/proguard/optimize/peephole/MethodFinalizer.java create mode 100644 src/proguard/optimize/peephole/MethodInliner.java create mode 100644 src/proguard/optimize/peephole/NopRemover.java create mode 100644 src/proguard/optimize/peephole/PeepholeOptimizer.java create mode 100644 src/proguard/optimize/peephole/ReachableCodeMarker.java create mode 100644 src/proguard/optimize/peephole/RetargetedInnerClassAttributeRemover.java create mode 100644 src/proguard/optimize/peephole/TargetClassChanger.java create mode 100644 src/proguard/optimize/peephole/UnreachableCodeRemover.java create mode 100644 src/proguard/optimize/peephole/UnreachableExceptionRemover.java create mode 100644 src/proguard/optimize/peephole/VariableShrinker.java create mode 100644 src/proguard/optimize/peephole/VerticalClassMerger.java create mode 100644 src/proguard/optimize/peephole/package.html create mode 100644 src/proguard/package.html create mode 100644 src/proguard/preverify/CodePreverifier.java create mode 100644 src/proguard/preverify/CodeSubroutineInliner.java create mode 100644 src/proguard/preverify/Preverifier.java create mode 100644 src/proguard/preverify/SubroutineInliner.java create mode 100644 src/proguard/retrace/MANIFEST.MF create mode 100644 src/proguard/retrace/ReTrace.java create mode 100644 src/proguard/retrace/package.html create mode 100644 src/proguard/shrink/AnnotationUsageMarker.java create mode 100644 src/proguard/shrink/ClassShrinker.java create mode 100644 src/proguard/shrink/InnerUsageMarker.java create mode 100644 src/proguard/shrink/InterfaceUsageMarker.java create mode 100644 src/proguard/shrink/ShortestUsageMark.java create mode 100644 src/proguard/shrink/ShortestUsageMarker.java create mode 100644 src/proguard/shrink/ShortestUsagePrinter.java create mode 100644 src/proguard/shrink/Shrinker.java create mode 100644 src/proguard/shrink/UsageMarker.java create mode 100644 src/proguard/shrink/UsagePrinter.java create mode 100644 src/proguard/shrink/UsedClassFilter.java create mode 100644 src/proguard/shrink/UsedMemberFilter.java create mode 100644 src/proguard/shrink/package.html create mode 100644 src/proguard/util/AndMatcher.java create mode 100644 src/proguard/util/ClassNameParser.java create mode 100644 src/proguard/util/ConstantMatcher.java create mode 100644 src/proguard/util/EmptyStringMatcher.java create mode 100644 src/proguard/util/ExtensionMatcher.java create mode 100644 src/proguard/util/FileNameParser.java create mode 100644 src/proguard/util/FixedStringMatcher.java create mode 100644 src/proguard/util/ListMatcher.java create mode 100644 src/proguard/util/ListParser.java create mode 100644 src/proguard/util/ListUtil.java create mode 100644 src/proguard/util/NameParser.java create mode 100644 src/proguard/util/NotMatcher.java create mode 100644 src/proguard/util/OrMatcher.java create mode 100644 src/proguard/util/SettableMatcher.java create mode 100644 src/proguard/util/StringMatcher.java create mode 100644 src/proguard/util/StringParser.java create mode 100644 src/proguard/util/VariableStringMatcher.java create mode 100644 src/proguard/util/package.html create mode 100644 src/proguard/wtk/ProGuardObfuscator.java create mode 100644 src/proguard/wtk/default.pro create mode 100644 src/proguard/wtk/package.html diff --git a/README b/README new file mode 100644 index 0000000..8766da5 --- /dev/null +++ b/README @@ -0,0 +1,33 @@ +ProGuard, Java class file shrinker, optimizer, obfuscator, and preverifier +========================================================================== + +This distribution contains the following directories: + +- bin : simple wrapper scripts to run ProGuard, its GUI, and ReTrace +- lib : the main jars, compiled and ready to use with "java -jar ...." +- docs : the complete documentation, licenses, etc. in html format +- examples : some example configuration files +- src : the source code +- build : various alternative build scripts + + +The best place to start is docs/index.html + + +Example +======= + +If you want to give ProGuard a spin right away, try processing the ProGuard +jar itself: + + cd examples + java -jar ../lib/proguard.jar @proguard.pro + +The resulting proguard_out.jar contains the same application, but it's a lot +smaller. + +Enjoy! + +http://proguard.sourceforge.net/ + +Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) diff --git a/bin/proguard.bat b/bin/proguard.bat new file mode 100644 index 0000000..7989253 --- /dev/null +++ b/bin/proguard.bat @@ -0,0 +1,10 @@ +@ECHO OFF + +REM Start-up script for ProGuard -- free class file shrinker, optimizer, +REM obfuscator, and preverifier for Java bytecode. + +IF EXIST "%PROGUARD_HOME%" GOTO home +SET PROGUARD_HOME=.. +:home + +java -jar "%PROGUARD_HOME%"\lib\proguard.jar %1 %2 %3 %4 %5 %6 %7 %8 %9 diff --git a/bin/proguard.sh b/bin/proguard.sh new file mode 100755 index 0000000..228d044 --- /dev/null +++ b/bin/proguard.sh @@ -0,0 +1,9 @@ +#!/bin/sh +# +# Start-up script for ProGuard -- free class file shrinker, optimizer, +# obfuscator, and preverifier for Java bytecode. + +PROGUARD_HOME=`dirname "$0"` +PROGUARD_HOME=`dirname "$PROGUARD_HOME"` + +java -jar $PROGUARD_HOME/lib/proguard.jar "$@" diff --git a/bin/proguardgui.bat b/bin/proguardgui.bat new file mode 100644 index 0000000..073d98a --- /dev/null +++ b/bin/proguardgui.bat @@ -0,0 +1,10 @@ +@ECHO OFF + +REM Start-up script for the GUI of ProGuard -- free class file shrinker, +REM optimizer, obfuscator, and preverifier for Java bytecode. + +IF EXIST "%PROGUARD_HOME%" GOTO home +SET PROGUARD_HOME=.. +:home + +java -jar "%PROGUARD_HOME%"\lib\proguardgui.jar %1 %2 %3 %4 %5 %6 %7 %8 %9 diff --git a/bin/proguardgui.sh b/bin/proguardgui.sh new file mode 100755 index 0000000..5a25d7b --- /dev/null +++ b/bin/proguardgui.sh @@ -0,0 +1,9 @@ +#!/bin/sh +# +# Start-up script for the GUI of ProGuard -- free class file shrinker, +# optimizer, obfuscator, and preverifier for Java bytecode. + +PROGUARD_HOME=`dirname "$0"` +PROGUARD_HOME=`dirname "$PROGUARD_HOME"` + +java -jar $PROGUARD_HOME/lib/proguardgui.jar "$@" diff --git a/bin/retrace.bat b/bin/retrace.bat new file mode 100644 index 0000000..70603d3 --- /dev/null +++ b/bin/retrace.bat @@ -0,0 +1,10 @@ +@ECHO OFF + +REM Start-up script for Retrace -- companion tool for ProGuard, free class file +REM shrinker, optimizer, obfuscator, and preverifier for Java bytecode. + +IF EXIST "%PROGUARD_HOME%" GOTO home +SET PROGUARD_HOME=.. +:home + +java -jar "%PROGUARD_HOME%"\lib\retrace.jar %1 %2 %3 %4 %5 %6 %7 %8 %9 diff --git a/bin/retrace.sh b/bin/retrace.sh new file mode 100755 index 0000000..5db744e --- /dev/null +++ b/bin/retrace.sh @@ -0,0 +1,9 @@ +#!/bin/sh +# +# Start-up script for Retrace -- companion tool for ProGuard, free class file +# shrinker, optimizer, obfuscator, and preverifier for Java bytecode. + +PROGUARD_HOME=`dirname "$0"` +PROGUARD_HOME=`dirname "$PROGUARD_HOME"` + +java -jar $PROGUARD_HOME/lib/retrace.jar "$@" diff --git a/build/build.sh b/build/build.sh new file mode 100755 index 0000000..eb5fcf7 --- /dev/null +++ b/build/build.sh @@ -0,0 +1,94 @@ +#!/bin/bash +# +# GNU/Linux build script for ProGuard. + +# +# Configuration. +# + +ANT_HOME=${ANT_HOME:-/usr/local/java/ant} +WTK_HOME=${WTK_HOME:-/usr/local/java/wtk} + +if [ -z $PROGUARD_HOME ]; then + PROGUARD_HOME=$(which "$0") + PROGUARD_HOME=$(dirname "$0")/.. +fi + +cd "$PROGUARD_HOME" + +SRC=src +CLASSES=classes +LIB=lib + +PROGUARD=proguard/ProGuard +PROGUARD_GUI=proguard/gui/ProGuardGUI +RETRACE=proguard/retrace/ReTrace +ANT_TASK=proguard/ant/ProGuardTask +WTK_PLUGIN=proguard/wtk/ProGuardObfuscator + +ANT_JAR=$ANT_HOME/lib/ant.jar +WTK_JAR=$WTK_HOME/wtklib/kenv.zip + +PROGUARD_JAR=$LIB/proguard.jar +PROGUARD_GUI_JAR=$LIB/proguardgui.jar +RETRACE_JAR=$LIB/retrace.jar + +# +# Function definitions. +# + +function compile { + # Compile java source files. + echo "Compiling ${1//\//.} ..." + javac -nowarn -Xlint:none -sourcepath "$SRC" -d "$CLASSES" \ + "$SRC/$1.java" 2>&1 \ + | sed -e 's|^| |' + + # Copy resource files. + (cd "$SRC"; find $(dirname $1) -maxdepth 1 \ + \( -name \*.properties -o -name \*.png -o -name \*.gif -o -name \*.pro \) \ + -exec cp --parents {} "../$CLASSES" \; ) +} + +function createjar { + echo "Creating $2..." + jar -cfm "$2" "$SRC/$(dirname $1)/MANIFEST.MF" -C "$CLASSES" $(dirname $1) +} + +function updatejar { + echo "Updating $PROGUARD_JAR..." + jar -uf "$PROGUARD_JAR" -C "$CLASSES" $(dirname $1) +} + +# +# Main script body. +# + +mkdir -p "$CLASSES" + +compile $PROGUARD +createjar $PROGUARD "$PROGUARD_JAR" + +compile $PROGUARD_GUI +createjar $PROGUARD_GUI "$PROGUARD_GUI_JAR" + +compile $RETRACE +createjar $RETRACE "$RETRACE_JAR" + +if [ -f "$ANT_JAR" ]; then + export CLASSPATH=$ANT_JAR + compile $ANT_TASK + updatejar $ANT_TASK +else + echo "Please make sure the environment variable ANT_HOME is set correctly," + echo "if you want to compile the optional ProGuard Ant task." +fi + +if [ -f "$WTK_JAR" ]; then + export CLASSPATH=$WTK_JAR + compile $WTK_PLUGIN + updatejar $WTK_PLUGIN +else + echo "Please make sure the environment variable WTK_HOME is set correctly," + echo "if you want to compile the optional ProGuard WTK plugin." +fi diff --git a/build/build.xml b/build/build.xml new file mode 100644 index 0000000..a592945 --- /dev/null +++ b/build/build.xml @@ -0,0 +1,171 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/build/makefile b/build/makefile new file mode 100644 index 0000000..0508eb4 --- /dev/null +++ b/build/makefile @@ -0,0 +1,94 @@ +# GNU/Linux makefile for ProGuard. + +ANT_HOME = /usr/local/java/ant +WTK_HOME = /usr/local/java/wtk + +PROGUARD_HOME := $(subst ./..,..,$(subst /build/..,/,$(dir $(MAKEFILE_LIST))..)) +SRC = $(PROGUARD_HOME)/src +CLASSES = $(PROGUARD_HOME)/classes +LIB = $(PROGUARD_HOME)/lib + +ANT_JAR = $(ANT_HOME)/lib/ant.jar +WTK_JAR = $(WTK_HOME)/wtklib/kenv.zip + +CLASSPATH = $(ANT_JAR):$(WTK_JAR) + +PROGUARD = proguard/ProGuard +PROGUARD_GUI = proguard/gui/ProGuardGUI +RETRACE = proguard/retrace/ReTrace +ANT_TASK = proguard/ant/ProGuardTask +WTK_PLUGIN = proguard/wtk/ProGuardObfuscator + +TARGETS = $(PROGUARD) $(PROGUARD_GUI) $(RETRACE) $(ANT_TASK) $(WTK_PLUGIN) + +JAVAC_OPTIONS = -nowarn -Xlint:none -classpath $(CLASSPATH) -sourcepath $(SRC) -d $(CLASSES) + +# Command sequence definitions for creating jars. + +define createjar + jar -cfm $(LIB)/$@.jar $(SRC)/$(dir $<)MANIFEST.MF \ + -C $(CLASSES) $(dir $<) +endef + +define updatejar + jar -uf $(LIB)/proguard.jar \ + -C $(CLASSES) $(dir $<) +endef + +# The various targets. + +all: basic options +basic: proguard proguardgui retrace +options: anttask wtkplugin + +proguard: $(PROGUARD) + $(createjar) + +proguardgui: proguard +proguardgui: $(PROGUARD_GUI) + $(createjar) + +retrace: $(RETRACE) + $(createjar) + +anttask: $(ANT_JAR) +anttask: $(PROGUARD) +anttask: $(ANT_TASK) + $(updatejar) + +wtkplugin: $(WTK_JAR) +wtkplugin: $(PROGUARD) +wtkplugin: $(WTK_PLUGIN) + $(updatejar) + +clean: + -rm -fr $(CLASSES) $(LIB) + + +define RESOURCES + $(shell find $(SRC)/$(dir $(1)) -maxdepth 1 \( -name \*.properties -o -name \*.png -o -name \*.gif -o -name \*.pro \) -printf $(CLASSES)/$(dir $(1))%P\\n) +endef + +define TARGETRULE + $(1): $(CLASSES) $(CLASSES)/$(1).class $(call RESOURCES,$(1)) $(LIB) +endef + +$(foreach TARGET,$(TARGETS),$(eval $(call TARGETRULE,$(TARGET)))) + +$(CLASSES) $(LIB): + -mkdir -p $@ + +$(CLASSES)/%.class: $(SRC)/%.java + javac $(JAVAC_OPTIONS) $^ + +$(CLASSES)/%.properties $(CLASSES)/%.png $(CLASSES)/%.gif $(CLASSES)/%.pro: + cp $(subst $(CLASSES),$(SRC),$@) $@ + +%.jar %.zip: + echo "Please make sure the path to $@ is set" + echo "correctly in this $(strip $(MAKEFILE_LIST))." + echo "Alternatively, if you don't need the corresponding option," + echo "you can run `make' with the option -k." + find $@ + +.PHONY: all basic options proguard proguardgui retrace anttask wtkplugin clean $(TARGETS) $(OPTIONAL_TARGETS) diff --git a/docs/FAQ.html b/docs/FAQ.html new file mode 100644 index 0000000..8f19b15 --- /dev/null +++ b/docs/FAQ.html @@ -0,0 +1,254 @@ + + + + + + +ProGuard FAQ + + + +

Frequently Asked Questions

+ +

Contents

+ +
    +
  1. What is shrinking? +
  2. What is obfuscation? +
  3. What is preverification? +
  4. What kind of optimizations does ProGuard + support? +
  5. Can I use ProGuard to process my commercial + application? +
  6. Does ProGuard work with Java 2? Java 5? Java + 6? +
  7. Does ProGuard work with Java Micro Edition? +
  8. Does ProGuard work for Google Android code? +
  9. Does ProGuard work for Blackberry code? +
  10. Does ProGuard have support for Ant? +
  11. Does ProGuard come with a GUI? +
  12. Does ProGuard handle Class.forName + calls? +
  13. Does ProGuard handle resource files? +
  14. Does ProGuard encrypt strings constants? +
  15. Does ProGuard perform control flow obfuscation? +
  16. Does ProGuard support incremental + obfuscation? +
  17. Can ProGuard obfuscate using reserved + keywords? +
  18. Can ProGuard reconstruct obfuscated stack + traces? +
+ +  +

What is shrinking?

+ +Java source code (.java files) is typically compiled to bytecode (.class +files). Bytecode is more compact than Java source code, but it may still +contain a lot of unused code, especially if it includes program libraries. +Shrinking programs such as ProGuard can analyze bytecode and remove +unused classes, fields, and methods. The program remains functionally +equivalent, including the information given in exception stack traces. + +  +

What is obfuscation?

+ +By default, compiled bytecode still contains a lot of debugging information: +source file names, line numbers, field names, method names, argument names, +variable names, etc. This information makes it straightforward to decompile +the bytecode and reverse-engineer entire programs. Sometimes, this is not +desirable. Obfuscators such as ProGuard can remove the debugging +information and replace all names by meaningless character sequences, making +it much harder to reverse-engineer the code. It further compacts the code as a +bonus. The program remains functionally equivalent, except for the class +names, method names, and line numbers given in exception stack traces. + +  +

What is preverification?

+ +When loading class files, the class loader performs some sophisticated +verification of the byte code. This analysis makes sure the code can't +accidentally or intentionally break out of the sandbox of the virtual machine. +Java Micro Edition and Java 6 introduced split verification. This means that +the JME preverifier and the Java 6 compiler add preverification information to +the class files (StackMap and StackMapTable attributes, respectively), in order +to simplify the actual verification step for the class loader. Class files can +then be loaded faster and in a more memory-efficient way. ProGuard can +perform the preverification step too, for instance allowing to retarget older +class files at Java 6. + +  +

What kind of optimizations does ProGuard support?

+ +Apart from removing unused classes, fields, and methods in the shrinking step, +ProGuard can also perform optimizations at the bytecode level, inside +and across methods. Thanks to techniques like control flow analysis, data flow +analysis, partial evaluation, static single assignment, global value numbering, +and liveness analysis, ProGuard can: + + +The positive effects of these optimizations will depend on your code and on +the virtual machine on which the code is executed. Simple virtual machines may +benefit more than advanced virtual machines with sophisticated JIT compilers. +At the very least, your bytecode may become a bit smaller. +

+Some notable optimizations that aren't supported yet: +

+ +  +

Can I use ProGuard to process my commercial application?

+ +Yes, you can. ProGuard itself is distributed under the GPL, but this +doesn't affect the programs that you process. Your code remains yours, and +its license can remain the same. + +  +

Does ProGuard work with Java 2? Java 5? Java 6?

+ +Yes, ProGuard supports all JDKs from 1.1 up to and including 6.0. Java 2 +introduced some small differences in the class file format. Java 5 added +attributes for generics and for annotations. Java 6 introduced preverification +attributes. ProGuard handles all versions correctly. + +  +

Does ProGuard work with Java Micro Edition?

+ +Yes. ProGuard itself runs in Java Standard Edition, but you can freely +specify the run-time environment at which your programs are targeted, +including Java Micro Edition. ProGuard then also performs the required +preverification, producing more compact results than the traditional external +preverifier. +

+ProGuard also comes with an obfuscator plug-in for the JME Wireless +Toolkit. + +  +

Does ProGuard work for Google Android code?

+ +Yes. Google's dx compiler converts ordinary jar files into files +that run on Android devices. By preprocessing the original jar files, +ProGuard can significantly reduce the file sizes and boost the run-time +performance of the code. + +  +

Does ProGuard work for Blackberry code?

+ +It should. RIM's proprietary rapc compiler converts ordinary JME +jar files into cod files that run on Blackberry devices. The compiler performs +quite a few optimizations, but preprocessing the jar files with +ProGuard can generally still reduce the final code size by a few +percent. However, the rapc compiler also seems to contain some +bugs. It sometimes fails on obfuscated code that is valid and accepted by other +JME tools and VMs. Your mileage may therefore vary. + +  +

Does ProGuard have support for Ant?

+ +Yes. ProGuard provides an Ant task, so that it integrates seamlessly +into your Ant build processes. You can still use configurations in +ProGuard's own readable format. Alternatively, if you prefer XML, you +can specify the equivalent XML configuration. + +  +

Does ProGuard come with a GUI?

+ +Yes. First of all, ProGuard is perfectly usable as a command-line tool +that can easily be integrated into any automatic build process. For casual +users, there's also a graphical user interface that simplifies creating, +loading, editing, executing, and saving ProGuard configurations. + +  +

Does ProGuard handle Class.forName calls?

+ +Yes. ProGuard automatically handles constructs like +Class.forName("SomeClass") and SomeClass.class. The +referenced classes are preserved in the shrinking phase, and the string +arguments are properly replaced in the obfuscation phase. +

+With variable string arguments, it's generally not possible to determine their +possible values. They might be read from a configuration file, for instance. +However, ProGuard will note a number of constructs like +"(SomeClass)Class.forName(variable).newInstance()". These might +be an indication that the class or interface SomeClass and/or its +implementations may need to be preserved. The user can adapt his configuration +accordingly. + +  +

Does ProGuard handle resource files?

+ +Yes. ProGuard copies all non-class resource files, optionally adapting +their names and their contents to the obfuscation that has been applied. + +  +

Does ProGuard encrypt strings constants?

+ +No. Storing encrypted string constants in program code is fairly futile, since +the encryption has to be perfectly reversible by definition. Moreover, the +decryption costs additional memory and computation at run-time. If this feature +is ever incorporated, I'll provide a tool to decrypt the strings as well. + +  +

Does ProGuard perform flow obfuscation?

+ +Not explicitly. Control flow obfuscation injects additional branches into the +bytecode, in an attempt to fool decompilers. ProGuard does not do this, +in order to avoid any negative effects on performance and size. However, the +optimization step often already restructures the code to the point where most +decompilers get confused. + +  +

Does ProGuard support incremental obfuscation?

+ +Yes. This feature allows you to specify a previous obfuscation mapping file in +a new obfuscation step, in order to produce add-ons or patches for obfuscated +code. + +  +

Can ProGuard obfuscate using reserved keywords?

+ +Yes. You can specify your own obfuscation dictionary, such as a list of +reserved key words, identifiers with foreign characters, random source files, +or a text by Shakespeare. Note that this hardly improves the obfuscation. +Decent decompilers can automatically replace reserved keywords, and the effect +can be undone fairly easily, by obfuscating again with simpler names. + +  +

Can ProGuard reconstruct obfuscated stack traces?

+ +Yes. ProGuard comes with a companion tool, ReTrace, that can +'de-obfuscate' stack traces produced by obfuscated applications. The +reconstruction is based on the mapping file that ProGuard can write +out. If line numbers have been obfuscated away, a list of alternative method +names is presented for each obfuscated method name that has an ambiguous +reverse mapping. Please refer to the ProGuard User +Manual for more details. + +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/GPL.html b/docs/GPL.html new file mode 100644 index 0000000..c7a2458 --- /dev/null +++ b/docs/GPL.html @@ -0,0 +1,406 @@ + + + +GNU General Public License + + +

GNU General Public License

+

Table of Contents

+ + +

+ +

+ +

+ + + +

GNU GENERAL PUBLIC LICENSE

+

+Version 2, June 1991 + +

+ +
+Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+ + + +

Preamble

+ +

+ The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + +

+

+ When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + +

+

+ To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + +

+

+ For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + +

+

+ We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + +

+

+ Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + +

+

+ Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + +

+

+ The precise terms and conditions for copying, distribution and +modification follow. + +

+ + +

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

+ + +

+ +0. + This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". +

+ +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + +

+ +1. + You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. +

+ +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. +

+ +2. + You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: +

+ +

+ +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. +

+ +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. +

+ +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + +

+ +3. + You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + + + +

+ +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. +

+ +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. +

+ +4. + You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + +

+ +5. + You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + +

+ +6. + Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + +

+ +7. + If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. +

+ +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. +

+ +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. +

+ +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + +

+ +8. + If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + +

+ +9. + The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. +

+ +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + +

+ + +10. + If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + + +

NO WARRANTY

+ +

+ +11. + BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + +

+ +12. + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + +

+ + +

END OF TERMS AND CONDITIONS

+ + diff --git a/docs/GPL_exception.html b/docs/GPL_exception.html new file mode 100644 index 0000000..0a44d66 --- /dev/null +++ b/docs/GPL_exception.html @@ -0,0 +1,52 @@ + + + +Special Exception to the GNU General Public License + + +

Special Exception to the GNU General Public License

+ +

+Copyright © 2002-2009 Eric Lafortune +

+ +

+This program is free software; you can redistribute it and/or modify it under +the terms of the GNU General Public License as published by the Free Software +Foundation; either version 2 of the License, or (at your option) any later +version. +

+ +

+This program is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. +

+ +

+You should have received a copy of the GNU General Public License along with +this program; if not, write to the Free Software Foundation, Inc., 59 Temple +Place, Suite 330, Boston, MA 02111-1307 USA +

+ +

+In addition, as a special exception, Eric Lafortune gives permission to link +the code of this program with the following stand-alone applications: +

+and distribute linked combinations including the two. You must obey the GNU +General Public License in all respects for all of the code used other than +these programs. If you modify this file, you may extend this exception to your +version of the file, but you are not obligated to do so. If you do not wish to +do so, delete this exception statement from your version. +

+ + + diff --git a/docs/acknowledgements.html b/docs/acknowledgements.html new file mode 100644 index 0000000..af19461 --- /dev/null +++ b/docs/acknowledgements.html @@ -0,0 +1,68 @@ + + + + + + +ProGuard Acknowledgements + + + +

Acknowledgements

+ +The first versions of ProGuard grew out of RetroGuard, which its +author Mark Welsh kindly made available under the GNU Lesser General Public +License. RetroGuard is a very nice piece of code, but it only performed +obfuscation. I started from the class file parsing code and wrote my own +shrinker, optimizer, obfuscator, and preverifier. As of version 4.0, all of the +original code has been rewritten, so the most obvious remaining similarity are +the program names. +

+ +Dirk Schnelle has contributed and maintained the first versions of the Ant +task. I have rewritten the implementation for version 3.0, but the XML schema +is still based on his work. +

+ +Since its first public release, many people have expressed their enthusiasm and +have chimed in with interesting ideas, bug reports, and bug fixes: Thorsten +Heit, Oliver Retzl, Jonathan Knudsen, Tarcisio Camara, Bob Drury, Dave Jarvis, +Marc Chapman, Dave Morehouse, Richard Osbaldeston, Peter Hawkins, Mark +Sherington, David Sitsky, James Manning, Ptolemy Oberin, Frank-Michael Moser, +QZ Shines, Thomas Singer, Michele Puccini, Roman Bednarek, Natalia Pujol, +Daniel Sjöblom, Jan Filipsky, Charles Smith, Gerrit Telkamp, Noel +Grandin, Torbjörn Söderstedt, Clemens Eisserer, Clark Bassett, +Eduard Welch, Dawid Weiss, Andrew Wilson, Sean Owen, Niels Gron, Ishan Mehta, +Steven Adams, Xavier Kral, +and many others. Thanks! Your feedback has been invaluable. +

+ +I am developing ProGuard in my spare time, which is possible thanks to my +day-time job at Luciad. +

+ +SourceForge is generously providing the resources for +hosting this project and many other projects. +

+ +JetBrains is kindly providing a license for its IntelliJ IDEA development +environment. +

+ +The code and these web pages were written using Sun's JDKs, Linux, IntelliJ +IDEA, GNU emacs, bash, sed, awk, and a whole host of other tools that continue +to make programming interesting. +

+ +And finally, I'm a great fan of the Java Docking Library. + +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/alternatives.html b/docs/alternatives.html new file mode 100644 index 0000000..fa5db0c --- /dev/null +++ b/docs/alternatives.html @@ -0,0 +1,657 @@ + + + + + + +ProGuard Alternatives + + + +

Alternatives

+ +There are quite a few Java class file shrinkers, optimizers, obfuscators, and +preverifiers out there. Users of ProGuard tell me it easily compares +with the best of them. However, you may want to check that out yourself. +

+This is a list of the programs of which I'm aware. Obviously, I've never +personally tested all of them. Many programs, even commercial ones, have been +abandoned. Please drop me a note if you know of any other shrinkers, +optimizers, obfuscators, or preverifiers, or if some information provided +below is incorrect. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Author/CompanyProgramShrink.Optim.Obfusc.Preverif.License
Eric LafortuneProGuardxxxxFree (GPL)
Jochen HoenickeJodexxx
Free (GPL)
NQ4Jogaxxx
Free (no source)
Nate NystromBloatxx

Free
Hidetoshi OhuchiJargx
x
Free (BSD)
Alexander ShvetsCafeBabex
x
Free
yWorksyGuardx
x
Free (no source)
Christian GrothoffJamitx


Free (GPL)
MojoMinijarx


Free (Apache)
RiggsHill SoftwareGenJarx


Free (Apache)
ApacheAnt Classfilesetx


Free (Apache)
Romain GuyHarvesterx


Free (BSD)
Emeric VernatDCDx


Free (LGPL)
Cristiano SadunPackx


Free (LGPL)
Brian AllietGcclassx


Free (LGPL)
SableSoot
x

Free (LGPL)
Konstantin KnizhnikJavaGO
x

Free
Haruaki TamadaDonQuixote
xx
Free
SableJBCO

x
Free (LGPL)
Thorsten HeitJavaGuard

x
Free (LGPL)
Patrick MuellerMwobfu

x
Free (GPL)
Elegant SoftwareJMangle

x
Free
BebboSoftBb_mug

x
Free (no source)
Dr. JavaMarvin Obfuscator

x
Free (no source)
IBMWSDDxxx
Commercial
PreEmptiveDashOProxxx
Commercial
ZelixKlassMasterxxx
Commercial
S5 SystemsjPrestoxxx
Commercial
Sophia CradleSophiaCompressxxx
Commercial
RetroLogicRetroGuardx
x
Commercial
CodingArtCodeShieldx
x
Commercial
Eastridge TechnologyJshrinkx
x
Commercial
HelsethJObfuscatorx
x
Commercial
LeeSoftwareSmokescreen Obfuscatorx
x
Commercial
Vega TechnologiesJZipperx
x
Commercial
InnaworksmBoosterxx
xCommercial
Sergey SverdlovJ.Class Optimizerxx

Commercial
SmardecAllatori
xx
Commercial
U. of ArizonaSandMark
xx
Commercial
Force 5JCloak

x
Commercial
Semantic DesignsObfuscator

x
Commercial
DuckwareJobfuscate

x
Commercial
JProofJProof

x
Commercial
GITSBlurfuscator

x
Commercial
ChainKeyJava Code Protector

x
Commercial
Alain MoranflmObf

x
Free (BSD)
Vasile CalmatuiVasObfuLite

x
Free
IBM AlphaWorksJAXxxx
(discontinued)
Markus JansenJoptxxx
(disappeared?)
Eron JokipiiJobe

x
(disappeared?)
JRCDeCaf

x
(disappeared?)
BajieJCMP
xx
(disappeared?)
Plumb DesignCondensityx
x
Commercial (discontinued)
4th PassSourceGuardx
x
Commercial (discontinued?)
Software4jObfuscate4j

x
Commercial (discontinued?)
JAMM ConsultingObfuscatePro

x
Commercial (discontinued?)
JDevelopJSCO

x
Commercial (discontinued?)
4FangJMix

x
Commercial (discontinued?)
2LKit2LKit Obfuscator

x
Commercial (disappeared?)
WingSoftWingGuard

x
Commercial (disappeared?)
HashJavaHashJava

x
Commercial (disappeared?)
+

+All trademarks are property of their respective holders. + +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/checkmark.gif b/docs/checkmark.gif new file mode 100644 index 0000000000000000000000000000000000000000..8afa67739ab88e0445ffcf6b783d752607189af2 GIT binary patch literal 63 zcmZ?wbhEHb + + + + + +ProGuard Downloads + + + +

Downloads

+ +ProGuard is distributed under the terms of the GNU General Public +License. Please consult the license page for more +details. +

+ProGuard is written in Java, so it requires a Java Runtime Environment + (JRE 1.4 or higher). +

+You can download the latest release (containing the program jar, the +documentation you're reading now, examples, and the source code) from this +location: +

+

Download section (at SourceForge)
+

+ +If you're still working with an older version of ProGuard, check out +the summary of changes below, to see if you're missing something essential. +Better look at the up-to-date on-line version if +you're reading a local copy of this page. +

+The download section may also contain updates with sub-minor version numbers. +These versions are typically released shortly after their parent versions, for +applying emergency fixes. Please make sure to look at those if you are +encountering any problems with recent releases. +

+Finally, there may be beta versions of upcoming releases. They may be of +interest too, because they typically contain any less urgent bug fixes +collected since the previous release. +

+ +

Jul 2009
Version 4.4

+ + +

Dec 2008
Version 4.3

+ + +

Mar 2008
Version 4.2

+ + +

Dec 2007
Version 4.1

+ + +

Sep 2007
Version 4.0

+ +Upgrade considerations: + + +

Dec 2007
Version 3.11

+ + +

Aug 2007
Version 3.10

+ + +

Jun 2007
Version 3.9

+ + +

Mar 2007
Version 3.8

+ + +

Dec 2006
Version 3.7

+ + +

May 2006
Version 3.6

+ + +

Jan 2006
Version 3.5

+ + +

Oct 2005
Version 3.4

+ + +

Jun 2005
Version 3.3

+ + +

Dec 2004
Version 3.2

+ + +

Nov 2004
Version 3.1

+ + +

Aug 2004
Version 3.0

+ + +

Mar 2004
Version 2.1

+ + +

Dec 2003
Version 2.0

+ + +

Aug 2003
Version 1.7

+ + +

May 2003
Version 1.6

+ + +

Jan 2003
Version 1.5

+ + +

Nov 2002
Version 1.4

+ + +

Sep 2002
Version 1.3

+ + +

Aug 2002
Version 1.2

+ + +

Jul 2002
Version 1.1

+ + +

Jun 2002
Version 1.0

+ + +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/drop1.gif b/docs/drop1.gif new file mode 100644 index 0000000000000000000000000000000000000000..426d8564123ebdfa0ff1cc6cce776cfc938cebb3 GIT binary patch literal 803 zcmZ?wbh9u|oWRJzaEyUr?b@}=moHzsbm`o=bEi+AK6UEU-rnBM&d$ch#@gE2%F4>} z^77Ks(trQ{{rU6f*RNkce*F0M?c0|xUp{^M^x?yYckkZ4dGqGgt5?sSJ$v%x$)iV) zZr!?d(|epKY#rA@%{VvFJHcV{`~pVr%xY0e*Ey^!@GCy-oAbN z=FOW|uU@@;`SRJbXOAC0e)#a=g9i`p-@kwF-n~0_?%ce2Gs92=Iv@vw;(~$wUxS#r zjlH5OD?0}#7q?a)&xDDSCQq3$P>&)zuN3v+kbSy88P1gu`_PuM*wa#dMVp zOh`;*>y_%1%sDZ2^}=;`cUOFVb@%l4_4oHTFmucK?AY+|aEGvV+?gF4lX;7CQ&wy| zbdZ@tP{pUi(Xs9Mc~PfsIp1AdUS3`iygKgeuC1@HZ%95p&v*B>x3_l`zh3v@rg1Bq zww8UyMW&|i$0uT4BF^pE`T6;U#oqJ%_U`)n`o`w$`{(xV{{H^K;cj_N8yOg^ E0oW#P7ytkO literal 0 HcmV?d00001 diff --git a/docs/drop2.gif b/docs/drop2.gif new file mode 100644 index 0000000000000000000000000000000000000000..b6075421d8333ffca319124594b8042af52ba26f GIT binary patch literal 620 zcmZ?wbh9u|^Xu2IA3uJ4`}Xb2moJ|_efsd>!@GCy-n@D9>eZ`f&z?Pb^5oH@M|bYr zxpnK-wQJX|T)A@T(xo$J&Kx*!VBfxdn>KA)wQALh6)To4TefJ?qDhk`O_(sDudlDB zrlzc{?C;;dzkmP!`Sa)Z@87?E{rdUy=Z_yhzJLGz<;#~(pFVy3`0>Ms4{zVTee>qc z%a<>oJ$v@}@#BXNA3k{S;Qsyl_wL=hbLY;@n>RBIO`rpEHYhF_*e^DS8XF4e>FV&9 zi;Ef==<(`USxAZ*3GnIIT3ecl8uIHZDOgL38yoPcDcM??iwf$osyfO`nF#T-GdtN> ziW}*3urS!lm{PpwuzxO}>3QJswJ6Ol^QuR)HK%#RShdfh>#KuPso!sh9don&M z9PgKN4q~wkdg3-&DmX2sb7Si9Ne2GMY^J}H^R2zLeaJn&mKK` zbnDiw8#iuj+O%oWqDBAz|Nr~<@9*EgfByXW_3PKqpFe;6`0@Sw_YWUFynXxj<;$1P zo;`c`@ZtUY_cOqN4u}D=i-FZ-!R4Hrr6NIxGrg014=po1mBJ;m=YBnnB*pDvHYrNVPLQZ0I0BJ<^TWy literal 0 HcmV?d00001 diff --git a/docs/favicon.ico b/docs/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..3923ec14ef4a57a612bc398a3569c26f7904397f GIT binary patch literal 7406 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 + + + + + + +ProGuard Feedback + + + +

Feedback

+ +By now, I've invested a fair amount of time in ProGuard. You can help +by providing feedback! If you have problems, bugs, bug fixes, ideas, +encouragements, etc., please let me know: +

+

    +
  • The help forum (at SourceForge) is the right place to ask + questions about any problems you might have configuring and running + ProGuard. +

    + +

  • The open discussion forum (at SourceForge) offers a place + to share your thoughts and discuss new ideas. +

    + +

  • The bug tracking page (at SourceForge) allows you to submit + and consult bug reports. Please make sure the reports are complete and + concise. If I can't reproduce the problem, I most likely can't fix it + either. +

    + +

  • The feature request page (at SourceForge) allows you to + submit and consult feature requests. I generally have my own road map in + mind, but this is the place express your interest in new and existing + ideas. +

    + +

  • The download section at SourceForge and the project page at FreshMeat offer the possibility to + subscribe to the announcements of new releases. They are the most + efficient way to stay abreast of the latest developments. +

    + +

  • For anything that doesn't fall in the above categories, you can mail me + directly at + + + +. +
+

+I can't promise a swift answer, or any answer at all, for that matter, but I +like seeing any constructive comments. +

+ +ProGuard isn't a typical open source project, in the sense that I am +not looking for code contributions. Developing on my own allows me to +do things my way, without the overhead and compromises associated with larger +projects. + +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..771bb6a --- /dev/null +++ b/docs/index.html @@ -0,0 +1,72 @@ + + + + + + + + + + + +ProGuard + + + + + + + + + + + + + + + +<body> +<p class="intro"> +<b>ProGuard</b> is a free Java class file shrinker, optimizer, and obfuscator. +It can detect and remove unused classes, fields, methods, and attributes. It +can then optimize bytecode and remove unused instructions. Finally, it can +rename the remaining classes, fields, and methods using short meaningless +names. The resulting jars are smaller and harder to reverse-engineer. +</p> +<p> +Your browser doesn't support frames, but that's cool. +<p> +You can go straight to the <a href="main.html">main page</a>. + +<hr> +<address> +Copyright &copy; 2002-2009 +<a href="http://www.graphics.cornell.edu/~eric/">Eric Lafortune</a>. +</address> +</body> + + diff --git a/docs/license.html b/docs/license.html new file mode 100644 index 0000000..b4654fd --- /dev/null +++ b/docs/license.html @@ -0,0 +1,47 @@ + + + + + + +ProGuard License + + + +

License

+ +ProGuard is free. You can use it freely for processing your +applications, commercial or not. Your code obviously remains yours after +having been processed, and its license can remain the same. +

+ +ProGuard itself is copyrighted, but its distribution license provides +you with some rights for modifying and redistributing its code and its +documentation. More specifically, ProGuard is distributed under the +terms of the GNU General Public License (GPL), version +2, as published by the Free +Software Foundation (FSF). In short, this means that you may freely +redistribute the program, modified or as is, on the condition that you make +the complete source code available as well. If you develop a program that is +linked with +ProGuard, the program as a whole has to be distributed at no charge +under the GPL. I am granting a special +exception to the latter clause (in wording suggested by +the FSF), for combinations with the following stand-alone +applications: Apache Ant, Apache Maven, the Eclipse ProGuardDT GUI, the +EclipseME JME IDE, the Sun NetBeans Java IDE, the Sun JME Wireless Toolkit, +and the Javaground Tools. + +

+The ProGuard user documentation represents an important part of this +work. It may only be redistributed without changes, along with the unmodified +version of the code. + +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/luciadlogo.png b/docs/luciadlogo.png new file mode 100644 index 0000000000000000000000000000000000000000..0147ce363bc4901548afcc0972607472061d0a91 GIT binary patch literal 2356 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 literal 0 HcmV?d00001 diff --git a/docs/main.html b/docs/main.html new file mode 100644 index 0000000..e988c79 --- /dev/null +++ b/docs/main.html @@ -0,0 +1,92 @@ + + + + + + + + + +ProGuard Main + + + +

Main

+ +

+ProGuard is a free Java class file shrinker, optimizer, obfuscator, and +preverifier. It detects and removes unused classes, fields, methods, and +attributes. It optimizes bytecode and removes unused instructions. It renames +the remaining classes, fields, and methods using short meaningless names. +Finally, it preverifies the processed code for Java 6 or for Java Micro +Edition. +

+Some uses of ProGuard are: +
    + +
  • Creating more compact code, for smaller code archives, faster transfer + across networks, faster loading, and smaller memory footprints. + +
  • Making programs and libraries harder to reverse-engineer. + +
  • Listing dead code, so it can be removed from the source code. + +
  • Retargeting and preverifying existing class files for Java 6, to take full + advantage of Java 6's faster class loading. + +
+

+ProGuard's main advantage compared to other Java obfuscators is +probably its compact template-based configuration. A few intuitive command +line options or a simple configuration file are usually sufficient. For +instance, the following configuration option preserves all applets in a jar: +

+    -keep public class * extends java.applet.Applet
+
+The user manual explains all available options and shows more examples of this +powerful configuration style. +

+ProGuard is fast. It only takes seconds to process programs and +libraries of several megabytes. The results section presents actual figures +for a number of applications. +

+ProGuard is a command-line tool with an optional graphical user +interface. It also comes with plugins for Ant and for the JME Wireless +Toolkit. +

+

+Version 4.0 introduced preverification and more bytecode optimizations. Please +report any problems, so they can be fixed soon. +

+The following sections provide more detailed information: +
    +
  • Main: this overview page. +
  • Results: some results obtained with + ProGuard, including timings and memory usage. +
  • FAQ: answers to some Frequently Asked Questions. +
  • Manual: the complete ProGuard user + manual, with examples and troubleshooting tips. +
  • Quality: a discussion of the (excellent) quality + of ProGuard's code. +
  • Screenshots: some impressions of what ProGuard looks like. +
  • Testimonials: what users think of + ProGuard. +
  • License: ProGuard is free, under a GPL + license. +
  • Downloads: download the ProGuard + package yourself. +
  • Feedback: tell me about your experiences, or + learn from others on our forums. +
  • Acknowledgements: people who have been + helpful. +
  • Alternatives: other Java obfuscators, + optimizers, and shrinkers. +
+ +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/ant.html b/docs/manual/ant.html new file mode 100644 index 0000000..bc3a3b4 --- /dev/null +++ b/docs/manual/ant.html @@ -0,0 +1,610 @@ + + + + + + +Ant Task + + + +

Ant Task

+ +ProGuard can be run as a task in the Java-based build tool Ant (version +1.6.0 or higher). +

+ +Before you can use the proguard task, you have to tell Ant about +this new task. The easiest way is to add the following line to your +build.xml file: +

+ +

+<taskdef resource="proguard/ant/task.properties"
+         classpath="/usr/local/java/proguard/lib/proguard.jar" />
+
+

+ +Please make sure the class path is set correctly for your system. +

+ +There are three ways to configure the ProGuard task: using an external +configuration file, using embedded ProGuard configuration options, or using +the equivalent XML configuration tags. These three ways can be combined, +depending on practical circumstances and personal preference. +

+ +

1. An external ProGuard configuration file

+ +The simplest way to use the ProGuard task in an Ant build file is to keep your +ProGuard configuration file, and include it from Ant. You can include your +ProGuard configuration file by setting +the configuration +attribute of your +proguard task. Your ant build file will then look like this: +

+ +

+<taskdef resource="proguard/ant/task.properties"
+         classpath="/usr/local/java/proguard/lib/proguard.jar" />
+<proguard configuration="myconfigfile.pro"/>
+
+

+ +This is a convenient option if you prefer ProGuard's configuration style over +XML, if you want to keep your build file small, or if you have to share your +configuration with developers who don't use Ant. +

+ +

2. Embedded ProGuard configuration options

+ +Instead of keeping an external ProGuard configuration file, you can also copy +the contents of the file into the nested text of the proguard task +(the PCDATA area). Your Ant build file will then look like this: +

+ +

+<taskdef resource="proguard/ant/task.properties"
+         classpath="/usr/local/java/proguard/lib/proguard.jar" />
+<proguard>
+  -libraryjars ${java.home}/lib/rt.jar
+  -injars      in.jar
+  -outjars     out.jar
+
+  -keepclasseswithmembers public class * {
+      public static void main(java.lang.String[]);
+  }
+</proguard>
+
+

+ +Some minor syntactical changes are required in order to conform with the XML +standard. +

+ +Firstly, the # character cannot be used for comments in an XML +file. Comments must be enclosed by an opening <!-- and a +closing -->. All occurrences of the # character +can be removed. +

+ +Secondly, the use of < and > characters would +upset the structure of the XML build file. Environment variables are now +enclosed by an opening ${ and a closing }. This +syntax also allows you to use Ant properties within the ProGuard +configuration. Other occurrences of < and > +have to be encoded as &lt; and &gt;. +

+ +

3. XML configuration tags

+ +If you really prefer a full-blown XML configuration, you can replace the +ProGuard configuration options by XML configuration tags. The resulting +configuration will be equivalent, but much more verbose and difficult to read, +as XML goes. The remainder of this page presents the supported tags. For a +more extensive discussion of their meaning, please consult the traditional Usage section. You can find some sample configuration +files in the examples/ant directory of the ProGuard distribution. +

+ +  +

Task Attributes and Nested Elements

+ +The <proguard> task and the +<proguardconfiguration> task can have the following +attributes (only for <proguard>) and nested +elements: + +
+ +
configuration + = "filename"
+
Read and merge options from the given ProGuard-style configuration + file. Note: for reading XML-style configurations, use the configuration + element.
+ +
skipnonpubliclibraryclasses + = "boolean" + (default = true)
+
Ignore non-public library classes.
+ +
skipnonpubliclibraryclassmembers + = "boolean" + (default = true)
+
Ignore package visible library class members.
+ +
target + = "version" + (default = none)
+
Set the given version number in the processed classes.
+ +
forceprocessing + = "boolean" + (default = false)
+
Process the input, even if the output seems up to date.
+ +
printseeds + = "boolean or filename" + (default = false)
+
List classes and class members matched by the various keep + commands, to the standard output or to the given file.
+ +
shrink + = "boolean" + (default = true)
+
Shrink the input class files.
+ +
printusage + = "boolean or filename" + (default = false)
+
List dead code of the input class files, to the standard output or to the + given file.
+ +
optimize + = "boolean" + (default = true)
+
Optimize the input class files.
+ +
optimizationpasses + = "n" + (default = 1)
+
The number of optimization passes to be performed.
+ +
allowaccessmodification + = "boolean" + (default = false)
+
Allow the access modifiers of classes and class members to be modified, + while optimizing.
+ +
mergeinterfacesaggressively + = "boolean" + (default = false)
+
Allow any interfaces to be merged, while optimizing.
+ +
obfuscate + = "boolean" + (default = true)
+
Obfuscate the input class files.
+ +
printmapping + = "boolean or filename" + (default = false)
+
Print the mapping from old names to new names for classes and class members + that have been renamed, to the standard output or to the given file.
+ +
applymapping + = "filename" + (default = none)
+
Reuse the given mapping, for incremental obfuscation.
+ +
obfuscationdictionary + = "filename" + (default = none)
+
Use the words in the given text file as obfuscated field names and method + names.
+ +
classobfuscationdictionary + = "filename" + (default = none)
+
Use the words in the given text file as obfuscated class names.
+ +
packageobfuscationdictionary + = "filename" + (default = none)
+
Use the words in the given text file as obfuscated package names.
+ +
overloadaggressively + = "boolean" + (default = false)
+
Apply aggressive overloading while obfuscating.
+ +
useuniqueclassmembernames + = "boolean" + (default = false)
+
Ensure uniform obfuscated class member names for subsequent incremental + obfuscation.
+ +
usemixedcaseclassnames + = "boolean" + (default = true)
+
Generate mixed-case class names while obfuscating.
+ +
flattenpackagehierarchy + = "package_name" + (default = none)
+
Repackage all packages that are renamed into the single given parent + package.
+ +
repackageclasses + = "package_name" + (default = none)
+
Repackage all class files that are renamed into the single given + package.
+ +
renamesourcefileattribute + = "string" + (default = none)
+
Put the given constant string in the SourceFile + attributes.
+ +
preverify + = "boolean" + (default = true)
+
Preverify the processed class files if they are targeted at Java Micro + Edition or at Java 6 or higher.
+ +
microedition + = "boolean" + (default = false)
+
Targets the processed class files at Java Micro Edition.
+ +
verbose + = "boolean" + (default = false)
+
Write out some more information during processing.
+ +
note + = "boolean" + (default = true)
+
Print notes about potential mistakes or omissions in the configuration. + Use the nested element dontnote for more + fine-grained control.
+ +
warn + = "boolean" + (default = true)
+
Print warnings about unresolved references. Use the nested + element dontwarn for more fine-grained + control. Only use this option if you know what you're doing!
+ +
ignorewarnings + = "boolean" + (default = false)
+
Print warnings about unresolved references, but continue processing + anyhow. Only use this option if you know what you're doing!
+ +
printconfiguration + = "boolean or filename" + (default = false)
+
Write out the entire configuration in traditional ProGuard style, to the + standard output or to the given file. Useful to replace unreadable + XML configurations.
+ +
dump + = "boolean or filename" + (default = false)
+
Write out the internal structure of the processed class files, to the + standard output or to the given file.
+ +
<injar + class_path + />
+
Specifies the program jars (or wars, ears, zips, or directories).
+ +
<outjar + class_path + />
+
Specifies the name of the output jars (or wars, ears, zips, or + directories).
+ +
<libraryjar + class_path + />
+
Specifies the library jars (or wars, ears, zips, or directories).
+ +
<keepdirectory name = "directory_name" + />
+ <keepdirectories filter = "directory_filter" + />
+
Keep the specified directories in the output jars (or wars, ears, zips, or + directories).
+ +
<keep + modifiers + class_specification + > + class_member_specifications + </keep>
+
Preserve the specified classes and class members.
+ +
<keepclassmembers + modifiers + class_specification + > + class_member_specifications + </keepclassmembers>
+
Preserve the specified class members, if their classes are preserved as + well.
+ +
<keepclasseswithmembers + modifiers + class_specification + > + class_member_specifications + </keepclasseswithmembers>
+
Preserve the specified classes and class members, if all of the + specified class members are present.
+ +
<keepnames + class_specification + > + class_member_specifications + </keepnames>
+
Preserve the names of the specified classes and class members (if + they aren't removed in the shrinking step).
+ +
<keepclassmembernames + class_specification + > + class_member_specifications + </keepclassmembernames>
+
Preserve the names of the specified class members (if they aren't removed + in the shrinking step).
+ +
<keepclasseswithmembernames + class_specification + > + class_member_specifications + </keepclasseswithmembernames>
+
Preserve the names of the specified classes and class members, if + all of the specified class members are present (after the shrinking + step).
+ +
<whyareyoukeeping + class_specification + > + class_member_specifications + </whyareyoukeeping>
+
Print details on why the given classes and class members are being kept in + the shrinking step.
+ +
<assumenosideeffects + class_specification + > + class_member_specifications + </assumenosideeffects>
+
Assume that the specified methods don't have any side effects, while + optimizing. Only use this option if you know what you're + doing!
+ +
<optimization name = "optimization_name" + />
+ <optimizations filter = ""optimization_filter" + />
+
Perform only the specified optimizations.
+ +
<keeppackagename name = "package_name" + />
+ <keeppackagenames filter = "package_filter" + />
+
Keep the specified package names from being obfuscated. If no name is + given, all package names are preserved.
+ +
<keepattribute name = "attribute_name" + />
+ <keepattributes filter = "attribute_filter" + />
+
Preserve the specified optional Java bytecode attributes, with optional + wildcards. If no name is given, all attributes are preserved.
+ +
<adaptclassstrings filter = "class_filter" + />
+
Adapt string constants in the specified classes, based on the obfuscated + names of any corresponding classes.
+ +
<adaptresourcefilenames filter = "file_filter" + />
+
Rename the specified resource files, based on the obfuscated names of the + corresponding class files.
+ +
<adaptresourcefilecontents filter = "file_filter" + />
+
Update the contents of the specified resource files, based on the + obfuscated names of the processed classes.
+ +
+ <dontnote filter = "class_filter" + />
+
Don't print notes about classes matching the specified class name + filter.
+ +
+ <dontwarn filter = "class_filter" + />
+
Don't print warnings about classes matching the specified class name + filter. Only use this option if you know what you're doing!
+ +
<configuration refid = "ref_id" + />
+
Includes the configuration specified in the + <proguardconfiguration> task (or + <proguard> task) with the attribute id = + "ref_id". Note that only the nested elements of this configuration + are considered, not the attributes. Also note: for reading ProGuard-style + configuration files, use the configuration + attribute.
+ +
+ +  +

Class Path Attributes and Nested Elements

+ +The jar tags are path tags, so they can have any of the path attributes (or +nested elements). The most common attributes are: + +
+ +
path = "path"
+
The names of the jars (or wars, ears, zips, or directories), separated by + the path separator.
+ +
location = "name" (or file + = "name", or dir = "name", or + name = "name")
+
Alternatively, the name of a single jar (or war, ear, zip, or + directory).
+ +
refid = "ref_id"
+
Alternatively, a reference to the path or file set with the attribute + id = "ref_id".
+ +
+ +In addition, the jar tags can have ProGuard-style filter attributes: + +
+ +
filter = + "file_filter"
+
An optional filter for all class file names and resource file names that + are encountered.
+ +
jarfilter = + "file_filter"
+
An optional filter for all jar names that are encountered.
+ +
warfilter = + "file_filter"
+
An optional filter for all war names that are encountered.
+ +
earfilter = + "file_filter"
+
An optional filter for all ear names that are encountered.
+ +
zipfilter = + "file_filter"
+
An optional filter for all zip names that are encountered.
+ +
+ +  +

Keep Modifier Attributes

+ +The keep tags can have the following modifier attributes: + +
+ +
allowshrinking + = "boolean" + (default = false)
+
Specifies whether the entry points specified in the keep tag may be + shrunk.
+ +
allowoptimization + = "boolean" + (default = false)
+
Specifies whether the entry points specified in the keep tag may be + optimized.
+ +
allowobfuscation + = "boolean" + (default = false)
+
Specifies whether the entry points specified in the keep tag may be + obfuscated.
+ +
+ +  +

Class Specification Attributes and Nested Elements

+ +The keep tags can have the following class_specification attributes and +class_member_specifications nested elements: + +
+ +
access = "access_modifiers"
+
The optional access modifiers of the class. Any space-separated list of + "public", "final", and "abstract", with optional negators "!".
+ +
type = "type"
+
The optional type of the class: one of "class", "interface", or + "!interface".
+ +
name = "class_name"
+
The optional fully qualified name of the class, with optional + wildcards.
+ +
extends = "class_name"
+
The optional fully qualified name of the class the specified classes + must extend, with optional wildcards.
+ +
implements = "class_name"
+
The optional fully qualified name of the class the specified classes + must implement, with optional wildcards.
+ +
<field + class_member_specification + />
+
Specifies a field.
+ +
<method + class_member_specification + />
+
Specifies a method.
+ +
<constructor + class_member_specification + />
+
Specifies a constructor.
+ +
+ +  +

Class Member Specification Attributes

+ +The class member tags can have the following class_member_specification +attributes: + +
+ +
access = "access_modifiers"
+
The optional access modifiers of the class. Any space-separated list of + "public", "protected", "private", "static", etc., with optional negators + "!".
+ +
type = "type"
+
The optional fully qualified type of the class member, with optional + wildcards. Not applicable for constructors, but required for methods for + which the parameters attribute is specified.
+ +
name = "name"
+
The optional name of the class member, with optional wildcards. Not + applicable for constructors.
+ +
parameters = "parameters"
+
The optional comma-separated list of fully qualified method parameters, + with optional wildcards. Not applicable for fields, but required for + constructors, and for methods for which the type attribute is + specified.
+ +
+ +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/attention.gif b/docs/manual/attention.gif new file mode 100644 index 0000000000000000000000000000000000000000..1a0c712d60e41120fa963b4cf988a54f21a69e27 GIT binary patch literal 896 zcmZ?wbhEHbbYO5`IOfK{z`(%B$iT$Jz|73R#>T+T&cMmZz|GCT%geye&mbhkASK11 ztjwUN$6#c{U~bM}ZOvd~!(eaE;OWWW>&p-x&JYp75F5)7AJ34S%#f18ke<$vk-?Ci z&5)DBkekbppU+TGz))7k(A31x+|1D0%FxxtFliFQlqn2z<}fT;#ISfV!_uV;n>I0Q z-psIV8^gYR36T^=m3_pJ|{QAZ4=MTf*zYPEWG5r5Ol#t?27Dg_HdIlX(On~Bqf&E`YeN%Hw zYg>CqXIFPmZ(sj}iIXNznL2IyjG41$&zU=K{(^;z7B5-4Z25|nO$=*ROIUH^tH zn|ilw+}5>Y>#mMHJNLC7*n4R8k)wz9$m}^*zem_j`0S}IES7GTEIY1lQF42rbY;^X zZuN*#Jp!&D+*}1dFWbRv_T#`!i37T#>vuSL-zQ3W;|p)GL>x&;>`ILC;6a9tqEG>>)a z%mUdPjs8q)`9GA&Z1~w3-q|3TG50_?Q-*3BPXo&xj%+qN1)ep2kFF{y@wo+;?IY7_5y_*h%R=7891~m<;}&wgY~t>o z2O%3SHAdb`+P>pWq8U^3RQ@x+wEi#pn!jbDqPe_V9k08^1gt1H{PobSX@#~W zyv_`(S!~?=Lu_9t%e%>Rf zWLmJp{8O;4;zF0_ugw=-`DYmA|8{$P=r_h>Mm7$$6%U$t%w8z4eO=jprbQ&o + + + + + +ProGuard Examples + + + +

Examples

+ +Some typical useful configurations: +
    +
  1. A typical application +
  2. A typical applet +
  3. A typical midlet +
  4. A typical Java Card applet +
  5. A typical xlet +
  6. A typical Android application +
  7. A typical library +
  8. All possible applications in the input jars +
  9. All possible applets in the input jars +
  10. All possible midlets in the input jars +
  11. All possible Java Card applets in the input jars +
  12. All possible xlets in the input jars +
  13. All possible Android applications in the input jars +
  14. All possible servlets in the input jars +
  15. Processing native methods +
  16. Processing callback methods +
  17. Processing enumeration classes +
  18. Processing serializable classes +
  19. Processing bean classes +
  20. Processing annotations +
  21. Processing database drivers +
  22. Processing ComponentUI classes +
  23. Processing RMI code +
  24. Processing resource files +
  25. Producing useful obfuscated stack traces +
  26. Obfuscating package names +
  27. Restructuring the output archives +
  28. Filtering the input and the output +
  29. Processing multiple applications at once +
  30. Incremental obfuscation +
  31. Preverifying class files for Java Micro Edition +
  32. Upgrading class files to Java 6 +
  33. Finding dead code +
  34. Printing out the internal structure of class files +
  35. Using annotations to configure ProGuard +
+ +You can find some sample configuration files in the examples +directory of the ProGuard distribution. + +  +

A typical application

+To shrink, optimize, and obfuscate the ProGuard application itself, one would +typically create a configuration file proguard.pro and then type: +
+java -jar proguard.jar @proguard.pro
+
+

+The configuration file would contain the following options: +

+-injars       proguard.jar
+-outjars      proguard_out.jar
+-libraryjars  <java.home>/lib/rt.jar
+-printmapping proguard.map
+
+-keep public class proguard.ProGuard {
+    public static void main(java.lang.String[]);
+}
+
+

+Note the use of the <java.home> system property; it is +replaced automatically. +

+Also note that all type names are fully specified: +proguard.ProGuard and java.lang.String[]. +

+The access modifiers public and static are not +really required in this case, since we know a priori that the specified class +and method have the proper access flags. It just looks more familiar this way. +

+We're writing out an obfuscation mapping file with -printmapping, for +de-obfuscating any stack traces later on, or for incremental obfuscation of +extensions. +

+We can further improve the results with a few additional options: +

+-optimizationpasses 3
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+
+These options are not required; they just shave off some extra bytes from the +output jar, by performing up to 3 optimization passes, and by aggressively +obfuscating class members and package names. +

+In general, you might need a few additional options for processing native methods, callback methods, +enumerations, serializable +classes, bean classes, annotations, and resource +files. For processing 'simple' applications like ProGuard, that is not +required. + +  +

A typical applet

+These options shrink, optimize, and obfuscate the applet +mypackage.MyApplet: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars <java.home>/lib/rt.jar
+
+-keep public class mypackage.MyApplet
+
+

+The typical applet methods will be preserved automatically, since +mypackage.MyApplet is an extension of the Applet +class in the library rt.jar. +

+If applicable, you should add options for processing native +methods, callback methods, enumerations, serializable +classes, bean classes, annotations, and resource +files. + +  +

A typical midlet

+These options shrink, optimize, obfuscate, and preverify the midlet +mypackage.MyMIDlet: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/wtk2.1/lib/midpapi20.jar
+-libraryjars /usr/local/java/wtk2.1/lib/cldcapi11.jar
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+-microedition
+
+-keep public class mypackage.MyMIDlet
+
+

+Note how we're now targeting the Java Micro Edition run-time environment of +midpapi20.jar and cldcapi11.jar, instead of the Java +Standard Edition run-time environment rt.jar. You can target +other JME environments by picking the appropriate jars. +

+The typical midlet methods will be preserved automatically, since +mypackage.MyMIDlet is an extension of the MIDlet +class in the library midpapi20.jar. +

+The -microedition option +makes sure the class files are preverified for Java Micro Edition, producing +compact StackMap attributes. It is no longer necessary to run an +external preverifier. +

+Be careful if you do use the external preverify tool on a platform +with a case-insensitive filing system, such as Windows. Because this tool +unpacks your processed jars, you should then use ProGuard's -dontusemixedcaseclassnames +option. +

+If applicable, you should add options for processing native +methods and resource files. +

+Note that you will still have to adapt the midlet jar size in the +corresponding jad file; ProGuard doesn't do that for you. + +  +

A typical Java Card applet

+These options shrink, optimize, and obfuscate the Java Card applet +mypackage.MyApplet: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/javacard2.2.2/lib/api.jar
+-dontwarn    java.lang.Class
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+
+-keep public class mypackage.MyApplet
+
+

+The configuration is very similar to the configuration for midlets, except that +it now targets the Java Card run-time environment. This environment doesn't +have java.lang.Class, so we're telling ProGuard not to worry about it. + +  +

A typical xlet

+These options shrink, optimize, and obfuscate the xlet +mypackage.MyXlet: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/jtv1.1/javatv.jar
+-libraryjars /usr/local/java/cdc1.1/lib/cdc.jar
+-libraryjars /usr/local/java/cdc1.1/lib/btclasses.zip
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+
+-keep public class mypackage.MyXlet
+
+

+The configuration is very similar to the configuration for midlets, except that +it now targets the CDC run-time environment with the Java TV API. + +  +

A typical Android application

+These options shrink, optimize, and obfuscate the simple Android application +based on a single activity mypackage.MyActivity: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/android-1.5_r1/platforms/android-1.5/android.jar
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+-optimizations !code/simplification/arithmetic
+
+-keep public class mypackage.MyActivity
+
+

+The configuration is very similar to the configuration for midlets, except that +it now targets the Android run-time environment. +

+The -optimizations option +disables some arithmetic simplifications that Dalvik 1.0 and 1.5 can't handle. +

+If applicable, you should add options for processing native +methods, callback methods, and resource files. + +  +

A typical library

+These options shrink, optimize, and obfuscate an entire library, keeping all +public and protected classes and class members, native method names, and +serialization code: +
+-injars       in.jar
+-outjars      out.jar
+-libraryjars  <java.home>/lib/rt.jar
+-printmapping out.map
+
+-renamesourcefileattribute SourceFile
+-keepattributes Exceptions,InnerClasses,Signature,Deprecated,
+                SourceFile,LineNumberTable,*Annotation*,EnclosingMethod
+
+-keep public class * {
+    public protected *;
+}
+
+-keepclassmembernames class * {
+    java.lang.Class class$(java.lang.String);
+    java.lang.Class class$(java.lang.String, boolean);
+}
+
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+-keepclassmembers enum * {
+    public static **[] values();
+    public static ** valueOf(java.lang.String);
+}
+
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
+

+This configuration should preserve everything we'll ever want to access in the +library. Only if there are any other non-public classes or methods that are +invoked dynamically, they should be specified using additional -keep options. +

+The -keepclassmembernames +option for the class$ methods is not strictly necessary. These +methods are inserted by the javac compiler and the +jikes compiler respectively, to implement the .class +construct. ProGuard will automatically detect them and deal with them, even +when their names have been obfuscated. However, older versions of ProGuard and +other obfuscators may rely on the original method names. It may therefore be +helpful to preserve them, in case these other obfuscators are ever used for +further obfuscation of the library. +

+The "Exceptions" attribute has to be preserved, so the compiler knows which +exceptions methods may throw. +

+The "InnerClasses" attribute (or more precisely, its source name part) has to +be preserved too, for any inner classes that can be referenced from outside the +library. The javac compiler would be unable to find the inner +classes otherwise. +

+The "Signature" attribute is required to be able to access generic types when +compiling in JDK 5.0 and higher. +

+Finally, we're keeping the "Deprecated" attribute and the attributes for +producing useful stack traces. +

+We've also added some options for for processing native +methods, enumerations, serializable classes, and annotations, which are all discussed in their +respective examples. + +  +

All possible applications in the input jars

+These options shrink, optimize, and obfuscate all public applications in +in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars <java.home>/lib/rt.jar
+-printseeds
+
+-keepclasseswithmembers public class * {
+    public static void main(java.lang.String[]);
+}
+
+

+Note the use of -keepclasseswithmembers. +We don't want to preserve all classes, just all classes that have main +methods, and those methods. +

+The -printseeds option prints +out which classes exactly will be preserved, so we know for sure we're getting +what we want. +

+If applicable, you should add options for processing native +methods, callback methods, enumerations, serializable +classes, bean classes, annotations, and resource +files. + +  +

All possible applets in the input jars

+These options shrink, optimize, and obfuscate all public applets in +in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars <java.home>/lib/rt.jar
+-printseeds
+
+-keep public class * extends java.applet.Applet
+
+

+We're simply keeping all classes that extend the Applet class. +

+Again, the -printseeds option +prints out which applets exactly will be preserved. +

+If applicable, you should add options for processing native +methods, callback methods, enumerations, serializable +classes, bean classes, annotations, and resource +files. + +  +

All possible midlets in the input jars

+These options shrink, optimize, obfuscate, and preverify all public midlets in +in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/wtk2.1/lib/midpapi20.jar
+-libraryjars /usr/local/java/wtk2.1/lib/cldcapi11.jar
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+-microedition
+-printseeds
+
+-keep public class * extends javax.microedition.midlet.MIDlet
+
+

+We're simply keeping all classes that extend the MIDlet class. +

+The -microedition option +makes sure the class files are preverified for Java Micro Edition, producing +compact StackMap attributes. It is no longer necessary to run an +external preverifier. +

+Be careful if you do use the external preverify tool on a platform +with a case-insensitive filing system, such as Windows. Because this tool +unpacks your processed jars, you should then use ProGuard's -dontusemixedcaseclassnames +option. +

+The -printseeds option prints +out which midlets exactly will be preserved. +

+If applicable, you should add options for processing native +methods and resource files. +

+Note that you will still have to adapt the midlet jar size in the +corresponding jad file; ProGuard doesn't do that for you. + +  +

All possible Java Card applets in the input jars

+These options shrink, optimize, and obfuscate all public Java Card applets in +in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/javacard2.2.2/lib/api.jar
+-dontwarn    java.lang.Class
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+-printseeds
+
+-keep public class * implements javacard.framework.Applet
+
+

+We're simply keeping all classes that implement the Applet +interface. +

+The -printseeds option prints +out which applets exactly will be preserved. + +  +

All possible xlets in the input jars

+These options shrink, optimize, and obfuscate all public xlets in +in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/jtv1.1/javatv.jar
+-libraryjars /usr/local/java/cdc1.1/lib/cdc.jar
+-libraryjars /usr/local/java/cdc1.1/lib/btclasses.zip
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+-printseeds
+
+-keep public class * implements javax.tv.xlet.Xlet
+
+

+We're simply keeping all classes that implement the Xlet interface. +

+The -printseeds option prints +out which xlets exactly will be preserved. + +  +

All possible Android applications in the input jars

+These options shrink, optimize, and obfuscate all public activities, services, +broadcast receivers, and content providers in in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/android-1.5_r1/platforms/android-1.5/android.jar
+-overloadaggressively
+-repackageclasses ''
+-allowaccessmodification
+-optimizations !code/simplification/arithmetic
+-printseeds
+
+-keep public class * extends android.app.Activity
+-keep public class * extends android.app.Service
+-keep public class * extends android.content.BroadcastReceiver
+-keep public class * extends android.content.ContentProvider
+
+

+We're keeping all classes that extend the base classes that may be referenced +by the AndroidManifest.xml file of the application. +

+The -printseeds option prints +out which implementations exactly will be preserved. +

+If applicable, you should add options for processing native +methods, callback methods, and resource files. + +  +

All possible servlets in the input jars

+These options shrink, optimize, and obfuscate all public servlets in +in.jar: +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars <java.home>/lib/rt.jar
+-libraryjars /usr/local/java/servlet/servlet.jar
+-printseeds
+
+-keep public class * implements javax.servlet.Servlet
+
+

+Keeping all servlets is very similar to keeping all applets. The servlet API +is not part of the standard run-time jar, so we're specifying it as a library. +Don't forget to use the right path name. +

+We're then keeping all classes that implement the Servlet +interface. We're using the implements keyword because it looks +more familiar in this context, but it is equivalent to extends, +as far as ProGuard is concerned. +

+The -printseeds option prints +out which servlets exactly will be preserved. +

+If applicable, you should add options for processing native +methods, callback methods, enumerations, serializable +classes, bean classes, annotations, and resource +files. + +  +

Processing native methods

+If your application, applet, servlet, library, etc., contains native methods, +you'll want to preserve their names and their classes' names, so they can +still be linked to the native library. The following additional option will +ensure that: +
+-keepclasseswithmembernames class * {
+    native <methods>;
+}
+
+

+Note the use of -keepclasseswithmembernames. +We don't want to preserve all classes or all native methods; we just want to +keep the relevant names from being obfuscated. +

+ProGuard doesn't look at your native code, so it won't automatically preserve +the classes or class members that are invoked by the native code. These are +entry points, which you'll have to specify explicitly. Callback methods are discussed below as a typical example. + +  +

Processing callback methods

+If your application, applet, servlet, library, etc., contains callback +methods, which are called from external code (native code, scripts,...), +you'll want to preserve them, and probably their classes too. They are just +entry points to your code, much like, say, the main method of an application. +If they aren't preserved by other -keep options, something like +the following option will keep the callback class and method: +
+-keep class mypackage.MyCallbackClass {
+    void myCallbackMethod(java.lang.String);
+}
+
+

+This will preserve the given class and method from being removed or renamed. + +  +

Processing enumeration classes

+If your application, applet, servlet, library, etc., contains enumeration +classes, you'll have to preserve some special methods. Enumerations were +introduced in Java 5. The java compiler translates enumerations into classes +with a special structure. Notably, the classes contain implementations of some +static methods that the run-time environment accesses by introspection (Isn't +that just grand? Introspection is the self-modifying code of a new +generation). You have to specify these explicitly, to make sure they aren't +removed or obfuscated: +
+-keepclassmembers enum * {
+    public static **[] values();
+    public static ** valueOf(java.lang.String);
+}
+
+ +  +

Processing serializable classes

+More complex applications, applets, servlets, libraries, etc., may contain +classes that are serialized. Depending on the way in which they are used, they +may require special attention: +
    + +
  • Often, serialization is simply a means of transporting data, without + long-term storage. Classes that are shrunk and obfuscated should then + continue to function fine with the following additional options: + +
    +-keepclassmembers class * implements java.io.Serializable {
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
    +

    + + The -keepclassmembers + option makes sure that any serialization methods are kept. By using this + option instead of the basic -keep option, we're not + forcing preservation of all serializable classes, just preservation + of the listed members of classes that are actually used. +

    + +

  • Sometimes, the serialized data are stored, and read back later into newer + versions of the serializable classes. One then has to take care the classes + remain compatible with their unprocessed versions and with future + processed versions. In such cases, the relevant classes will most likely + have serialVersionUID fields. The following options should + then be sufficient to ensure compatibility over time: + +
    +-keepnames class * implements java.io.Serializable
+
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    static final java.io.ObjectStreamField[] serialPersistentFields;
+    !static !transient <fields>;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
    +

    + + The serialVersionUID and serialPersistentFields + lines makes sure those fields are preserved, if they are present. + The <fields> line preserves all non-static, + non-transient fields, with their original names. The introspection of the + serialization process and the de-serialization process will then find + consistent names. + +

  • Occasionally, the serialized data have to remain compatible, but the + classes involved lack serialVersionUID fields. I imagine the + original code will then be hard to maintain, since the serial version UID + is then computed from a list of features the serializable class. Changing + the class ever so slightly may change the computed serial version UID. The + list of features is specified in the section on Stream + Unique Identifiers of Sun's Java + Object Serialization Specification. The following directives should at + least partially ensure compatibility with the original classes: + +
    +-keepnames class * implements java.io.Serializable
+
+-keepclassmembers class * implements java.io.Serializable {
+    static final long serialVersionUID;
+    static final java.io.ObjectStreamField[] serialPersistentFields;
+    !static !transient <fields>;
+    !private <fields>;
+    !private <methods>;
+    private void writeObject(java.io.ObjectOutputStream);
+    private void readObject(java.io.ObjectInputStream);
+    java.lang.Object writeReplace();
+    java.lang.Object readResolve();
+}
+
    +

    + + The new options force preservation of the elements involved in the UID + computation. In addition, the user will have to manually specify all + interfaces of the serializable classes (using something like "-keep + interface MyInterface"), since these names are also used when + computing the UID. A fast but sub-optimal alternative would be simply + keeping all interfaces with "-keep interface *". + +

+

+ +Note that the above options may preserve more classes and class members +than strictly necessary. For instance, a large number of classes may implement +the Serialization interface, yet only a small number may actually +ever be serialized. Knowing your application and tuning the configuration +often produces more compact results. + +  +

Processing bean classes

+If your application, applet, servlet, library, etc., makes extensive use of +introspection on bean classes to find bean editor classes, or getter and +setter methods, then configuration may become painful. There's not much else +you can do than making sure the bean class names, or the getter and setter +names don't change. For instance: +
+-keep public class mypackage.MyBean {
+    public void setMyProperty(int);
+    public int getMyProperty();
+}
+
+-keep public class mypackage.MyBeanEditor
+
+

+If there are too many elements to list explicitly, wildcards in class names +and method signatures might be helpful. This example should encompasses all +possible setters and getters in classes in the package mybeans: +

+-keep class mybeans.** {
+    void set*(***);
+    void set*(int, ***);
+
+    boolean is*(); 
+    boolean is*(int);
+
+    *** get*();
+    *** get*(int);
+}
+
+

+The '***' wildcard matches any type (primitive or non-primitive, +array or non-array). The methods with the 'int' arguments matches +properties that are lists. + +  +

Processing annotations

+If your application, applet, servlet, library, etc., uses annotations, you may +want to preserve them in the processed output. Annotations are represented by +attributes that have no direct effect on the execution of the code. However, +their values can be retrieved through introspection, allowing developers to +adapt the execution behavior accordingly. By default, ProGuard treats +annotation attributes as optional, and removes them in the obfuscation step. +If they are required, you'll have to specify this explicitly: +
+-keepattributes *Annotation*
+
+

+For brevity, we're specifying a wildcarded attribute name, which will match +RuntimeVisibleAnnotations, +RuntimeInvisibleAnnotations, +RuntimeVisibleParameterAnnotations, +RuntimeInvisibleParameterAnnotations, and +AnnotationDefault. Depending on the purpose of the processed +code, you could refine this selection, for instance not keeping the run-time +invisible annotations (which are only used at compile-time). +

+Some code may make further use of introspection to figure out the enclosing +methods of anonymous inner classes. In that case, the corresponding attribute +has to be preserved as well: +

+-keepattributes EnclosingMethod
+
+ +  +

Processing database drivers

+Database drivers are implementations of the Driver interface. +Since they are often created dynamically, you may want to preserve any +implementations that you are processing as entry points: +
+-keep class * implements java.sql.Driver
+
+

+This option also gets rid of the note that ProGuard prints out about +(java.sql.Driver)Class.forName constructs, if you are +instantiating a driver in your code (without necessarily implementing any +drivers yourself). + +  +

Processing ComponentUI classes

+Swing UI look and feels are implemented as extensions of the +ComponentUI class. For some reason, these have to contain a +static method createUI, which the Swing API invokes using +introspection. You should therefore always preserve the method as an entry +point, for instance like this: +
+-keep class * extends javax.swing.plaf.ComponentUI {
+    public static javax.swing.plaf.ComponentUI createUI(javax.swing.JComponent);
+}
+
+

+This option also keeps the classes themselves. + +  +

Processing RMI code

+Reportedly, the easiest way to handle RMI code is to process the code with +ProGuard first and then invoke the rmic tool. If that is not +possible, you may want to try something like this: +
+-keepattributes Exceptions
+
+-keep interface * extends java.rmi.Remote {
+    <methods>;
+}
+
+-keep class * implements java.rmi.Remote {
+    <init>(java.rmi.activation.ActivationID, java.rmi.MarshalledObject);
+}
+
+

+The first -keep option keeps all your Remote interfaces and their +methods. The second one keeps all the implementations, along with their +particular RMI constructors, if any. +

+The Exceptions attribute has to be kept too, because the RMI +handling code performs introspection to check whether the method signatures +are compatible. + +  +

Processing resource files

+If your application, applet, servlet, library, etc., contains resource files, +it may be necessary to adapt their names and/or their contents when the +application is obfuscated. The following two options can achieve this +automatically: +
+-adaptresourcefilenames    **.properties,**.gif,**.jpg
+-adaptresourcefilecontents **.properties,META-INF/MANIFEST.MF
+
+

+The -adaptresourcefilenames +option in this case renames properties files and image files in the processed +output, based on the obfuscated names of their corresponding class files (if +any). The -adaptresourcefilecontents +option looks for class names in properties files and in the manifest file, and +replaces these names by the obfuscated names (if any). You'll probably want to +adapt the filters to suit your application. + +  +

Producing useful obfuscated stack traces

+These options let obfuscated applications or libraries produce stack traces +that can still be deciphered later on: +
+-printmapping out.map
+
+-renamesourcefileattribute SourceFile
+-keepattributes SourceFile,LineNumberTable
+
+

+We're keeping all source file attributes, but we're replacing their values by +the string "SourceFile". We could use any string. This string is already +present in all class files, so it doesn't take up any extra space. If you're +working with J++, you'll want to keep the "SourceDir" attribute as well. +

+We're also keeping the line number tables of all methods. +

+Whenever both of these attributes are present, the Java run-time environment +will include line number information when printing out exception stack traces. +

+The information will only be useful if we can map the obfuscated names back to +their original names, so we're saving the mapping to a file +out.map. The information can then be used by the ReTrace tool to restore the original stack trace. + +  +

Obfuscating package names

+Package names can be obfuscated in various ways, with increasing levels of +obfuscation and compactness. For example, consider the following classes: +
+mycompany.myapplication.MyMain
+mycompany.myapplication.Foo
+mycompany.myapplication.Bar
+mycompany.myapplication.extra.FirstExtra
+mycompany.myapplication.extra.SecondExtra
+mycompany.util.FirstUtil
+mycompany.util.SecondUtil
+
+

+Let's assume the class name mycompany.myapplication.MyMain is the +main application class that is kept by the configuration. All other class names +can be obfuscated. +

+By default, packages that contain classes that can't be renamed aren't renamed +either, and the package hierarchy is preserved. This results in obfuscated +class names like these: +

+mycompany.myapplication.MyMain
+mycompany.myapplication.a
+mycompany.myapplication.b
+mycompany.myapplication.a.a
+mycompany.myapplication.a.b
+mycompany.a.a
+mycompany.a.b
+
+

+The -flattenpackagehierarchy +option obfuscates the package names further, by flattening the package +hierarchy of obfuscated packages: +

+-flattenpackagehierarchy 'myobfuscated'
+
+

+The obfuscated class names then look as follows: +

+mycompany.myapplication.MyMain
+mycompany.myapplication.a
+mycompany.myapplication.b
+myobfuscated.a.a
+myobfuscated.a.b
+myobfuscated.b.a
+myobfuscated.b.b
+
+

+Alternatively, the -repackageclasses option +obfuscates the entire packaging, by combining obfuscated classes into a single +package: +

+-repackageclasses 'myobfuscated'
+
+The obfuscated class names then look as follows: +
+mycompany.myapplication.MyMain
+mycompany.myapplication.a
+mycompany.myapplication.b
+myobfuscated.a
+myobfuscated.b
+myobfuscated.c
+myobfuscated.d
+
+

+Additionally specifying the -allowaccessmodification +option allows access permissions of classes and class members to +be broadened, opening up the opportunity to repackage all obfuscated classes: +

+-repackageclasses 'myobfuscated'
+-allowaccessmodification
+
+The obfuscated class names then look as follows: +
+mycompany.myapplication.MyMain
+myobfuscated.a
+myobfuscated.b
+myobfuscated.c
+myobfuscated.d
+myobfuscated.e
+myobfuscated.f
+
+

+The specified target package can always be the root package. For instance: +

+-repackageclasses ''
+-allowaccessmodification
+
+The obfuscated class names are then the shortest possible names: +
+mycompany.myapplication.MyMain
+a
+b
+c
+d
+e
+f
+
+

+Note that not all levels of obfuscation of package names may be acceptable for +all code. Notably, you may have to take into account that your application may +contain resource files that have to be adapted. + +  +

Restructuring the output archives

+In simple applications, all output classes and resources files are merged into +a single jar. For example: +
+-injars  classes
+-injars  in1.jar
+-injars  in2.jar
+-injars  in3.jar
+-outjars out.jar
+
+

+This configuration merges the processed versions of the files in the +classes directory and the three jars into a single output jar +out.jar. +

+If you want to preserve the structure of your input jars (and/or wars, ears, +zips, or directories), you can specify an output directory (or a war, an ear, +or a zip). For example: +

+-injars  in1.jar
+-injars  in2.jar
+-injars  in3.jar
+-outjars out
+
+

+The input jars will then be reconstructed in the directory out, +with their original names. +

+You can also combine archives into higher level archives. For example: +

+-injars  in1.jar
+-injars  in2.jar
+-injars  in3.jar
+-outjars out.war
+
+

+The other way around, you can flatten the archives inside higher level +archives into simple archives: +

+-injars  in.war
+-outjars out.jar
+
+

+This configuration puts the processed contents of all jars inside +in.war (plus any other contents of in.war) into +out.jar. +

+If you want to combine input jars (and/or wars, ears, zips, or directories) +into output jars (and/or wars, ears, zips, or directories), you can group the +-injars and -outjars options. For example: +

+-injars base_in1.jar
+-injars base_in2.jar
+-injars base_in3.jar
+-outjars base_out.jar
+
+-injars  extra_in.jar
+-outjars extra_out.jar
+
+

+This configuration puts the processed results of all base_in*.jar +jars into base_out.jar, and the processed results of the +extra_in.jar into extra_out.jar. Note that only the +order of the options matters; the additional whitespace is just for clarity. +

+This grouping, archiving, and flattening can be arbitrarily complex. ProGuard +always tries to package output archives in a sensible way, reconstructing the +input entries as much as required. + +  +

Filtering the input and the output

+ +If you want even greater control, you can add filters to the input and the +output, filtering out zips, ears, wars, jars, and/or ordinary files. For +example, if you want to disregard certain files from an input jar: +
+-injars  in.jar(!images/**)
+-outjars out.jar
+
+

+This configuration removes any files in the images directory and +its subdirectories. +

+Such filters can be convenient for avoiding warnings about duplicate files in +the output. For example, only keeping the manifest file from a first input jar: +

+-injars  in1.jar
+-injars  in2.jar(!META-INF/MANIFEST.MF)
+-injars  in3.jar(!META-INF/MANIFEST.MF)
+-outjars out.jar
+
+

+Another useful application is speeding up the processing by ProGuard, by +disregarding a large number of irrelevant classes in the runtime library jar: +

+-libraryjars <java.home>/lib/rt.jar(java/**,javax/**)
+
+

+The filter makes ProGuard disregard com.sun.** classes, for +instance , which don't affect the processing of ordinary applications. +

+It is also possible to filter the jars (and/or wars, ears, zips) themselves, +based on their names. For example: +

+-injars  in(**/acme_*.jar;)
+-outjars out.jar
+
+

+Note the semi-colon in the filter; the filter in front of it applies to jar +names. In this case, only acme_*.jar jars are read from the +directory in and its subdirectories. Filters for war names, ear +names, and zip names can be prefixed with additional semi-colons. All types of +filters can be combined. They are orthogonal. +

+On the other hand, you can also filter the output, in order to control what +content goes where. For example: +

+-injars  in.jar
+-outjars code_out.jar(**.class)
+-outjars resources_out.jar
+
+

+This configuration splits the processed output, sending **.class +files to code_out.jar, and all remaining files to +resources_out.jar. +

+Again, the filtering can be arbitrarily complex, especially when combined with +the grouping of input and output. + +  +

Processing multiple applications at once

+You can process several dependent or independent applications (or applets, +midlets,...) in one go, in order to save time and effort. ProGuard's input and +output handling offers various ways to keep the output nicely structured. +

+The easiest way is to specify your input jars (and/or wars, ears, zips, and +directories) and a single output directory. ProGuard will then reconstruct the +input in this directory, using the original jar names. For example, showing +just the input and output options: +

+-injars  application1.jar
+-injars  application2.jar
+-injars  application3.jar
+-outjars processed_applications
+
+

+After processing, the directory processed_applications will +contain the processed application jars, with their original names. + +  +

Incremental obfuscation

+After having processed an application, e.g. +ProGuard itself, you can still incrementally add other pieces of code that +depend on it, e.g. the ProGuard GUI: +
+-injars       proguardgui.jar
+-outjars      proguardgui_out.jar
+-injars       proguard.jar
+-outjars      proguard_out.jar
+-libraryjars  <java.home>/lib/rt.jar
+-applymapping proguard.map
+
+-keep public class proguard.gui.ProGuardGUI {
+    public static void main(java.lang.String[]);
+}
+
+

+We're reading both unprocessed jars as input. Their processed contents will go +to the respective output jars. The -applymapping option then +makes sure the ProGuard part of the code gets the previously produced +obfuscation mapping. The final application will consist of the obfuscated +ProGuard jar and the additional obfuscated GUI jar. +

+The added code in this example is straightforward; it doesn't affect the +original code. The proguard_out.jar will be identical to the one +produced in the initial processing step. If you foresee adding more complex +extensions to your code, you should specify the options -useuniqueclassmembernames, +-dontshrink, and -dontoptimize in the +original processing step. These options ensure that the obfuscated base +jar will always remain usable without changes. You can then specify the base +jar as a library jar: +

+-injars       proguardgui.jar
+-outjars      proguardgui_out.jar
+-libraryjars  proguard.jar
+-libraryjars  <java.home>/lib/rt.jar
+-applymapping proguard.map
+
+-keep public class proguard.gui.ProGuardGUI {
+    public static void main(java.lang.String[]);
+}
+
+ +  +

Preverifying class files for Java Micro Edition

+Even if you're not interested in shrinking, optimizing, and obfuscating your +midlets, as shown in the midlets example, you can still +use ProGuard to preverify the class files for Java Micro Edition. ProGuard +produces slightly more compact results compared to the traditional external +preverifier. +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars /usr/local/java/wtk2.1/lib/midpapi20.jar
+-libraryjars /usr/local/java/wtk2.1/lib/cldcapi11.jar
+
+-dontshrink
+-dontoptimize
+-dontobfuscate
+
+-microedition
+
+

+We're not processing the input, just making sure the class files are +preverified by targeting them at Java Micro Edition with the -microedition option. Note +that we don't need any -keep options to specify entry points; all +class files are simply preverified. + +  +

Upgrading class files to Java 6

+The following options upgrade class files to Java 6, by updating their +internal version numbers and preverifying them. The class files can then be +loaded more efficiently by the Java 6 Virtual Machine. +
+-injars      in.jar
+-outjars     out.jar
+-libraryjars <java.home>/lib/rt.jar
+
+-dontshrink
+-dontoptimize
+-dontobfuscate
+
+-target 1.6
+
+

+We're not processing the input, just retargeting the class files with the -target option. They will +automatically be preverified for Java 6 as a result. Note that we don't need +any -keep options to specify entry points; all class files are +simply updated and preverified. + +  +

Finding dead code

+These options list unused classes, fields, and methods in the application +mypackage.MyApplication: +
+-injars      in.jar
+-libraryjars <java.home>/lib/rt.jar
+
+-dontoptimize
+-dontobfuscate
+-dontpreverify
+-printusage
+
+-keep public class mypackage.MyApplication {
+    public static void main(java.lang.String[]);
+}
+
+

+We're not specifying an output jar, just printing out some results. We're +saving some processing time by skipping the other processing steps. +

+The java compiler inlines primitive constants and String constants +(static final fields). ProGuard would therefore list such fields +as not being used in the class files that it analyzes, even if they are +used in the source files. We can add a -keepclassmembers option +that keeps those fields a priori, in order to avoid having them listed: +

+-keepclassmembers class * {
+    static final %                *;
+    static final java.lang.String *;
+}
+
+ +  +

Printing out the internal structure of class files

+These options print out the internal structure of all class files in the input +jar: +
+-injars in.jar
+
+-dontshrink
+-dontoptimize
+-dontobfuscate
+-dontpreverify
+
+-dump
+
+

+Note how we don't need to specify the Java run-time jar, because we're not +processing the input jar at all. + +  +

Using annotations to configure ProGuard

+ +The traditional ProGuard configuration allows to keep a clean separation +between the code and the configuration for shrinking, optimization, and +obfuscation. However, it is also possible to define specific annotations, +and then annotate the code to configure the processing. +

+You can find a set of such predefined annotations in the directory +examples/annotations/lib in the ProGuard distribution. +The annotation classes are defined in annotations.jar. The +corresponding ProGuard configuration (or meta-configuration, if you prefer) +is specified in annotations.pro. With these files, you can start +annotating your code. For instance, a java source file +Application.java can be annotated as follows: +

+@KeepApplication
+public class Application {
+  ....
+}
+
+

+The ProGuard configuration file for the application can then be simplified by +leveraging off these annotations: +

+-injars      in.jar
+-outjars     out.jar
+-libraryjars <java.home>/lib/rt.jar
+
+-include lib/annotations.pro
+
+

+The annotations are effectively replacing the application-dependent +-keep options. You may still wish to add traditional +-keep options for processing native +methods, enumerations, serializable classes, and annotations. +

+The directory examples/annotations contains more examples that +illustrate some of the possibilities. +

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/gui.html b/docs/manual/gui.html new file mode 100644 index 0000000..37684a6 --- /dev/null +++ b/docs/manual/gui.html @@ -0,0 +1,474 @@ + + + + + + +ProGuard GUI + + + +

Graphical User Interface

+ +You can find the ProGuard GUI jar in the lib directory of the +ProGuard distribution. To run the ProGuard graphical user interface, just type: +

+java -jar proguardgui.jar [-nosplash] [configuration_file] +

+The GUI will pop up in a window. With the -nosplash option, you +can switch off the short opening animation. If you have specified a ProGuard +configuration file, it will be loaded. The GUI works like a wizard. You can +edit the configuration and execute ProGuard through a few tabs: +

+ + + + + + + + + + + + + + + + +
ProGuardOptionally load an existing configuration file.
Input/OutputSpecify the program jars and library jars.
ShrinkingSpecify the shrinking options.
ObfuscationSpecify the obfuscation options.
OptimizationSpecify the optimization options.
InformationSpecify some options to get information.
ProcessView and save the resulting configuration, and run ProGuard.
+

+ +In addition, there is a tab to execute ReTrace interactively: +

+ + + + +
ReTraceSet up and run ReTrace, to de-obfuscate stack traces.
+

+ +You can freely toggle between the tabs by means of the buttons on the +left-hand side of the window, or by means of the Previous and +Next buttons at the bottom of the tabs. Tool tips briefly explain the +purpose of the numerous options and text fields, although a basic +understanding of the shrinking/optimization/obfuscation/preverification +process is assumed. Please refer to the Introduction of this manual. +

+ +  +

The ProGuard Tab

+ +The ProGuard tab presents a welcome message and one important button at +the bottom: +

+ + + + +
Load configuration...opens a file chooser to load an existing ProGuard configuration + file.
+

+ +If you don't want to load an existing configuration, you can just continue +creating a new configuration from scratch. +

+ +  +

The Input/Output Tab

+ +The Input/Output tab contains two lists, respectively to specify the +program jars (or wars, ears, zips, or directories), and the library jars (or +wars, ears, zips, or directories). + +
    +
  • The list of program jars contains input entries and output entries. Input + entries contain the class files and resource files to be processed. Output + entries specify the destinations to which the processed results will be + written. They are preceded by arrows, to distinguish them from input + entries. The results of each consecutive list of input entries will be + written to the subsequent consecutive list of output entries. + +
  • The library jars are not copied to the output jars; they contain class + files that are used by class files in the program jars and that are + necessary for correct processing. This list typically at least contains the + targeted Java runtime jar. +
+

+ +Each of these lists can be edited by means of a couple of buttons on the +right-hand side: +

+ + + + + + + + + + + + + + + + + + + + +
Add input... opens a file chooser to add an + input entry to the list of program jars.
Add output... opens a file chooser to add an + output entry to the list of program jars.
Add...opens a file chooser to add an entry to the list of library + jars.
Edit...opens a file chooser to edit the selected entry in the list.
Filter...opens a text entry field to add or edit the filters of the selected + entries in the list.
Removeremoves the selected entries from the list.
Move upmoves the selected entries one position up the list.
Move downmoves the selected entries one position down the list.
Move to librariesmoves the selected entries in the list of program jars to the list of + library jars.
Move to programmoves the selected entries in the list of library jars to the list of + program jars.
+

+ +Filters allow to filter files based on their names. One can specify filters +for class file names and resource file names, for jar file names, for war file +names, for ear file names, and for zip file names. Multiple entries in the +program list only make sense when combined with filters; each output file is +written to the first entry with a matching filter. +

+ +Input entries that are currently not readable are colored red. +

+ +The order of the entries in each list may matter, as the first occurrence of +any duplicate entries gets precedence, just as in conventional class paths. +

+ +Corresponding configuration options: +

+

+ +  +

The Shrinking Tab

+ +The Shrinking tab presents a number of options that affect the +shrinking step. The basic options are followed by a few lists of classes and +class members (fields and methods) that must be protected from shrinking (and +implicitly from obfuscation as well). +

+ +The fixed lists contain predefined entries that are typically useful for many +applications. Each of these entries can be toggled by means of a check box. +The text field following each entry allows to constrain the applicable classes +by means of a comma-separated list of wildcarded, fully-qualified class +names. The default is "*", which means that all input classes of the +corresponding type are considered. +

+ +For example, checking the Applications entry and filling in +"myapplications.**" after it would mean: keep all classes that have main +methods in the "myapplications" package and all of its subpackages. +

+ +The variable list at the bottom allows to define additional entries +yourself. The list can be edited by means of a couple of buttons on the +right-hand side: +

+ + + + + + + + + + + + +
Add...opens a window to add a new entry to the list.
Edit...opens a window to edit the selected entry in the list.
Removeremoves the selected entries from the list.
Move upmoves the selected entries one position up the list.
Move downmoves the selected entries one position down the list.
+

+ +The interface windows allow to specify classes, fields, and methods. They +contain text fields and check boxes to constrain these items. They have +Ok and Cancel buttons to apply or to cancel the operation. +

+ +For example, your application may be creating some classes dynamically using +Class.forName. You should then specify them here, so they are kept +by their original names. Press the Add... button to open the class +window. Fill out the fully-qualified class name in the Code text field, +and press the Ok button. Repeat this for all required classes. Wildcards +can be helpful to specify a large number of related classes in one go. If you +want to specify all implementations of a certain interface, fill out the +fully qualified interface name in the Extends/implements class instead. +

+ +For more advanced settings, it is advisable to become familiar with ProGuard's +configuration options through the Usage section and +the Examples section. We'll suffice with a brief +overview of the three dialogs provided by the GUI. +

+ +The keep class dialog appears when adding or editing new special keep +entries. It has text fields and selections for specifying and constraining +classes and class members to keep. The Advanced options / Basic +options button at the bottom of the dialog allows to toggle showing the +advanced options. + +

    +
  • The Comments text field allows to add optional comments to this + entry. The comments will identify the entry in the list and they will + appear as comments in the configuration file. + +
  • The Keep selection allows to specify whether you want to protect + the specified classes and their specified class members, or just the + specified class members from the specified classes, or the specified + classes and the specified class members, if the class members are present. + Note that class members will only be protected if they are explicitly + specified, even if only by means of a wildcard. + +
  • The Allow selection allows to specify whether you want to allow the + the specified classes and their specified class members to be shrunk, + optimized and/or obfuscated. + +
  • The Access selections allows to specify constraints on the class or + classes, based on their access modifiers. + +
  • The Annotation text field takes the fully-qualified name of an + annotation that is required for matching classes. The annotation name can + contain wildcards. This is an advanced option for defining keep + annotations. + +
  • The Class text field takes the fully-qualified name of the class or + classes. The class name can contain wildcards. + +
  • The Annotation text field takes the fully-qualified name of an + annotation that is required for the class or interface that the above + class must extend. The annotation name can contain wildcards. This is an + advanced option for defining keep annotations. + +
  • The Extends/implements class text field takes the fully-qualified + name of the class or interface that the above classes must extend. + +
  • The Class members list allows to specify a list of fields and + methods to keep. It can be edited by means of a list of buttons on the + right-hand side. +
+

+ +The keep field dialog appears when adding or editing fields within the +above dialog. It has text fields and selections for specifying and +constraining fields to keep. Again, the Advanced options / Basic +options button at the bottom of the dialog allows to toggle showing the +advanced options. + +

    +
  • The Access selections allows to specify constraints on the field or + fields, based on their access modifiers. + +
  • The Annotation text field takes the fully-qualified name of an + annotation that is required for matching fields. The annotation name can + contain wildcards. This is an advanced option for defining keep + annotations. + +
  • The Return type text field takes the fully-qualified type of the + field or fields. The type can contain wildcards. + +
  • The Name text field takes the name of the field or fields. The field + name can contain wildcards. +
+

+ +Similarly, the keep method dialog appears when adding or editing +methods within the keep class dialog. It has text fields and selections for +specifying and constraining methods to keep. Again, the Advanced +options / Basic options button at the bottom of the dialog allows +to toggle showing the advanced options. + +

    +
  • The Access selections allows to specify constraints on the method or + methods, based on their access modifiers. + +
  • The Annotation text field takes the fully-qualified name of an + annotation that is required for matching methods. The annotation name can + contain wildcards. This is an advanced option for defining keep + annotations. + +
  • The Return type text field takes the fully-qualified type of the method or methods. The type can contain wildcards. + +
  • The Name text field takes the name of the method or methods. The + method name can contain wildcards. + +
  • The Arguments text field takes the comma-separated list of + fully-qualified method arguments. Each of these arguments can contain + wildcards. +
+

+ +Corresponding configuration options: +

+

+ +  +

The Obfuscation Tab

+ +The Obfuscation tab presents a number of options that affect the +obfuscation step. The basic options are followed by a few lists of classes and +class members (fields and methods) that must be protected from obfuscation +(but not necessarily from shrinking). +

+ +The lists are manipulated in the same way as in the Shrinking Tab. +

+ +Corresponding configuration options: +

+

+ +  +

The Optimization Tab

+ +The Optimization tab presents a number of options that affect the +optimization step. The basic options are followed by a few lists of class +method calls that can be removed if ProGuard can determine that their results +are not being used. +

+ +The lists are manipulated in much the same way as in the Shrinking Tab. +

+ +Corresponding configuration options: +

+

+ +  +

The Information Tab

+ +The Information tab presents a number of options for preverification +and targeting, and for the information that ProGuard returns when processing +your code. The bottom list allows you to query ProGuard about why given +classes and class members are being kept in the shrinking step. +

+ +Corresponding configuration options: +

+

+ +  +

The Process Tab

+ +The Process tab has an output console for displaying the configuration +and the messages while processing. There are three important buttons at the +bottom: +

+ + + + + + + + +
View configurationdisplays the current ProGuard configuration in the console.
Save configuration...opens a file chooser to save the current ProGuard + configuration.
Process!executes ProGuard with the current configuration.
+

+ +  +

The ReTrace Tab

+ +The ReTrace tab has a panel with a few settings, an input text area for +the obfuscated stack trace, and an output console to view the de-obfuscated +stack trace: + +
    +
  • The Verbose check box in the settings panel allows to toggle between + normal mode and verbose mode. + +
  • The Mapping file text field takes the name of the required mapping + file that ProGuard wrote while processing the original code. The file name + can be entered manually or by means of the Browse... button that + opens a file chooser. + +
  • The Obfuscated stack trace text area allows to enter the stack + trace, typically by copying and pasting it from elsewhere. Alternatively, + it can be loaded from a file by means of the load button below. +
+ +There are two buttons at the bottom: +

+ + + + + + +
Load stack trace...opens a file chooser to load an obfuscated stack trace.
ReTrace!executes ReTrace with the current settings.
+

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/index.html b/docs/manual/index.html new file mode 100644 index 0000000..397b910 --- /dev/null +++ b/docs/manual/index.html @@ -0,0 +1,39 @@ + + + + + + +ProGuard Manual + + + +

ProGuard

+ +
    +
  1. Introduction +
  2. Usage +
  3. Limitations +
  4. Examples +
  5. Troubleshooting +
  6. Reference Card +
  7. Graphical User Interface +
  8. Ant Task +
  9. JME Wireless Toolkit Integration +
+ +

ReTrace

+ +
    +
  1. Introduction +
  2. Usage +
  3. Examples +
+ +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/introduction.html b/docs/manual/introduction.html new file mode 100644 index 0000000..cdab330 --- /dev/null +++ b/docs/manual/introduction.html @@ -0,0 +1,156 @@ + + + + + + +ProGuard Introduction + + + +

Introduction

+ +ProGuard is a Java class file shrinker, optimizer, obfuscator, and +preverifier. The shrinking step detects and removes unused classes, fields, +methods, and attributes. The optimization step analyzes and optimizes the +bytecode of the methods. The obfuscation step renames the remaining classes, +fields, and methods using short meaningless names. These first steps make the +code base smaller, more efficient, and harder to reverse-engineer. The final +preverification step adds preverification information to the classes, which is +required for Java Micro Edition or which improves the start-up time for Java +6. +

+Each of these steps is optional. For instance, ProGuard can also be used to +just list dead code in an application, or to preverify class files for +efficient use in Java 6. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Input jars
Shrunk code
Optim. codeOutput jars
- shrink →- optimize →- obfuscate →Obfusc. code- preverify →
Library jars------------------------------- (unchanged) -------------------------------→Library jars
+

+ +ProGuard typically reads the input jars (or wars, ears, zips, or +directories). It then shrinks, optimizes, obfuscates, and preverifies them. +Optionally, multiple optimization passes can be performed, each typically +followed by another shrinking step. ProGuard writes the processed results to +one or more output jars (or wars, ears, zips, or directories). The +input may contain resource files, whose names and contents can optionally be +updated to reflect the obfuscated class names. +

+ProGuard requires the library jars (or wars, ears, zips, or +directories) of the input jars to be specified. These are essentially the +libraries that you would need for compiling the code. ProGuard uses them to +reconstruct the class dependencies that are necessary for proper processing. +The library jars themselves always remain unchanged. You should still put them +in the class path of your final application. +

+In order to determine which code has to be preserved and which code can be +discarded or obfuscated, you have to specify one or more entry points to +your code. These entry points are typically classes with main methods, applets, +midlets, etc. +

    +
  • In the shrinking step, ProGuard starts from these seeds and + recursively determines which classes and class members are used. All other + classes and class members are discarded. + +
  • In the optimization step, ProGuard further optimizes the code. + Among other optimizations, classes and methods that are not entry points + can be made private, static, or final, unused parameters can be removed, + and some methods may be inlined. + +
  • In the obfuscation step, ProGuard renames classes and class members + that are not entry points. In this entire process, keeping the entry + points ensures that they can still be accessed by their original names. + +
  • The preverification step is the only step that doesn't have to know + the entry points. +
+

+The Usage section of this manual describes the +necessary -keep options and +the Examples section provides plenty of examples. + +

Introspection

+ +Introspection presents particular problems for any automatic processing of +code. In ProGuard, classes or class members in your code that are created or +invoked dynamically (that is, by name) have to be specified as entry points +too. For example, Class.forName() constructs may refer to any +class at run-time. It is generally impossible to foresee which classes have to +be preserved (with their original names), since the class names might be read +from a configuration file, for instance. You therefore have to specify them in +your ProGuard configuration, with the same simple -keep options. +

+However, ProGuard will already detect and handle the following cases for you: + +

    +
  • Class.forName("SomeClass") +
  • SomeClass.class +
  • SomeClass.class.getField("someField") +
  • SomeClass.class.getDeclaredField("someField") +
  • SomeClass.class.getMethod("someMethod", new Class[] {}) +
  • SomeClass.class.getMethod("someMethod", new Class[] { A.class }) +
  • SomeClass.class.getMethod("someMethod", new Class[] { A.class, B.class }) +
  • SomeClass.class.getDeclaredMethod("someMethod", new Class[] {}) +
  • SomeClass.class.getDeclaredMethod("someMethod", new Class[] { A.class }) +
  • SomeClass.class.getDeclaredMethod("someMethod", new Class[] { A.class, B.class }) +
+ +The names of the classes and class members may of course be different, but the +constructs should be literally the same for ProGuard to recognize them. The +referenced classes and class members are preserved in the shrinking phase, and +the string arguments are properly replaced in the obfuscation phase. +

+Furthermore, ProGuard will offer some suggestions if keeping some classes or +class members appears necessary. For example, ProGuard will note constructs +like "(SomeClass)Class.forName(variable).newInstance()". These +might be an indication that the class or interface SomeClass +and/or its implementations may need to be preserved. You can then adapt your +configuration accordingly. +

+For proper results, you should at least be somewhat familiar with the code +that you are processing. Obfuscating code that performs a lot of introspection +may require trial and error, especially without the necessary information +about the internals of the code. +

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/limitations.html b/docs/manual/limitations.html new file mode 100644 index 0000000..cfe0ff5 --- /dev/null +++ b/docs/manual/limitations.html @@ -0,0 +1,64 @@ + + + + + + +ProGuard Limitations + + + +

Limitations

+ +When using ProGuard, you should be aware of a few technical issues, all of +which are easily avoided or resolved: +

+

    + +
  • For efficiency, ProGuard always ignores any private or package visible + library classes while reading library jars. If any of them are + extended by public library classes, and then extended again by input + classes, ProGuard will complain it can't find them. In that case, you'll + have to use the -dontskipnonpubliclibraryclasses option, and + maybe even the -dontskipnonpubliclibraryclassmembers option. + The graphical user interface has checkboxes for these settings. +

    + +

  • For best results, ProGuard's optimization algorithms assume that the + processed code never intentionally throws NullPointerExceptions or + ArrayIndexOutOfBoundsExceptions, or even OutOfMemoryErrors or + StackOverflowErrors, in order to achieve something useful. For instance, + it may remove a method call myObject.myMethod() if that call + wouldn't have any effect. It ignores the possibility that + myObject might be null, causing a NullPointerException. In + some way this is a good thing: optimized code may throw fewer exceptions. + Should this entire assumption be false, you'll have to switch off + optimization using the -dontoptimize option. +

    + +

  • If an input jar and a library jar contain classes in the same + package, the obfuscated output jar may contain class names that + overlap with class names in the library jar. This is most likely if the + library jar has been obfuscated before, as it will then probably contain + classes named 'a', 'b', etc. Packages should therefore never be split + across input jars and library jars. +

    + +

  • When obfuscating, ProGuard will write out class files named + "a.class", "b.class", etc. If there is a large + numbers of classes in the same package, it may also write out + "aux.class". Windows doesn't allow creating files with + this reserved name (among a few other names), so it's generally better to + write the output to a jar, in order to avoid such problems. +

    + +

+

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/optimizations.html b/docs/manual/optimizations.html new file mode 100644 index 0000000..9c20571 --- /dev/null +++ b/docs/manual/optimizations.html @@ -0,0 +1,158 @@ + + + + + + +Optimizations + + + +

Optimizations

+ +The optimization step of ProGuard can be switched off with the +-dontoptimize option. For +more fine-grained control over individual optimizations, experts can use the +-optimizations option, +with a filter based on the optimization names listed below. The filter works +like any filter in ProGuard. +

+ +The following wildcards are supported: + + + + + + +
?matches any single character in an optimization name.
*matches any part of an optimization name.
+ +An optimization that is preceded by an exclamation mark '!' is +excluded from further attempts to match with subsequent +optimization names in the filter. Make sure to specify filters correctly, +since they are not checked for potential typos. +

+ +For example, +"code/simplification/variable,code/simplification/arithmetic" +only performs the two specified peephole optimizations. +

+ +For example, "!method/propagation/*" performs all optimizations, +except the ones that propagate values between methods. +

+ +For example, +"!code/simplification/advanced,code/simplification/*" only +performs all peephole optimizations. +

+Some optimizations necessarily imply other optimizations. These are then +indicated. Note that the list is likely to change over time, as optimizations +are added and reorganized. +

+ +

+
class/marking/final
+
Marks classes as final, whenever possible.
+ +
class/merging/vertical
+
Merges classes vertically in the class hierarchy, whenever possible.
+ +
class/merging/horizontal
+
Merges classes horizontally in the class hierarchy, whenever possible.
+ +
(⇒ code/removal/advanced)
+ field/removal/writeonly
+
Removes write-only fields.
+ +
field/marking/private
+
Marks fields as private, whenever possible.
+ +
(⇒ code/simplification/advanced)
+ field/propagation/value
+
Propagates the values of fields across methods.
+ +
method/marking/private
+
Marks methods as private, whenever possible (devirtualization).
+ +
(⇒ code/removal/advanced)
+ method/marking/static
+
Marks methods as static, whenever possible (devirtualization).
+ +
method/marking/final
+
Marks methods as final, whenever possible.
+ +
(⇒ code/removal/advanced)
+ method/removal/parameter
+
Removes unused method parameters.
+ +
(⇒ code/simplification/advanced)
+ method/propagation/parameter
+
Propagates the values of method parameters from method invocations to + the invoked methods.
+ +
(⇒ code/simplification/advanced)
+ method/propagation/returnvalue
+
Propagates the values of method return values from methods to their + invocations.
+ +
method/inlining/short
+
Inlines short methods.
+ +
method/inlining/unique
+
Inlines methods that are only called once.
+ +
method/inlining/tailrecursion
+
Simplifies tail recursion calls, whenever possible.
+ +
code/merging
+
Merges identical blocks of code by modifying branch targets.
+ +
code/simplification/variable
+
Performs peephole optimizations for variable loading and storing.
+ +
code/simplification/arithmetic
+
Performs peephole optimizations for arithmetic instructions.
+ +
code/simplification/cast
+
Performs peephole optimizations for casting operations.
+ +
code/simplification/field
+
Performs peephole optimizations for field loading and storing.
+ +
(⇒ code/removal/simple)
+ code/simplification/branch
+
Performs peephole optimizations for branch instructions.
+ +
(best used with code/removal/advanced)
+ code/simplification/advanced
+
Simplifies code based on control flow analysis and data flow + analysis.
+ +
(⇒ code/removal/exception)
+ code/removal/advanced
+
Removes dead code based on control flow analysis and data flow + analysis.
+ +
(⇒ code/removal/exception)
+ code/removal/simple
+
Removes dead code based on a simple control flow analysis.
+ +
code/removal/variable
+
Removes unused variables from the local variable frame.
+ +
code/removal/exception
+
Removes exceptions with empty catch blocks.
+ +
code/allocation/variable
+
Optimizes variable allocation on the local variable frame.
+
+

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/refcard.html b/docs/manual/refcard.html new file mode 100644 index 0000000..236f049 --- /dev/null +++ b/docs/manual/refcard.html @@ -0,0 +1,465 @@ + + + + + + +ProGuard Reference Card + + + +

ProGuard Reference Card

+ +

Usage

+ +java -jar proguard.jar options ... +

+  Typically: +

+java -jar proguard.jar @myconfig.pro +

+ +

Options

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
@filenameShort for '-include filename'.
-include + filenameRead configuration options from the given file.
-basedirectory + directorynameSpecifies the base directory for subsequent relative file names.
-injars + class_pathSpecifies the program jars (or wars, ears, zips, or directories).
-outjars + class_pathSpecifies the name of the output jars (or wars, ears, zips, or + directories).
-libraryjars + class_pathSpecifies the library jars (or wars, ears, zips, or directories).
-dontskipnonpubliclibraryclassesDon't ignore non-public library classes.
-dontskipnonpubliclibraryclassmembersDon't ignore package visible library class members.
-keepdirectories + [directory_filter]Keep the specified directories in the output jars (or wars, ears, zips, or + directories).
-target + versionSet the given version number in the processed classes.
-forceprocessingProcess the input, even if the output seems up to date.
-keep + [,modifier,...] + class_specificationPreserve the specified classes and class members.
-keepclassmembers + [,modifier,...] + class_specificationPreserve the specified class members, if their classes are preserved as + well.
-keepclasseswithmembers + [,modifier,...] + class_specificationPreserve the specified classes and class members, if all of the + specified class members are present.
-keepnames + class_specificationPreserve the names of the specified classes and class members (if + they aren't removed in the shrinking step).
-keepclassmembernames + class_specificationPreserve the names of the specified class members (if they aren't removed + in the shrinking step).
-keepclasseswithmembernames + class_specificationPreserve the names of the specified classes and class members, if + all of the specified class members are present (after the shrinking + step).
-printseeds + [filename]List classes and class members matched by the various -keep + options, to the standard output or to the given file.
-dontshrinkDon't shrink the input class files.
-printusage + [filename]List dead code of the input class files, to the standard output or to the + given file.
-whyareyoukeeping + class_specificationPrint details on why the given classes and class members are being kept in + the shrinking step.
-dontoptimizeDon't optimize the input class files.
-optimizations + optimization_filterThe optimizations to be enabled and disabled.
-optimizationpasses + nThe number of optimization passes to be performed.
-assumenosideeffects + class_specificationAssume that the specified methods don't have any side effects, while + optimizing.
-allowaccessmodificationAllow the access modifiers of classes and class members to be modified, + while optimizing.
-mergeinterfacesaggressivelyAllow any interfaces to be merged, while optimizing.
-dontobfuscateDon't obfuscate the input class files.
-printmapping + [filename]Print the mapping from old names to new names for classes and class members + that have been renamed, to the standard output or to the given file.
-applymapping + filenameReuse the given mapping, for incremental obfuscation.
-obfuscationdictionary + filenameUse the words in the given text file as obfuscated field names and method names.
-classobfuscationdictionary + filenameUse the words in the given text file as obfuscated class names.
-packageobfuscationdictionary + filenameUse the words in the given text file as obfuscated package names.
-overloadaggressivelyApply aggressive overloading while obfuscating.
-useuniqueclassmembernamesEnsure uniform obfuscated class member names for subsequent incremental + obfuscation.
-dontusemixedcaseclassnamesDon't generate mixed-case class names while obfuscating.
-keeppackagenames + [package_filter]Keep the specified package names from being obfuscated.
-flattenpackagehierarchy + [package_name]Repackage all packages that are renamed into the single given parent + package.
-repackageclasses + [package_name]Repackage all class files that are renamed into the single given + package.
-keepattributes + [attribute_filter]Preserve the given optional attributes; typically + Exceptions, InnerClasses, + Signature, Deprecated, + SourceFile, SourceDir, + LineNumberTable, + LocalVariableTable, LocalVariableTypeTable, + Synthetic, EnclosingMethod, and + *Annotation*.
-renamesourcefileattribute + [string]Put the given constant string in the SourceFile + attributes.
-adaptclassstrings + [class_filter]Adapt string constants in the specified classes, based on the obfuscated + names of any corresponding classes.
-adaptresourcefilenames + [file_filter]Rename the specified resource files, based on the obfuscated names of the + corresponding class files.
-adaptresourcefilecontents + [file_filter]Update the contents of the specified resource files, based on the + obfuscated names of the processed classes.
-dontpreverifyDon't preverify the processed class files.
-microeditionTarget the processed class files at Java Micro Edition.
-verboseWrite out some more information during processing.
-dontnote + [class_filter]Don't print notes about potential mistakes or omissions in the + configuration.
-dontwarn + [class_filter]Don't warn about unresolved references at all.
-ignorewarningsPrint warnings about unresolved references, but continue processing + anyhow.
-printconfiguration + [filename]Write out the internal structure of the processed class files, to the + standard output or to the given file.
-dump + [filename]Write out the entire configuration in traditional ProGuard style, to the + standard output or to the given file.
+

+Notes: +

    + +
  • class_path is a list of jars, wars, ears, zips, and directories, + with optional filters, separated by path separators. +
  • filename can contain Java system properties delimited by + '<' and '>'. +
  • If filename contains special characters, the entire name + should be quoted with single or double quotes. +
+

+ +

Overview of Keep Options

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
KeepFrom being removed or renamedFrom being renamed
Classes and class members-keep-keepnames
Class members only-keepclassmembers-keepclassmembernames
Classes and class members, if class members present-keepclasseswithmembers-keepclasseswithmembernames
+

+ +

Keep Option Modifiers

+ + + + + + + + + + + + + + + + + + +
allowshrinkingThe entry points specified in the keep tag may be shrunk.
allowoptimizationThe entry points specified in the keep tag may be optimized.
allowobfuscationThe entry points specified in the keep tag may be obfuscated.
+

+ +

Class Specifications

+ +
+[@annotationtype] [[!]public|final|abstract ...] [!]interface|class classname
+    [extends|implements [@annotationtype] classname]
+[{
+    [@annotationtype] [[!]public|private|protected|static|volatile|transient ...] <fields> |
+                                                                      (fieldtype fieldname);
+    [@annotationtype] [[!]public|private|protected|static|synchronized|native|abstract|strictfp ...] <methods> |
+                                                                                           <init>(argumenttype,...) |
+                                                                                           classname(argumenttype,...) |
+                                                                                           (returntype methodname(argumenttype,...));
+    [@annotationtype] [[!]public|private|protected|static ... ] *;
+    ...
+}]
+
+

+Notes: +

    +
  • Class names must always be fully qualified, i.e. including their package + names. +
  • Types in classname, annotationtype, returntype, and + argumenttype can contain wildcards: '?' for a + single character, '*' for any number of characters + (but not the package separator), '**' for any number + of (any) characters, '%' for any primitive type, + '***' for any type, and '...' for any number of arguments.. +
  • fieldname and methodname can contain wildcards as well: + '?' for a single character and '*' + for any number of characters. +
+

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/retrace/examples.html b/docs/manual/retrace/examples.html new file mode 100644 index 0000000..211017b --- /dev/null +++ b/docs/manual/retrace/examples.html @@ -0,0 +1,336 @@ + + + + + + +ReTrace Examples + + + +

Examples

+ +Some typical example uses: +
    +
  1. Restoring a stack trace with line numbers +
  2. Restoring a stack trace with line numbers (verbose) +
  3. Restoring a stack trace without line numbers +
+ +  +

Restoring a stack trace with line numbers

+ +Assume for instance ProGuard itself has been obfuscated using the following +extra options: +
+-printmapping proguard.map
+
+-renamesourcefileattribute ProGuard
+-keepattributes SourceFile,LineNumberTable
+
+

+ +Now assume the processed application throws an exception, and we have saved the +stack trace in proguard.trace, shown below. Of course, in real +life ProGuard rarely throws exceptions, so this is a purposely generated +exception. :) + +

+Exception in thread "main" java.lang.Error: Random exception
+        at pro.bY.a(ProGuard:576)
+        at pro.bO.a(ProGuard:431)
+        at pro.bj.a(ProGuard:145)
+        at pro.bY.a(ProGuard:522)
+        at pro.bj.a(ProGuard:129)
+        at pro.bN.a(ProGuard:125)
+        at pro.bY.a(ProGuard:251)
+        at pro.bY.a(ProGuard:229)
+        at pro.l.a(ProGuard:55)
+        at pro.bo.b(ProGuard:405)
+        at pro.ci.a(ProGuard:51)
+        at pro.bo.a(ProGuard:356)
+        at pro.be.a(ProGuard:109)
+        at pro.bo.a(ProGuard:356)
+        at pro.be.a(ProGuard:186)
+        at pro.bg.a(ProGuard:369)
+        at pro.bY.a(ProGuard:286)
+        at pro.bh.a(ProGuard:55)
+        at pro.bg.b(ProGuard:408)
+        at pro.bY.a(ProGuard:190)
+        at pro.bg.a(ProGuard:369)
+        at pro.M.a(ProGuard:110)
+        at pro.bY.a(ProGuard:449)
+        at pro.M.a(ProGuard:99)
+        at pro.bo.a(ProGuard:372)
+        at pro.bY.a(ProGuard:649)
+        at pro.bY.a(ProGuard:112)
+        at pro.P.a(ProGuard:66)
+        at pro.p.a(ProGuard:83)
+        at pro.bU.a(ProGuard:69)
+        at pro.bo.a(ProGuard:356)
+        at pro.J.a(ProGuard:149)
+        at pro.I.a(ProGuard:49)
+        at pro.J.a(ProGuard:105)
+        at pro.cf.c(ProGuard:370)
+        at pro.cf.a(ProGuard:317)
+        at pro.bc.a(ProGuard:55)
+        at proguard.ProGuard.a(ProGuard:363)
+        at proguard.ProGuard.c(ProGuard:187)
+        at proguard.ProGuard.b(ProGuard:385)
+        at proguard.ProGuard.main(ProGuard:429)
+
+

+ +We can then use the following command to recover the stack trace: +

+java -jar retrace.jar proguard.map proguard.trace
+
+

+ +The output will look as follows: +

+Exception in thread "main" java.lang.Error: Random exception
+        at proguard.shrink.UsageMarker.visitInstruction(ProGuard:576)
+        at proguard.classfile.instruction.GenericInstruction.accept(ProGuard:431)
+        at proguard.classfile.CodeAttrInfo.instructionsAccept(ProGuard:145)
+        at proguard.shrink.UsageMarker.visitCodeAttrInfo(ProGuard:522)
+        at proguard.classfile.CodeAttrInfo.accept(ProGuard:129)
+        at proguard.classfile.ProgramMemberInfo.attributesAccept(ProGuard:125)
+        at proguard.shrink.UsageMarker.visitMemberInfo(ProGuard:251)
+        at proguard.shrink.UsageMarker.visitProgramMethodInfo(ProGuard:229)
+        at proguard.classfile.ProgramMethodInfo.accept(ProGuard:55)
+        at proguard.classfile.ProgramClassFile.methodAccept(ProGuard:405)
+        at proguard.classfile.visitor.NamedMethodVisitor.visitProgramClassFile(ProGuard:51)
+        at proguard.classfile.ProgramClassFile.accept(ProGuard:356)
+        at proguard.classfile.visitor.ClassFileUpDownTraveler.visitProgramClassFile(ProGuard:109)
+        at proguard.classfile.ProgramClassFile.accept(ProGuard:356)
+        at proguard.classfile.visitor.ClassFileUpDownTraveler.visitLibraryClassFile(ProGuard:186)
+        at proguard.classfile.LibraryClassFile.accept(ProGuard:369)
+        at proguard.shrink.UsageMarker.visitLibraryMethodInfo(ProGuard:286)
+        at proguard.classfile.LibraryMethodInfo.accept(ProGuard:55)
+        at proguard.classfile.LibraryClassFile.methodsAccept(ProGuard:408)
+        at proguard.shrink.UsageMarker.visitLibraryClassFile(ProGuard:190)
+        at proguard.classfile.LibraryClassFile.accept(ProGuard:369)
+        at proguard.classfile.ClassCpInfo.referencedClassAccept(ProGuard:110)
+        at proguard.shrink.UsageMarker.visitClassCpInfo(ProGuard:449)
+        at proguard.classfile.ClassCpInfo.accept(ProGuard:99)
+        at proguard.classfile.ProgramClassFile.constantPoolEntryAccept(ProGuard:372)
+        at proguard.shrink.UsageMarker.markCpEntry(ProGuard:649)
+        at proguard.shrink.UsageMarker.visitProgramClassFile(ProGuard:112)
+        at proguard.classfile.visitor.VariableClassFileVisitor.visitProgramClassFile(ProGuard:66)
+        at proguard.classfile.visitor.MultiClassFileVisitor.visitProgramClassFile(ProGuard:83)
+        at proguard.classfile.visitor.FilteredClassFileVisitor.visitProgramClassFile(ProGuard:69)
+        at proguard.classfile.ProgramClassFile.accept(ProGuard:356)
+        at proguard.classfile.ClassPool.classFileAccept(ProGuard:149)
+        at proguard.classfile.visitor.NamedClassFileVisitor.visitClassPool(ProGuard:49)
+        at proguard.classfile.ClassPool.accept(ProGuard:105)
+        at proguard.KeepCommand.executeShrinkingPhase(ProGuard:370)
+        at proguard.KeepCommand.execute(ProGuard:317)
+        at proguard.CompoundCommand.execute(ProGuard:55)
+        at proguard.ProGuard.executeCommands(ProGuard:363)
+        at proguard.ProGuard.shrink(ProGuard:187)
+        at proguard.ProGuard.execute(ProGuard:385)
+        at proguard.ProGuard.main(ProGuard:429)
+
+ +  +

Restoring a stack trace with line numbers (verbose)

+ +In the previous example, we could also use the verbose flag: +
+java -jar retrace.jar -verbose proguard.map proguard.trace
+
+

+ +The output will then look as follows: +

+Exception in thread "main" java.lang.Error: Random exception
+        at proguard.shrink.UsageMarker.void visitInstruction(proguard.classfile.ClassFile,proguard.classfile.instruction.Instruction)(ProGuard:576)
+        at proguard.classfile.instruction.GenericInstruction.void accept(proguard.classfile.ClassFile,proguard.classfile.instruction.InstructionVisitor)(ProGuard:431)
+        at proguard.classfile.CodeAttrInfo.void instructionsAccept(proguard.classfile.ClassFile,proguard.classfile.instruction.InstructionVisitor)(ProGuard:145)
+        at proguard.shrink.UsageMarker.void visitCodeAttrInfo(proguard.classfile.ClassFile,proguard.classfile.CodeAttrInfo)(ProGuard:522)
+        at proguard.classfile.CodeAttrInfo.void accept(proguard.classfile.ClassFile,proguard.classfile.visitor.AttrInfoVisitor)(ProGuard:129)
+        at proguard.classfile.ProgramMemberInfo.void attributesAccept(proguard.classfile.ProgramClassFile,proguard.classfile.visitor.AttrInfoVisitor)(ProGuard:125)
+        at proguard.shrink.UsageMarker.void visitMemberInfo(proguard.classfile.ProgramClassFile,proguard.classfile.ProgramMemberInfo)(ProGuard:251)
+        at proguard.shrink.UsageMarker.void visitProgramMethodInfo(proguard.classfile.ProgramClassFile,proguard.classfile.ProgramMethodInfo)(ProGuard:229)
+        at proguard.classfile.ProgramMethodInfo.void accept(proguard.classfile.ProgramClassFile,proguard.classfile.visitor.MemberInfoVisitor)(ProGuard:55)
+        at proguard.classfile.ProgramClassFile.void methodAccept(proguard.classfile.visitor.MemberInfoVisitor,java.lang.String,java.lang.String)(ProGuard:405)
+        at proguard.classfile.visitor.NamedMethodVisitor.void visitProgramClassFile(proguard.classfile.ProgramClassFile)(ProGuard:51)
+        at proguard.classfile.ProgramClassFile.void accept(proguard.classfile.visitor.ClassFileVisitor)(ProGuard:356)
+        at proguard.classfile.visitor.ClassFileUpDownTraveler.void visitProgramClassFile(proguard.classfile.ProgramClassFile)(ProGuard:109)
+        at proguard.classfile.ProgramClassFile.void accept(proguard.classfile.visitor.ClassFileVisitor)(ProGuard:356)
+        at proguard.classfile.visitor.ClassFileUpDownTraveler.void visitLibraryClassFile(proguard.classfile.LibraryClassFile)(ProGuard:186)
+        at proguard.classfile.LibraryClassFile.void accept(proguard.classfile.visitor.ClassFileVisitor)(ProGuard:369)
+        at proguard.shrink.UsageMarker.void visitLibraryMethodInfo(proguard.classfile.LibraryClassFile,proguard.classfile.LibraryMethodInfo)(ProGuard:286)
+        at proguard.classfile.LibraryMethodInfo.void accept(proguard.classfile.LibraryClassFile,proguard.classfile.visitor.MemberInfoVisitor)(ProGuard:55)
+        at proguard.classfile.LibraryClassFile.void methodsAccept(proguard.classfile.visitor.MemberInfoVisitor)(ProGuard:408)
+        at proguard.shrink.UsageMarker.void visitLibraryClassFile(proguard.classfile.LibraryClassFile)(ProGuard:190)
+        at proguard.classfile.LibraryClassFile.void accept(proguard.classfile.visitor.ClassFileVisitor)(ProGuard:369)
+        at proguard.classfile.ClassCpInfo.void referencedClassAccept(proguard.classfile.visitor.ClassFileVisitor)(ProGuard:110)
+        at proguard.shrink.UsageMarker.void visitClassCpInfo(proguard.classfile.ClassFile,proguard.classfile.ClassCpInfo)(ProGuard:449)
+        at proguard.classfile.ClassCpInfo.void accept(proguard.classfile.ClassFile,proguard.classfile.visitor.CpInfoVisitor)(ProGuard:99)
+        at proguard.classfile.ProgramClassFile.void constantPoolEntryAccept(proguard.classfile.visitor.CpInfoVisitor,int)(ProGuard:372)
+        at proguard.shrink.UsageMarker.void markCpEntry(proguard.classfile.ClassFile,int)(ProGuard:649)
+        at proguard.shrink.UsageMarker.void visitProgramClassFile(proguard.classfile.ProgramClassFile)(ProGuard:112)
+        at proguard.classfile.visitor.VariableClassFileVisitor.void visitProgramClassFile(proguard.classfile.ProgramClassFile)(ProGuard:66)
+        at proguard.classfile.visitor.MultiClassFileVisitor.void visitProgramClassFile(proguard.classfile.ProgramClassFile)(ProGuard:83)
+        at proguard.classfile.visitor.FilteredClassFileVisitor.void visitProgramClassFile(proguard.classfile.ProgramClassFile)(ProGuard:69)
+        at proguard.classfile.ProgramClassFile.void accept(proguard.classfile.visitor.ClassFileVisitor)(ProGuard:356)
+        at proguard.classfile.ClassPool.void classFileAccept(proguard.classfile.visitor.ClassFileVisitor,java.lang.String)(ProGuard:149)
+        at proguard.classfile.visitor.NamedClassFileVisitor.void visitClassPool(proguard.classfile.ClassPool)(ProGuard:49)
+        at proguard.classfile.ClassPool.void accept(proguard.classfile.visitor.ClassPoolVisitor)(ProGuard:105)
+        at proguard.KeepCommand.void executeShrinkingPhase(proguard.classfile.ClassPool,proguard.classfile.ClassPool)(ProGuard:370)
+        at proguard.KeepCommand.void execute(int,proguard.classfile.ClassPool,proguard.classfile.ClassPool)(ProGuard:317)
+        at proguard.CompoundCommand.void execute(int,proguard.classfile.ClassPool,proguard.classfile.ClassPool)(ProGuard:55)
+        at proguard.ProGuard.void executeCommands(int)(ProGuard:363)
+        at proguard.ProGuard.void shrink()(ProGuard:187)
+        at proguard.ProGuard.void execute(java.lang.String[])(ProGuard:385)
+        at proguard.ProGuard.void main(java.lang.String[])(ProGuard:429)
+
+ + +  +

Restoring a stack trace without line numbers

+ +Assume for instance ProGuard itself has been obfuscated using the following +extra options, this time without preserving the line number tables: +
+-printmapping proguard.map
+
+

+ +A stack trace proguard.trace will then lack line number +information: +

+Exception in thread "main" java.lang.Error: Random exception
+        at pro.bY.a(Unknown Source)
+        at pro.bO.a(Unknown Source)
+        at pro.bj.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.bj.a(Unknown Source)
+        at pro.bN.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.l.a(Unknown Source)
+        at pro.bo.b(Unknown Source)
+        at pro.ci.a(Unknown Source)
+        at pro.bo.a(Unknown Source)
+        at pro.be.a(Unknown Source)
+        at pro.bo.a(Unknown Source)
+        at pro.be.a(Unknown Source)
+        at pro.bg.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.bh.a(Unknown Source)
+        at pro.bg.b(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.bg.a(Unknown Source)
+        at pro.M.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.M.a(Unknown Source)
+        at pro.bo.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.bY.a(Unknown Source)
+        at pro.P.a(Unknown Source)
+        at pro.p.a(Unknown Source)
+        at pro.bU.a(Unknown Source)
+        at pro.bo.a(Unknown Source)
+        at pro.J.a(Unknown Source)
+        at pro.I.a(Unknown Source)
+        at pro.J.a(Unknown Source)
+        at pro.cf.c(Unknown Source)
+        at pro.cf.a(Unknown Source)
+        at pro.bc.a(Unknown Source)
+        at proguard.ProGuard.a(Unknown Source)
+        at proguard.ProGuard.c(Unknown Source)
+        at proguard.ProGuard.b(Unknown Source)
+        at proguard.ProGuard.main(Unknown Source)
+
+

+ +We can still use the same command to recover the stack trace: +

+java -jar retrace.jar proguard.map proguard.trace
+
+

+ +The output will now give a list of alternative original method names for each +ambiguous obfuscated method name: +

+Exception in thread "main" java.lang.Error: Random exception
+        at proguard.shrink.UsageMarker.visitProgramClassFile(Unknown Source)
+                                       visitLibraryClassFile
+                                       visitProgramFieldInfo
+                                       visitProgramMethodInfo
+                                       visitMemberInfo
+                                       visitLibraryFieldInfo
+                                       visitLibraryMethodInfo
+                                       visitIntegerCpInfo
+                                       visitLongCpInfo
+                                       visitFloatCpInfo
+                                       visitDoubleCpInfo
+                                       visitStringCpInfo
+                                       visitUtf8CpInfo
+                                       visitFieldrefCpInfo
+                                       visitInterfaceMethodrefCpInfo
+                                       visitMethodrefCpInfo
+                                       visitClassCpInfo
+                                       visitNameAndTypeCpInfo
+                                       visitUnknownAttrInfo
+                                       visitInnerClassesAttrInfo
+                                       visitConstantValueAttrInfo
+                                       visitExceptionsAttrInfo
+                                       visitCodeAttrInfo
+                                       visitLineNumberTableAttrInfo
+                                       visitLocalVariableTableAttrInfo
+                                       visitSourceFileAttrInfo
+                                       visitDeprecatedAttrInfo
+                                       visitSyntheticAttrInfo
+                                       visitInstruction
+                                       visitCpInstruction
+                                       visitExceptionInfo
+                                       visitInnerClassesInfo
+                                       visitLocalVariableInfo
+                                       markCpEntry
+                                       markAsUnused
+                                       isUsed
+        at proguard.classfile.instruction.GenericInstruction.create(Unknown Source)
+                                                             isWide
+                                                             getLength
+                                                             accept
+        at proguard.classfile.CodeAttrInfo.getAttribute(Unknown Source)
+                                           getAttrInfoLength
+                                           readInfo
+                                           accept
+                                           instructionsAccept
+                                           exceptionsAccept
+        [...]
+        at proguard.KeepCommand.executeShrinkingPhase(Unknown Source)
+                                access$100
+        at proguard.KeepCommand.keepField(Unknown Source)
+                                ensureMultiClassFileVisitorForMembers
+                                execute
+                                executeObfuscationPhase
+                                access$002
+                                access$000
+                                access$102
+                                access$108
+        at proguard.CompoundCommand.addCommand(Unknown Source)
+                                    execute
+        at proguard.ProGuard.readCommands(Unknown Source)
+                             obfuscate
+                             executeCommands
+        at proguard.ProGuard.shrink(Unknown Source)
+        at proguard.ProGuard.check(Unknown Source)
+                             execute
+        at proguard.ProGuard.main(Unknown Source)
+
+

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/manual/retrace/index.html b/docs/manual/retrace/index.html new file mode 100644 index 0000000..ebb23ac --- /dev/null +++ b/docs/manual/retrace/index.html @@ -0,0 +1,25 @@ + + + + + + +ReTrace Manual + + + +

ReTrace

+ +
    +
  1. Introduction +
  2. Usage +
  3. Examples +
+ +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/retrace/introduction.html b/docs/manual/retrace/introduction.html new file mode 100644 index 0000000..19f9471 --- /dev/null +++ b/docs/manual/retrace/introduction.html @@ -0,0 +1,68 @@ + + + + + + +ReTrace Introduction + + + +

Introduction

+ +ReTrace is a companion tool for ProGuard that 'de-obfuscates' +stack traces. +

+When an obfuscated program throws an exception, the resulting stack trace +typically isn't very informative. Class names and method names have been +replaced by short meaningless strings. Source file names and line numbers are +missing altogether. While this may be intentional, it can also be inconvenient +when debugging problems. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Original code- ProGuard →Obfuscated code
↓↓
Mapping file↓
↓↓
Readable stack trace← ReTrace -Obfuscated stack trace
+

+ReTrace can read an obfuscated stack trace and restore it to what it would +look like without obfuscation. The restoration is based on the mapping file +that ProGuard can write out during obfuscation. The mapping file links the +original class names and class member names to their obfuscated names. +

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/manual/retrace/usage.html b/docs/manual/retrace/usage.html new file mode 100644 index 0000000..88587ff --- /dev/null +++ b/docs/manual/retrace/usage.html @@ -0,0 +1,117 @@ + + + + + + +ReTrace Usage + + + +

Usage

+ +You can find the ReTrace jar in the lib directory of the +ProGuard distribution. To run ReTrace, just type: +

+

+java -jar retrace.jar [options...] + mapping_file [stacktrace_file] +

+These are the arguments: + +
+
mapping_file
+ +
Specifies the name of the mapping file, produced by ProGuard with the + option + "-printmapping mapping_file", + while obfuscating the application that produced the stack trace.
+ +
stacktrace_file
+ +
Optionally specifies the name of the file containing the stack trace. If + no file is specified, a stack trace is read from the standard input. Blank + lines and unrecognized lines are ignored, as far as possible.
+
+ +The following options are supported: +
+
-verbose
+ +
Specifies to print out more informative stack traces that include not only + method names, but also method return types and arguments.
+ +
-regex regular_expression
+ +
Specifies the regular expression that is used to parse the lines in the + stack trace. Specifying a different regular expression allows to + de-obfuscate more general types of input than just stack traces. The + default is suitable for stack traces produced by most JVMs: + 
+    (?:\s*%c:.*)|(?:\s*at\s+%c.%m\s*\(.*?(?::%l)?\)\s*)
+
+ The regular expression is a Java regular expression (cfr. the documentation + of java.util.regex.Pattern), with a few additional wildcards: + + + + + + + + + + + + + + + +
%cmatches a class name (e.g. + "myapplication.MyClass").
%Cmatches a class name with slashes (e.g. + "myapplication/MyClass").
%tmatches a field type or method return type (e.g. + "myapplication.MyClass[]").
%fmatches a field name (e.g. + "myField").
%mmatches a method name (e.g. + "myMethod").
%amatches a list of method arguments (e.g. + "boolean,int").
%lmatches a line number inside a method (e.g. + "123").
+ Elements that match these wildcards are de-obfuscated, when possible. Note + that regular expressions must not contain any capturing groups. Use + non-capturing groups instead: (?:...) +
+
+ +The restored stack trace is printed to the standard output. The completeness +of the restored stack trace depends on the presence of line number tables in +the obfuscated class files: + +
    +
  • If all line numbers have been preserved while obfuscating the application, + ReTrace will be able to restore the stack trace completely. +

    + +

  • If the line numbers have been removed, mapping obfuscated method names + back to their original names has become ambiguous. Retrace will list all + possible original method names for each line in the stack trace. The user + can then try to deduce the actual stack trace manually, based on the logic + of the program. + +
+

+ +Preserving line number tables is explained in detail in this example in the ProGuard User Manual. +

+ +Unobfuscated elements and obfuscated elements for which no mapping is available +will be left unchanged. +

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/manual/sections.html b/docs/manual/sections.html new file mode 100644 index 0000000..62df9c3 --- /dev/null +++ b/docs/manual/sections.html @@ -0,0 +1,64 @@ + + + + + + + +Sections + + + + + +

+

+With support of +

+ + + + + + + + +

+ +Luciad + +

+ +Luciad +

+ + + diff --git a/docs/manual/style.css b/docs/manual/style.css new file mode 100644 index 0000000..28fc112 --- /dev/null +++ b/docs/manual/style.css @@ -0,0 +1,92 @@ +@charset "iso-8859-1"; + +/* Global settings. */ + +body { + background: #FFFFFF; +} + +h1 { + text-align: center; +} + +h2 { + background: #EEEEFF; + padding: 10px; +} + +dt { + padding: 6px; +} + +dt div +{ + color: grey; + float: right; +} + +dd { + padding: 6px; +} + +pre { + padding: 10px; + background: #E0E0E0; +} + +a +{ + text-decoration: none; +} + +/* Settings for variable width code. */ + +p.code { + padding: 10px; + background: #E0E0E0; +} + + +/* Settings for diagrams. */ + +table.diagram { + padding: 8px; + border: none; + border-spacing: 2px; +} + +td.transparentblock { + text-align: center; + padding: 10px 0px; +} + +td.whiteblock { + width: 100px; + text-align: center; + border: solid #C0C0C0 1px; + background: #E0E0E0; + padding: 10px 0px; +} + +td.lightblock { + width: 100px; + text-align: center; + border: solid #8888FF 1px; + background: #BBBBFF; + padding: 20px 0px; +} + +td.darkblock { + width: 100px; + text-align: center; + background: #8888FF; + padding: 20px 0px; +} + +/* Settings for buttons. */ + +td.button { + background: #E0E0E0; + border: outset #FFFFFF 1px; + font-weight: bold; +} diff --git a/docs/manual/troubleshooting.html b/docs/manual/troubleshooting.html new file mode 100644 index 0000000..d3ed14e --- /dev/null +++ b/docs/manual/troubleshooting.html @@ -0,0 +1,592 @@ + + + + + + +ProGuard Troubleshooting + + + +

Troubleshooting

+ +While preparing a configuration for processing your code, you may bump into a +few problems. The following sections discuss some common issues and solutions: + +

Problems while processing

+ + +

Unexpected observations after processing

+ + +

Problems while preverifying for Java Micro Edition

+ + + +

Problems at run-time

+ + + +  +

Problems while processing

+ +ProGuard may print out some notes and non-fatal warnings: + +
+
Note: can't find dynamically referenced class
+ +
ProGuard can't find a class or interface that your code is accessing by + means of introspection. You should check if you want to add the jar that + contains this class.
+ +
Note: ... calls '(...)Class.forName(variable).newInstance()'
+ +
ProGuard lists all class casts of dynamically created class instances, + like "(MyClass)Class.forName(variable).newInstance()". + Depending on your application, you may need to keep the mentioned classes + with an option like "-keep class MyClass", or their + implementations with an option like "-keep class * implements + MyClass". You can switch off these notes by specifying the + -dontnote option.
+ +
Note: ... accesses a field/method '...' dynamically
+ +
ProGuard lists a number of constructs like + ".getField("myField")". Depending on your application, you + may need to figure out where the mentioned class members are defined and + keep them with an option like "-keep class MyClass { MyFieldType + myField; }". Otherwise, ProGuard might remove or obfuscate the + class members, since it can't know which ones they are exactly. It does + list possible candidates, for your information. You can switch off these + notes by specifying the -dontnote option.
+ +
Note: the configuration keeps the entry point '...', but not the descriptor class '...'
+ +
Your configuration contains a -keep option to preserve the + given method (or field), but no -keep option for the given + class that is an argument type or return type in the method's descriptor. + You may then want to keep the class too. Otherwise, ProGuard will + obfuscate its name, thus changing the method's signature. The method might + then become unfindable as an entry point, e.g. if it is part of a public + API. You can switch off these notes by specifying the -dontnote option.
+ +
Note: duplicate definition of program/library class
+ +
Your program jars or library jars contain multiple definitions of the + listed classes. ProGuard continues processing as usual, only considering + the first definitions. The warning may be an indication of some problem + though, so it's advisable to remove the duplicates. A convenient way to do + so is by specifying filters on the input jars or library jars. You can + switch off these notes by specifying the -dontnote option.
+ +
Warning: can't write resource ... Duplicate zip entry
+ +
Your input jars contain multiple resource files with the same name. + ProGuard continues copying the resource files as usual, skipping any files + with previously used names. Once more, the warning may be an indication of + some problem though, so it's advisable to remove the duplicates. A + convenient way to do so is by specifying filters on the input jars. There + is no option to switch off these warnings.
+ +
+

+ +ProGuard may terminate when it encounters parsing errors or I/O errors, or +some more serious warnings: + +

+
Warning: can't find superclass or interface
Warning: can't find referenced class
+ +
If there are unresolved references to classes or interfaces, you most + likely forgot to specify an essential library. For proper processing, all + libraries that are referenced by your code must be specified, including + the Java run-time library. For specifying libraries, use + the -libraryjars option. +

+ If the class that is reported as missing is a non-public library class, + you should specify the -dontskipnonpubliclibraryclasses + option. Common examples are the classes + javax.swing.TransferHandler$HasGetTransferHandler and + java.util.zip.ZipConstants, which are used as interfaces in + some public classes, even though they are only package visible. This + option is not set by default for reasons of efficiency. Setting it increases + the processing time a bit, but it won't hurt the output in any way. +

+ If you're missing a library and you're absolutely sure it isn't used + anyway, you can try your luck with the -ignorewarnings option, + or even the -dontwarn + option. Only use these options if you really know what you're doing + though.

+ +
Warning: can't find referenced field/method
+ +
If there are unresolved references to class members in input classes, your + class files are most likely inconsistent. Possibly, some class file didn't + get recompiled properly, or some class file was left behind after its + source file was removed. Try removing all class files, recompiling them, + zipping them up, and running ProGuard again. +

+ If the class member that is reported as missing is actually implemented in + a non-public library class, you should specify the + -dontskipnonpubliclibraryclasses option. A common example is + the method setLength(int) in the public class + java.lang.StringBuilder. This method is actually defined in + the package visible superclass + java.lang.AbstractStringBuilder, which ProGuard ignores by + default. +

+ If your program classes reside in the same packages as library classes, + and refer to their package visible class members, then you should specify + the -dontskipnonpubliclibraryclassmembers + option.

+ +
Warning: can't find enclosing class/method
+ +
If there are unresolved references to classes that are defined inside + methods in your input, once more, your class files are most likely + inconsistent. Possibly, some class file didn't get recompiled properly, or + some class file was left behind after its source file was removed. Try + removing all class files, recompiling them, zipping them up, and running + ProGuard again.
+ +
Warning: library class ... depends on program class ...
+ +
If any of your library classes depend on your program classes, by + extending, implementing or just referencing them, your processed code will + generally be unusable. Program classes can depend on library classes, but + not the other way around. Program classes are processed, while library + classes always remain unchanged. It is therefore impossible to adapt + references from library classes to program classes, for instance if the + program classes are renamed. You should define a clean separation between + program code and library code, and try again.
+ +
Warning: class file ... unexpectedly contains class ...
+ +
The given class file contains a definition for the given class, but the + directory name of the file doesn't correspond to the package name of the + class. ProGuard will accept the class definition, but the current + implementation will not write out the processed version. Please make sure + your input classes are packaged correctly. Notably, class files that are + in the WEB-INF/classes directory in a war should be packaged + in a jar and put in the WEB-INF/lib directory. If you don't + mind these classes not being written to the output, you can specify the -ignorewarnings option, + or even the -dontwarn + option.
+ +
Warning: ... is not being kept as ..., but remapped to ...
+ +
There is a conflict between a -keep option in the + configuration, and the mapping file, in the obfuscation step. The given + class name or class member name can't be kept by its original name, as + specified in the configuration, but it has to be mapped to the other given + name, as specified in the mapping file. You should adapt your + configuration or your mapping file to remove the conflict. Alternatively, + if you're sure the renaming won't hurt, you can specify the -ignorewarnings option, + or even the -dontwarn + option.
+ +
Warning: field/method ... can't be mapped to ...
+ +
There is a conflict between some new program code and the mapping file, in + the obfuscation step. The given class member can't be mapped to the given + name, because it would conflict with another class member that is already + being mapped to the same name. This can happen if you are performing + incremental obfuscation, applying an obfuscation mapping file from an + initial obfuscation step. For instance, some new class may have been added + that extends two existing classes, introducing a conflict in the name + space of its class members. If you're sure the class member receiving + another name than the one specified won't hurt, you can specify the -ignorewarnings option, + or even the -dontwarn + option. Note that you should always use the -useuniqueclassmembernames + option in the initial obfuscation step, in order to reduce the risk of + conflicts.
+ +
Error: You have to specify '-keep' options
+ +
You either forgot to specify -keep options, or you mistyped the + class names. ProGuard has to know exactly what you want to keep: an + application, an applet, a servlet, a midlet,..., or any combination of + these. Without the proper seed specifications, ProGuard would shrink, + optimize, or obfuscate all class files away.
+ + +
Error: Expecting class path separator ';' before 'Files\Java\...' (in Windows)
+ +
If the path of your run-time jar contains spaces, like in "Program Files", + you have to enclose it with single or double quotes, as explained in the + section on file names. This is actually + true for all file names containing special characters, on all + platforms.
+ +
Error: Can't read [.../lib/rt.jar] (No such file or directory) (in MacOS X)
+ +
In MacOS X, the run-time classes may be in a different place than on most + other platforms. You'll then have to adapt your configuration, replacing + the path <java.home>/lib/rt.jar by + <java.home>/../Classes/classes.jar.
+ +
+

+ +Should ProGuard crash while processing your application: + +

+
OutOfMemoryError
+ +
You can try increasing the heap size of the Java virtual machine (with the + usual -Xms and -Xmx options). You can also + reduce the amount of memory that ProGuard needs by removing unnecessary + library jars from your configuration, or by filtering out unused library + packages and classes. Remember that only classes or interfaces that are + extended or implemented by classes in your input jars are required.
+ +
StackOverflowError
+ +
This error might occur when processing a large code base on Windows + (surprisingly, not so easily on Linux). In theory, increasing the stack + size of the Java virtual machine (with the usual -Xss option) + should help too. In practice however, the -Xss setting + doesn't have any effect on the main thread, due to Sun Bug + #4362291. As a result, this solution will only work when running + ProGuard in a different thread, e.g. from its GUI.
+ +
Unexpected error
+ +
ProGuard has encountered an unexpected condition, typically in the + optimization step. It may or may not recover. You should be able to avoid + it using the -dontoptimize option. In + any case, please report the problem, preferably with the simplest example + that causes ProGuard to crash.
+ +
Otherwise...
+ +
Maybe your class files are corrupt. See if recompiling them and trying + again helps. If not, please report the problem, preferably with the + simplest example that causes ProGuard to crash.
+ +
+

+ +  +

Unexpected observations after processing

+ +If ProGuard seems to run fine, but your processed code doesn't look right, +there might be a couple of reasons: + +
+
Disappearing classes
+ +
If you are working on Windows and it looks like some classes have + disappeared from your output, you should make sure you're not writing your + output class files to a directory (or unpacking the output jar). On + platforms with case-insensitive file systems, such as Windows, unpacking + tools often let class files with similar lower-case and upper-case names + overwrite each other. If you really can't switch to a different operating + system, you could consider using ProGuard's -dontusemixedcaseclassnames + option. +

+ Also, you should make sure your class files are in directories that + correspond to their package names. ProGuard will read misplaced class + files, but it will currently not write their processed versions. Notably, + class files that are in the WEB-INF/classes directory in a + war should be packaged in a jar and put in the WEB-INF/lib + directory.

+ +
Classes or class members not being kept
+ +
If ProGuard is not keeping the right classes or class members, make sure + you are using fully qualified class names. If the package name of some + class is missing, ProGuard won't match the elements that you might be + expecting. It may help to double-check for typos too. You can use the -printseeds option to see + which elements are being kept exactly. +

+ If you are using marker interfaces to keep other classes, the marker + interfaces themselves are probably being removed in the shrinking step. + You should therefore always explicitly keep any marker interfaces.

+ +
Variable names not being obfuscated
+ +
If the names of the local variables and parameters in your obfuscated code + don't look obfuscated, because they suspiciously resemble the names of + their types, it's probably because the decompiler that you are using is + coming up with those names. ProGuard's obfuscation step does remove the + original names entirely, unless you explicitly keep the + LocalVariableTable or LocalVariableTypeTable + attributes.
+ +
+ +  +

Problems while preverifying for Java Micro Edition

+ +If ProGuard seems to run fine, but the external preverifier subsequently +produces errors, it's usually for a single reason: + +
+
InvalidClassException, class loading error, or verification error
+ +
If you get any such message from the preverifier, you are probably working + on a platform with a case-insensitive file system, such as Windows. The + preverify tool always unpacks the jars, so class files with + similar lower-case and upper-case names overwrite each other. You can use + ProGuard's -dontusemixedcaseclassnames + option to work around this problem. +

+ If the above doesn't help, there is probably a bug in the optimization + step of ProGuard. Make sure you are using the latest version. You should + be able to work around the problem by using the -dontoptimize option. You + can check the bug database to see if it is a known problem (often with a + fix). Otherwise, please report it, preferably with the simplest example on + which you can find ProGuard to fail.

+ +
+ +Note that it is no longer necessary to use an external preverifier. With the +-microedition option, +ProGuard will preverify the class files for Java Micro Edition. +

+ +  +

Problems at run-time

+ +If ProGuard runs fine, but your processed application doesn't work, there +might be several reasons: + +
+
Stack traces without class names or line numbers
+ +
If your stack traces don't contain any class names or lines numbers, + even though you are keeping the proper attributes, make sure this debugging + information is present in your compiled code to start with. Notably the Ant + javac task has debugging information switched off by default.
+ +
NoClassDefFoundError
+ +
Your class path is probably incorrect. It should at least contain all + library jars and, of course, your processed program jar.
+ +
ClassNotFoundException
+ +
Your code is probably calling Class.forName, trying to create + the missing class dynamically. ProGuard can only detect constant name + arguments, like Class.forName("mypackage.MyClass"). For + variable name arguments like Class.forName(someClass), you + have to keep all possible classes using the appropriate -keep option, e.g. "-keep + class mypackage.MyClass" or "-keep class * implements + mypackage.MyInterface".
+ +
NoSuchMethodException
+ +
Your code is probably calling something like + myClass.getMethod, trying to find some method dynamically. + Since ProGuard isn't detecting this (yet), you have to keep the missing + method in using the appropriate -keep option, e.g. "-keep + class mypackage.MyClass { void myMethod(); }".
+ +
MissingResourceException or NullPointerException
+ +
Your processed code may be unable to find some resource files. ProGuard + simply copies resource files over from the input jars to the output jars. + Their names and contents remain unchanged, unless you specify the options + -adaptresourcefilenames + and/or -adaptresourcefilecontents. +

+ Furthermore, directory entries in jar files aren't copied, unless you + specify the option -keepdirectories.

+ +
Invalid or corrupt jarfile
+ +
You are probably starting your application with the java option + -jar instead of the option -classpath. The java + virtual machine returns with this error message if your jar doesn't + contain a manifest file (META-INF/MANIFEST.MF), if the + manifest file doesn't specify a main class (Main-Class: ...), + or if the jar doesn't contain this main class. You should then make sure + that the input jar contains a valid manifest file to start with, that this + manifest file is the one that is copied (the first manifest file that is + encountered), and that the main class is kept in your configuration,
+ +
InvalidClassException, class loading error, or verification error (in Java Micro Edition)
+ +
If you get such an error in Java Micro Edition, you may have forgotten to + specify the -microedition option, so + the processed class files are preverified properly.
+ +
Error: No Such Field or Method, Error verifying method (in a Java Micro Edition emulator)
+ +
If you get such a message in a Motorola or Sony Ericsson phone emulator, + it's because these emulators don't like packageless classes and/or + overloaded fields and methods. You can work around it by not using the + options -repackageclasses + '' and -overloadaggressively. + If you're using the JME WTK plugin, you can adapt the configuration + proguard/wtk/default.pro that's inside the + proguard.jar.
+ +
Failing midlets (on a Java Micro Edition device)
+ +
If your midlet runs in an emulator and on some devices, but not on some + other devices, this is probably due to a bug in the latter devices. For + some older Motorola and Nokia phones, you might try specifying the -useuniqueclassmembernames + option. It avoids overloading class member names, which triggers a bug in + their java virtual machine. +

+ You might also try using the -dontusemixedcaseclassnames + option. Even if the midlet has been properly processed and then + preverified on a case-sensitive file system, the device itself might not + like the mixed-case class names. Notably, the Nokia N-Gage emulator works + fine, but the actual device seems to exhibit this problem.

+ +
Disappearing loops
+ +
If your code contains empty busy-waiting loops, ProGuard's optimization + step may remove them. More specifically, this happens if a loop + continuously checks the value of a non-volatile field that is changed in a + different thread. The specifications of the Java Virtual Machine require + that you always mark fields that are accessed across different threads + without further synchronization as volatile. If this is not + possible for some reason, you'll have to switch off optimization using the + -dontoptimize + option.
+ +
SecurityException: SHA1 digest error
+ +
You may have forgotten to sign your program jar after having + processed it with ProGuard.
+ +
ClassCastException: class not an enum, or
IllegalArgumentException: class not an enum type
+ +
You should make sure you're preserving the special methods of enumeration + types, which the run-time environment calls by introspection. The required + options are shown in the examples.
+ +
ArrayStoreException: sun.reflect.annotation.EnumConstantNotPresentExceptionProxy
+ +
You are probably processing annotations involving enumerations. Again, you + should make sure you're preserving the special methods of the enumeration + type, as shown in the examples.
+ +
CompilerError: duplicate addition
+ +
You are probably compiling or running some code that has been obfuscated + with the -overloadaggressively + option. This option triggers a bug in + sun.tools.java.MethodSet.add in Sun's JDK 1.2.2, which is + used for (dynamic) compilation. You should then avoid this option.
+ +
ClassFormatError: repetitive field name/signature
+ +
You are probably processing some code that has been obfuscated before with + the -overloadaggressively + option. You should then use the same option again in the second processing + round.
+ +
NoSuchMethodError or AbstractMethodError
+ +
You should make sure you're not writing your output class files to a + directory on a platform with a case-insensitive file system, such as + Windows. Please refer to the section about disappearing classes for details. +

+ Furthermore, you should check whether you have specified your program jars + and library jars properly. Program classes can refer to library classes, + but not the other way around. +

+ If all of this seems ok, perhaps there's a bug in ProGuard (gasp!). If so, + please report it, preferably with the simplest example on which you can + find ProGuard to fail.

+ +
VerifyError
+ +
Verification errors when executing a program are almost certainly the + result of a bug in the optimization step of ProGuard. Make sure you are + using the latest version. You should be able to work around the problem by + using the -dontoptimize + option. You can check the bug database to see if it is a known problem + (often with a fix). Otherwise, please report it, preferably with the + simplest example on which ProGuard fails.
+ +
+ +
+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/usage.html b/docs/manual/usage.html new file mode 100644 index 0000000..8be8d60 --- /dev/null +++ b/docs/manual/usage.html @@ -0,0 +1,1231 @@ + + + + + + +ProGuard Usage + + + +

Usage

+ +To run ProGuard, just type: +

+java -jar proguard.jar options ... +

+You can find the ProGuard jar in the lib directory of the +ProGuard distribution. Options can also be put in one or more configuration +files. Typically, you'll put most options in a configuration file (say, +myconfig.pro), and just call: +

+java -jar proguard.jar @myconfig.pro +

+You can combine command line options and options from configuration files, for +instance: +

+java -jar proguard.jar @myconfig.pro -verbose +

+

+In a configuration file, a # sign and all remaining +characters on that line are ignored, allowing you to add comments. +

+Extra whitespace between words and delimiters is ignored. To specify file +names with spaces or special characters, words can be quoted with single or +double quotes. Note that the quotes may need to be escaped when used on the +command line, to avoid them being gobbled by the shell. +

+Options can be grouped arbitrarily in arguments on the command line and in +lines in configuration files. This means that you can quote any arbitrary +section of command line options, to avoid shell expansion of special +characters, for instance. +

+The order of the options is generally irrelevant. They can be abbreviated to +their first unique characters. +

+ +The sections below provide more details: +

+ +  +

Input/Output Options

+ +
+
@filename
+ +
Short for '-include + filename'.
+ +
-include + filename
+ +
Recursively reads configuration options from the given file + filename.
+ +
-basedirectory + directoryname
+ +
Specifies the base directory for all subsequent relative file names in + these configuration arguments or this configuration file.
+ +
-injars + class_path
+ +
Specifies the input jars (or wars, ears, zips, or directories) of the + application to be processed. The class files in these jars will be + processed and written to the output jars. By default, any non-class files + will be copied without changes. Please be aware of any temporary files + (e.g. created by IDEs), especially if you are reading your input files + straight from directories. The entries in the class path can be filtered, + as explained in the filters section. For better + readability, class path entries can be specified using multiple + -injars options.
+ +
-outjars + class_path
+ +
Specifies the names of the output jars (or wars, ears, zips, or + directories). The processed input of the preceding -injars + options will be written to the named jars. This allows you to collect the + contents of groups of input jars into corresponding groups of output jars. + In addition, the output entries can be filtered, as explained in + the filters section. Each processed class file + or resource file is then written to the first output entry with a matching + filter, within the group of output jars. +

+ You must avoid letting the output files overwrite any input files. For + better readability, class path entries can be specified using multiple + -outjars options. Without any -outjars options, + no jars will be written.

+ +
-libraryjars + class_path
+ +
Specifies the library jars (or wars, ears, zips, or directories) of the + application to be processed. The files in these jars will not be included + in the output jars. The specified library jars should at least contain the + class files that are extended by application class files. Library + class files that are only called needn't be present, although their + presence can improve the results of the optimization step. The entries in + the class path can be filtered, as explained in the filters section. For better readability, class path + entries can be specified using multiple -libraryjars options. +

+ Please note that the boot path and the class path set for running ProGuard + are not considered when looking for library classes. This means that you + explicitly have to specify the run-time jar that your code will use. + Although this may seem cumbersome, it allows you to process applications + targeted at different run-time environments. For example, you can process + J2SE applications as well as JME midlets, just by specifying the + appropriate run-time jar.

+ +
-dontskipnonpubliclibraryclasses
+ +
Specifies not to ignore non-public library classes. By default, non-public + library classes are skipped while parsing library jars. The classes are + typically not relevant during processing, since they don't affect the + actual program code in the input jars. Ignoring them reduces memory usage + and processing time. Occasionally, a badly designed library may contain a + non-public library class that is extended/implemented by a public library + class. If the latter library class in turn is extended/implemented by a + program class, ProGuard will complain that it can't find the non-public + library class, which it had ignored during parsing. This option will + overcome that problem, at the cost of greater memory usage and longer + processing time.
+ +
-dontskipnonpubliclibraryclassmembers
+ +
Specifies not to ignore package visible library class members (fields and + methods). By default, these class members are skipped while parsing + library classes, as program classes will generally not refer to them. + Sometimes however, program classes reside in the same packages as library + classes, and they do refer to their package visible class members. In + those cases, it can be useful to actually read the class members, in order + to make sure the processed code remains consistent.
+ +
-keepdirectories + [directory_filter]
+ +
Specifies the directories to be kept in the output jars (or wars, ears, or + directories). By default, directory entries are removed. This reduces the + jar size, but it may be undesirable if the program code tries to find them + with constructs like "MyClass.class.getResource("")". If the + option is specified without a filter, all directories are kept. With a + filter, only matching directories are kept.
+ +
-target version
+ +
Specifies the version number to be set in the processed class files. The + version number can be one of 1.0, 1.1, + 1.2, 1.3, 1.4, 1.5 (or + just 5), or 1.6 (or just 6). By + default, the version numbers of the class files are left unchanged. For + example, you may want to upgrade class + files to Java 6, by changing their version numbers and having them + preverified.
+ +
-forceprocessing
+ +
Specifies to process the input, even if the output seems up to date. The + up-to-dateness test is based on a comparison of the date stamps of the + specified input, output, and configuration files or directories.
+ +
+

+ +  +

Keep Options

+ +
+
-keep + [,modifier,...] + class_specification
+ +
Specifies classes and class members (fields and methods) to be preserved + as entry points to your code. For example, in order to keep an application, you can specify + the main class along with its main method. In order to process a library, you should specify all + publicly accessible elements.
+ +
-keepclassmembers + [,modifier,...] + class_specification
+ +
Specifies class members to be preserved, if their classes are preserved as + well. For example, you may want to keep all serialization fields and + methods of classes that implement the Serializable + interface.
+ +
-keepclasseswithmembers + [,modifier,...] + class_specification
+ +
Specifies classes and class members to be preserved, on the condition that + all of the specified class members are present. For example, you may want + to keep all applications that + have a main method, without having to list them explicitly.
+ +
-keepnames + class_specification
+ +
Short for -keep,allowshrinking + class_specification +

+ Specifies classes and class members whose names are to be preserved, if + they aren't removed in the shrinking phase. For example, you may want to + keep all class names of classes + that implement the Serializable interface, so that the + processed code remains compatible with any originally serialized classes. + Classes that aren't used at all can still be removed. Only applicable when + obfuscating.

+ +
-keepclassmembernames + class_specification
+ +
Short for -keepclassmembers,allowshrinking + class_specification +

+ Specifies class members whose names are to be preserved, if they aren't + removed in the shrinking phase. For example, you may want to preserve the + name of the synthetic class$ methods when processing a library, so obfuscators can + detect it again when processing an application that uses the processed + library (although ProGuard itself doesn't need this). Only applicable when + obfuscating.

+ +
-keepclasseswithmembernames + class_specification
+ +
Short for -keepclasseswithmembers,allowshrinking + class_specification +

+ Specifies classes and class members whose names are to be preserved, on + the condition that all of the specified class members are present after + the shrinking phase. For example, you may want to keep all native method names and the names + of their classes, so that the processed code can still link with the + native library code. Native methods that aren't used at all can still be + removed. If a class file is used, but none of its native methods are, its + name will still be obfuscated. Only applicable when obfuscating.

+ +
-printseeds + [filename]
+ +
Specifies to exhaustively list classes and class members matched by the + various -keep options. The list is printed to the standard + output or to the given file. The list can be useful to verify if the + intended class members are really found, especially if you're using + wildcards. For example, you may want to list all the applications or all the applets that you are keeping.
+ +
+

+ +  +

Shrinking Options

+ +
+
-dontshrink
+ +
Specifies not to shrink the input class files. By default, shrinking is + applied; all classes and class members are removed, except for the ones + listed by the various -keep options, and the ones on which + they depend, directly or indirectly. A shrinking step is also applied + after each optimization step, since some optimizations may open the + possibility to remove more classes and class members.
+ +
-printusage + [filename]
+ +
Specifies to list dead code of the input class files. The list is printed + to the standard output or to the given file. For example, you can list the unused code of an application. + Only applicable when shrinking.
+ +
-whyareyoukeeping + class_specification
+ +
Specifies to print details on why the given classes and class members are + being kept in the shrinking step. This can be useful if you are wondering + why some given element is present in the output. In general, there can be + many different reasons. This option prints the shortest chain of methods + to a specified seed or entry point, for each specified class and class + member. In the current implementation, the shortest chain that is + printed out may sometimes contain circular deductions -- these do not + reflect the actual shrinking process. If the -verbose option if specified, the traces + include full field and method signatures. Only applicable when + shrinking.
+ +
+

+ +  +

Optimization Options

+ +
+
-dontoptimize
+ +
Specifies not to optimize the input class files. By default, optimization + is enabled; all methods are optimized at a bytecode level.
+ +
-optimizations + optimization_filter
+ +
Specifies the optimizations to be enabled and disabled, at a more + fine-grained level. Only applicable when optimizing. This is an expert + option.
+ +
-optimizationpasses n
+ +
Specifies the number of optimization passes to be performed. By default, a + single pass is performed. Multiple passes may result in further + improvements. If no improvements are found after an optimization pass, the + optimization is ended. Only applicable when optimizing.
+ +
-assumenosideeffects + class_specification
+ +
Specifies methods that don't have any side effects (other than maybe + returning a value). In the optimization step, ProGuard will then remove + calls to such methods, if it can determine that the return values aren't + used. Note that ProGuard will analyze your program code to find such + methods automatically. It will not analyze library code, for which this + option can thus be useful. For example, you could specify the method + System.currentTimeMillis(), so that any idle calls to it will + be removed. Note that ProGuard applies the option to the entire hierarchy + of the specified methods. Only applicable when optimizing. In general, + making assumptions can be dangerous; you can easily break the processed + code. Only use this option if you know what you're doing!
+ +
-allowaccessmodification
+ +
Specifies that the access modifiers of classes and class members may be + broadened during processing. This can improve the results of the + optimization step. For instance, when inlining a public getter, it may be + necessary to make the accessed field public too. Although Java's binary + compatibility specifications formally do not require this (cfr. The Java Language Specification, Second Edition, Section 13.4.6), some virtual machines would have problems with the + processed code otherwise. Only applicable when optimizing (and when + obfuscating with the -repackageclasses option). +

+ Counter-indication: you probably shouldn't use this option when + processing code that is to be used as a library, since classes and class + members that weren't designed to be public in the API may become + public.

+ +
-mergeinterfacesaggressively
+ +
Specifies that interfaces may be merged, even if their implementing + classes don't implement all interface methods. This can reduce the size of + the output by reducing the total number of classes. Note that Java's + binary compatibility specifications allow such constructs (cfr. The Java Language Specification, Second Edition, Section 13.5.3), even if they are not allowed in the Java language + (cfr. The Java Language Specification, Second Edition, Section 8.1.4). Only applicable when optimizing. +

+ Counter-indication: setting this option can reduce the performance + of the processed code on some JVMs, since advanced just-in-time + compilation tends to favor more interfaces with fewer implementing + classes. Worse, some JVMs may not be able to handle the resulting code. + Notably: +

    +
  • Sun's JRE 1.3 may throw an InternalError when + encountering more than 256 Miranda methods (interface methods + without implementations) in a class. +
+ +
+

+ +  +

Obfuscation Options

+ +
+
-dontobfuscate
+ +
Specifies not to obfuscate the input class files. By default, obfuscation + is applied; classes and class members receive new short random names, + except for the ones listed by the various -keep options. + Internal attributes that are useful for debugging, such as source files + names, variable names, and line numbers are removed.
+ +
-printmapping + [filename]
+ +
Specifies to print the mapping from old names to new names for classes and + class members that have been renamed. The mapping is printed to the + standard output or to the given file. For example, it is required for + subsequent incremental + obfuscation, or if you ever want to make sense again of obfuscated stack traces. Only + applicable when obfuscating.
+ +
-applymapping + filename
+ +
Specifies to reuse the given name mapping that was printed out in a + previous obfuscation run of ProGuard. Classes and class members that are + listed in the mapping file receive the names specified along with them. + Classes and class members that are not mentioned receive new names. The + mapping may refer to input classes as well as library classes. This option + can be useful for incremental + obfuscation, i.e. processing add-ons or small patches to an existing + piece of code. In such cases, you should consider whether you also need + the option -useuniqueclassmembernames. + Only applicable when obfuscating.
+ +
-obfuscationdictionary + filename
+ +
Specifies a text file from which all valid words are used as obfuscated + field and method names. By default, short names like 'a', 'b', etc. are + used as obfuscated names. With an obfuscation dictionary, you can specify + a list of reserved key words, or identifiers with foreign characters, for + instance. White space, punctuation characters, duplicate words, and + comments after a # sign are ignored. Note that an + obfuscation dictionary hardly improves the obfuscation. Decent compilers + can automatically replace them, and the effect can fairly simply be undone + by obfuscating again with simpler names. The most useful application is + specifying strings that are typically already present in class files (such + as 'Code'), thus reducing the class file sizes just a little bit more. + Only applicable when obfuscating.
+ +
-classobfuscationdictionary + filename
+ +
Specifies a text file from which all valid words are used as obfuscated + class names. The obfuscation dictionary is similar to the one of the + option -obfuscationdictionary. + Only applicable when obfuscating.
+ +
-packageobfuscationdictionary + filename
+ +
Specifies a text file from which all valid words are used as obfuscated + package names. The obfuscation dictionary is similar to the one of the + option -obfuscationdictionary. + Only applicable when obfuscating.
+ +
-overloadaggressively
+ +
Specifies to apply aggressive overloading while obfuscating. Multiple + fields and methods can then get the same names, as long as their arguments + and return types are different (not just their arguments). This option can + make the processed code even smaller (and less comprehensible). Only + applicable when obfuscating. +

+ Counter-indication: the resulting class files fall within the Java + bytecode specification (cfr. The Java Virtual Machine Specification, Second Edition, first + paragraphs of Section 4.5 and Section 4.6), even though this kind of overloading is not allowed in + the Java language (cfr. The Java Language Specification, Second Edition, Section 8.3 and Section 8.4.7). Still, some tools have problems with it. Notably: +

    +
  • Sun's JDK 1.2.2 javac compiler produces an exception when + compiling with such a library (cfr. Bug + #4216736). You probably shouldn't use this option for processing + libraries. +
  • Sun's JRE 1.4 and later fail to serialize objects with overloaded + primitive fields. +
  • Sun's JRE 1.5 pack200 tool reportedly has problems with + overloaded class members. +
+ +
-useuniqueclassmembernames
+ +
Specifies to assign the same obfuscated names to class members that have + the same names, and different obfuscated names to class members that have + different names (for each given class member signature). Without the + option, more class members can be mapped to the same short names like 'a', + 'b', etc. The option therefore increases the size of the resulting code + slightly, but it ensures that the saved obfuscation name mapping can + always be respected in subsequent incremental obfuscation steps. +

+ For instance, consider two distinct interfaces containing methods with the + same name and signature. Without this option, these methods may get + different obfuscated names in a first obfuscation step. If a patch is then + added containing a class that implements both interfaces, ProGuard will + have to enforce the same method name for both methods in an incremental + obfuscation step. The original obfuscated code is changed, in order to + keep the resulting code consistent. With this option in the initial + obfuscation step, such renaming will never be necessary. +

+ This option is only applicable when obfuscating. In fact, if you are + planning on performing incremental obfuscation, you probably want to avoid + shrinking and optimization altogether, since these steps could remove or + modify parts of your code that are essential for later additions.

+ +
-dontusemixedcaseclassnames
+ +
Specifies not to generate mixed-case class names while obfuscating. By + default, obfuscated class names can contain a mix of upper-case characters + and lower-case characters. This creates perfectly acceptable and usable + jars. Only if a jar is unpacked on a platform with a case-insensitive + filing system (say, Windows), the unpacking tool may let similarly named + class files overwrite each other. Code that self-destructs when it's + unpacked! Developers who really want to unpack their jars on Windows can + use this option to switch off this behavior. Note that the obfuscated jars + will become larger as a result. Only applicable when obfuscating.
+ +
-keeppackagenames + [package_filter]
+ +
Specifies not obfuscate the given package names. The optional filter is a + comma-separated list of package names. Package names can contain ?, + *, and ** wildcards, and they can be preceded by the + ! negator. Only applicable when obfuscating.
+ +
-flattenpackagehierarchy + [package_name]
+ +
Specifies to repackage all packages that are renamed, by moving them into + the single given parent package. Without argument or with an empty string + (''), the packages are moved into the root package. This option is one + example of further obfuscating package + names. It can make the processed code smaller and less comprehensible. + Only applicable when obfuscating.
+ +
-repackageclasses + [package_name]
+ +
Specifies to repackage all class files that are renamed, by moving them + into the single given package. Without argument or with an empty string + (''), the package is removed completely. This option option overrides the + -flattenpackagehierarchy + option. It is another example of further obfuscating package names. It can + make the processed code even smaller and less comprehensible. Its + deprecated name is -defaultpackage. Only applicable when + obfuscating. +

+ Counter-indication: classes that look for resource files in their + package directories will no longer work properly if they are moved + elsewhere. When in doubt, just leave the packaging untouched by not using + this option.

+ +
-keepattributes + [attribute_filter]
+ +
Specifies any optional attributes to be preserved. The attributes can be + specified with one or more -keepattributes directives. The + optional filter is a comma-separated list of attribute names. Attribute + names can contain ?, *, and ** wildcards, and they + can be preceded by the ! negator. Typical optional attributes are + Exceptions, Signature, Deprecated, + SourceFile, SourceDir, + LineNumberTable, LocalVariableTable, + LocalVariableTypeTable, Synthetic, + EnclosingMethod, RuntimeVisibleAnnotations, + RuntimeInvisibleAnnotations, + RuntimeVisibleParameterAnnotations, + RuntimeInvisibleParameterAnnotations, and + AnnotationDefault. The InnerClasses attribute + name can be specified as well, referring to the source name part of this + attribute. For example, you should at least keep the + Exceptions, InnerClasses, and + Signature attributes when processing a library. As another example, + you should keep the SourceFile and + LineNumberTable attributes for producing useful obfuscated stack + traces. Only applicable when obfuscating.
+ +
-renamesourcefileattribute + [string]
+ +
Specifies a constant string to be put in the SourceFile + attributes (and SourceDir attributes) of the class files. + Note that the attribute has to be present to start with, so it also has to + be preserved explicitly using the -keepattributes directive. + For example, you may want to have your processed libraries and + applications produce useful obfuscated + stack traces. Only applicable when obfuscating.
+ +
-adaptclassstrings + [class_filter]
+ +
Specifies that string constants that correspond to class names should be + obfuscated as well. Without a filter, all string constants that correspond + to class names are adapted. With a filter, only string constants in + classes that match the filter are adapted. For example, if your code + contains a large number of hard-coded strings that refer to classes, and + you prefer not to keep their names, you may want to use this option. + Primarily applicable when obfuscating, although corresponding classes are + automatically kept in the shrinking step too.
+ +
-adaptresourcefilenames + [file_filter]
+ +
Specifies the resource files to be renamed, based on the obfuscated names + of the corresponding class files (if any). Without a filter, all resource + files that correspond to class files are renamed. With a filter, only + matching files are renamed. For example, see processing resource files. Only + applicable when obfuscating.
+ +
-adaptresourcefilecontents + [file_filter]
+ +
Specifies the resource files whose contents are to be updated. Any class + names mentioned in the resource files are renamed, based on the obfuscated + names of the corresponding classes (if any). Without a filter, the + contents of all resource files updated. With a filter, only matching files + are updated. The resource files are parsed and written using the + platform's default character set. You can change this default character set + by setting the environment variable LANG or the Java system + property file.encoding. For an example, + see processing resource files. + Only applicable when obfuscating.
+ +
+

+ +  +

Preverification Options

+ +
+
-dontpreverify
+ +
Specifies not to preverify the processed class files. By default, class + files are preverified if they are targeted at Java Micro Edition or at + Java 6 or higher. For Java Micro Edition, preverification is required, so + you will need to run an external preverifier on the processed code if you + specify this option. For Java 6, preverification is not required (yet), + but it improves the efficiency of the class loading in the Java Virtual + Machine.
+ +
-microedition
+ +
Specifies that the processed class files are targeted at Java Micro + Edition. The preverifier will then add the appropriate StackMap + attributes, which are different from the default StackMapTable attributes + for Java Standard Edition. For example, you will need this option if you + are processing midlets.
+ +
+

+ +  +

General Options

+ +
+
-verbose
+ +
Specifies to write out some more information during processing. If the + program terminates with an exception, this option will print out the entire + stack trace, instead of just the exception message.
+ +
-dontnote + [class_filter]
+ +
Specifies not to print notes about potential mistakes or omissions in the + configuration, like typos in class names, or like missing options that + might be useful. The optional filter is a regular expression; ProGuard + doesn't print notes about classes with matching names.
+ +
-dontwarn + [class_filter]
+ +
Specifies not to warn about unresolved references and other important + problems at all. The optional filter is a regular expression; ProGuard + doesn't print warnings about classes with matching names. Ignoring + warnings can be dangerous. For instance, if the unresolved classes or + class members are indeed required for processing, the processed code will + not function properly. Only use this option if you know what you're + doing!
+ +
-ignorewarnings
+ +
Specifies to print any warnings about unresolved references and other + important problems, but to continue processing in any case. Ignoring + warnings can be dangerous. For instance, if the unresolved classes or + class members are indeed required for processing, the processed code will + not function properly. Only use this option if you know what you're + doing!
+ +
-printconfiguration + [filename]
+ +
Specifies to write out the entire configuration that has been parsed, with + included files and replaced variables. The structure is printed to the + standard output or to the given file. This can sometimes be useful for + debugging configurations, or for converting XML configurations into a more + readable format.
+ +
-dump + [filename]
+ +
Specifies to write out the internal structure of the class files, after + any processing. The structure is printed to the standard output or to the + given file. For example, you may want to write out the contents of a given jar + file, without processing it at all.
+ +
+

+ +  +

Class Paths

+ +ProGuard accepts a generalization of class paths to specify input files and +output files. A class path consists of entries, separated by the traditional +path separator (e.g. ':' on Unix, or ';' on Windows platforms). +The order of the entries determines their priorities, in case of duplicates. +

+Each input entry can be: +

    +
  • A class file or resource file. +
  • A jar file, containing any of the above, +
  • A war file, containing any of the above, +
  • An ear file, containing any of the above, +
  • A zip file, containing any of the above, +
  • A directory (structure), containing any of the above. +
+

+The paths of directly specified class files and resource files is ignored, so +class files should generally be part of a jar file, a war file, an ear file, a +zip file, or a directory. In addition, the paths of class files should not have +any additional directory prefixes inside the archives or directories. + +

+Each output entry can be: +

    +
  • A jar file, in which all processed class files and resource files will be + collected. +
  • A war file, in which any and all of the above will be collected, +
  • An ear file, in which any and all of the above will be collected, +
  • A zip file, in which any and all of the above will be collected, +
  • A directory, in which any and all of the above will be collected. +
+

+When writing output entries, ProGuard will generally package the results in a +sensible way, reconstructing the input entries as much as required. Writing +everything to an output directory is the most straightforward option: the +output directory will contain a complete reconstruction of the input entries. +The packaging can be almost arbitrarily complex though: you could process an +entire application, packaged in a zip file along with its documentation, +writing it out as a zip file again. The Examples section shows a few ways +to restructure output archives. +

+Files and directories can be specified as discussed in the section on file names below. +

+In addition, ProGuard provides the possibility to filter the class path +entries and their contents, based on their full relative file names. Each +class path entry can be followed by up to 5 types of file filters between parentheses, separated by +semi-colons: +

    +
  • A filter for all zip names that are encountered, +
  • A filter for all ear names that are encountered, +
  • A filter for all war names that are encountered, +
  • A filter for all jar names that are encountered, +
  • A filter for all class file names and resource file names that are + encountered. +
+

+If fewer than 5 filters are specified, they are assumed to be the latter +filters. Any empty filters are ignored. More formally, a filtered class path +entry looks like this: +

+classpathentry([[[[zipfilter;]earfilter;]warfilter;]jarfilter;]filefilter)
+
+

+Square brackets "[]" mean that their contents are optional. +

+For example, "rt.jar(java/**.class,javax/**.class)" matches all +class files in the java and javax directories inside +the rt jar. +

+For example, "input.jar(!**.gif,images/**)" matches all files in +the images directory inside the input jar, except +gif files. +

+Note that the different filters are applied to all corresponding file types, +irrespective of their nesting levels in the input; they are orthogonal. +

+For example, +"input.war(lib/**.jar,support/**.jar;**.class,**.gif)" only +considers jar files in the lib and support +directories in the input war, not any other jar files. It then +matches all class files and gif files that are encountered. +

+The filters allow for an almost infinite number of packaging and repackaging +possibilities. The Examples section provides a few more examples +for filtering input and output. +

+ +  +

File Names

+ +ProGuard accepts absolute paths and relative paths for the various file names +and directory names. A relative path is interpreted as follows: +
    +
  • relative to the base directory, if set, or otherwise +
  • relative to the configuration file in which it is specified, if any, or + otherwise +
  • relative to the working directory. +
+

+The names can contain Java system properties delimited by '<' and +'>'. The system properties +are automatically replaced by their respective values. +

+For example, <java.home>/lib/rt.jar will automatically be +expanded to something like /usr/local/java/jdk/jre/lib/rt.jar. +Similarly, <user.home> will be expanded to the user's home +directory, and <user.dir> will be expanded to the current +working directory. +

+Names with special characters like spaces and parentheses must be quoted with +single or double quotes. Note that each file name in a list of names has to be +quoted individually. Also note that the quotes themselves may need to be +escaped when used on the command line, to avoid them being gobbled by the +shell. +

+For example, on the command line, you could use an option like '-injars +"my program.jar":"/your directory/your program.jar"'. +

+ +  +

File Filters

+ +Like general filters, a file filter is a +comma-separated list of file names that can contain wildcards. Only files with +matching file names are read (in the case of input jars), or written (in the +case of output jars). The following wildcards are supported: + + + + + + + + +
?matches any single character in a file name.
*matches any part of a filename not containing the directory + separator.
**matches any part of a filename, possibly containing any number of + directory separators.
+ +For example, "java/**.class,javax/**.class" matches all +class files in the java and javax. +

+ +Furthermore, a file name can be preceded by an exclamation mark '!' to +exclude the file name from further attempts to match with +subsequent file names. +

+For example, "!**.gif,images/**" matches all files in the +images directory, except gif files. +

+The Examples section provides a few more examples for filtering input and output. + +  +

Filters

+ +ProGuard offers options with filters for many different aspects of the +configuration: names of files, directories, classes, packages, attributes, +optimizations, etc. +

+A filter is a list of comma-separated names that can contain wildcards. Only +names that match an item on the list pass the filter. The supported wildcards +depend on the type of names for which the filter is being used, but the +following wildcards are typical: + + + + + + + + +
?matches any single character in a name.
*matches any part of a name not containing the package separator or + directory separator.
**matches any part of a name, possibly containing any number of + package separators or directory separators.
+ +For example, "foo,*bar" matches the name foo and +all names ending with bar. +

+ +Furthermore, a name can be preceded by a negating exclamation mark '!' +to exclude the name from further attempts to match +with subsequent names. So, if a name matches an item in the filter, it +is accepted or rejected right away, depending on whether the item has a +negator. If the name doesn't match the item, it is tested against the next +item, and so on. It if doesn't match any items, it is accepted or rejected, +depending on the whether the last item has a negator or not. +

+For example, "!foobar,*bar" matches all names ending with +bar, except foobar. +

+ +  +

Overview of Keep Options

+ +The various -keep options for shrinking and obfuscation may seem +a bit confusing at first, but there's actually a pattern behind them. The +following table summarizes how they are related: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
KeepFrom being removed or renamedFrom being renamed
Classes and class members-keep-keepnames
Class members only-keepclassmembers-keepclassmembernames
Classes and class members, if class members present-keepclasseswithmembers-keepclasseswithmembernames
+

+ +Each of these -keep options is of course followed by a +specification of the classes and class +members (fields and methods) to which it should be applied. +

+If you're not sure which option you need, you should probably simply use +-keep. It will make sure the specified classes and class members +are not removed in the shrinking step, and not renamed in the obfuscation step. +

+ + +
+attention + +Always remember: +
    +
  • Specifying a class without class members only preserves the class as an + entry point — any class members may then still be removed, optimized, + or obfuscated.
    • +
  • Specifying a class member only preserves the class member as an entry + point — any associated code may still be optimized and adapted.
    • +
+
+

+ +  +

Keep Option Modifiers

+ +
+
allowshrinking
+ +
Specifies that the entry points specified in the -keep + option may be shrunk, even if they have to be preserved otherwise. That + is, the entry points may be removed in the shrinking step, but if they are + necessary after all, they may not be optimized or obfuscated.
+ +
allowoptimization
+ +
Specifies that the entry points specified in the -keep + option may be optimized, even if they have to be preserved otherwise. That + is, the entry points may be altered in the optimization step, but they may + not be removed or obfuscated. This modifier is only useful for achieving + unusual requirements.
+ +
allowobfuscation
+ +
Specifies that the entry points specified in the -keep + option may be obfuscated, even if they have to be preserved otherwise. That + is, the entry points may be renamed in the obfuscation step, but they may + not be removed or optimized. This modifier is only useful for achieving + unusual requirements.
+ +
+

+ +  +

Class Specifications

+ +A class specification is a template of classes and class members (fields and +methods). It is used in the various -keep options and in the +-assumenosideeffects option. The corresponding option is only +applied to classes and class members that match the template. +

+The template was designed to look very Java-like, with some extensions for +wildcards. To get a feel for the syntax, you should probably look at the examples, but this is an attempt at a complete formal +definition: +

+ +

+[@annotationtype] [[!]public|final|abstract|@ ...] [!]interface|class|enum classname
+    [extends|implements [@annotationtype] classname]
+[{
+    [@annotationtype] [[!]public|private|protected|static|volatile|transient ...] <fields> |
+                                                                      (fieldtype fieldname);
+    [@annotationtype] [[!]public|private|protected|static|synchronized|native|abstract|strictfp ...] <methods> |
+                                                                                           <init>(argumenttype,...) |
+                                                                                           classname(argumenttype,...) |
+                                                                                           (returntype methodname(argumenttype,...));
+    [@annotationtype] [[!]public|private|protected|static ... ] *;
+    ...
+}]
+
+

+Square brackets "[]" mean that their contents are optional. Ellipsis dots +"..." mean that any number of the preceding items may be specified. A vertical +bar "|" delimits two alternatives. Non-bold parentheses "()" just group parts +of the specification that belong together. The indentation tries to clarify +the intended meaning, but white-space is irrelevant in actual configuration +files. +

+

    + +
  • The class keyword refers to any interface or class. + The interface keyword restricts matches to interface + classes. The enum keyword restricts matches to + enumeration classes. Preceding the interface or + enum keywords by a ! restricts + matches to classes that are not interfaces or enumerations, respectively. +

    + +

  • Every classname must be fully qualified, e.g. + java.lang.String. Class names may be specified as regular + expressions containing the following wildcards: + + + + + + + + + + + + + + + +
    ?matches any single character in a class name, but not the package + separator. For example, "mypackage.Test?" matches + "mypackage.Test1" and "mypackage.Test2", but not + "mypackage.Test12".
    *matches any part of a class name not containing the package separator. For + example, "mypackage.*Test*" matches + "mypackage.Test" and + "mypackage.YourTestApplication", but not + "mypackage.mysubpackage.MyTest". Or, more generally, + "mypackage.*" matches all classes in + "mypackage", but not in its subpackages.
    **matches any part of a class name, possibly containing any number of + package separators. For example, "**.Test" matches all + Test classes in all packages except the root package. Or, + "mypackage.**" matches all classes in + "mypackage" and in its subpackages.
    + + For additional flexibility, class names can actually be comma-separated + lists of class names, with optional ! negators, just + like file name filters. This notation doesn't look very Java-like, so it + should be used with moderation. +

    + For convenience and for backward compatibility, the class name + * refers to any class, irrespective of its package. +

    + +

  • The extends and implements + specifications are typically used to restrict classes with wildcards. They + are currently equivalent, specifying that only classes extending or + implementing the given class qualify. Note that the given class itself is + not included in this set. If required, it should be specified in a + separate option. +

    + +

  • The @ specifications can be used to restrict classes + and class members to the ones that are annotated with the specified + annotation types. An annotationtype is specified just like a + classname. +

    + +

  • Fields and methods are specified much like in Java, except that method + argument lists don't contain argument names (just like in other tools + like javadoc and javap). The specifications can + also contain the following catch-all wildcards: + + + + + + + + + + + + + + + +
    <init>matches any constructor.
    <fields>matches any field.
    <methods>matches any method.
    *matches any field or method.
    + + Note that the above wildcards don't have return types. Only the + <init> wildcard has an argument list. +

    + + Fields and methods may also be specified using regular expressions. Names + can contain the following wildcards: + + + + + + +
    ?matches any single character in a method name.
    *matches any part of a method name.
    + + Types in descriptors can contain the following wildcards: + + + + + + + + + + + + + + + +
    %matches any primitive type ("boolean", "int", + etc, but not "void").
    ?matches any single character in a class name.
    *matches any part of a class name not containing the package separator.
    **matches any part of a class name, possibly containing any number of + package separators.
    ***matches any type (primitive or non-primitive, array or + non-array).
    ...matches any number of arguments of any type.
    + + Note that the ?, *, and ** + wildcards will never match primitive types. Furthermore, only the + *** wildcards will match array types of any dimension. For + example, "** get*()" matches "java.lang.Object + getObject()", but not "float getFloat()", nor + "java.lang.Object[] getObjects()". +

    + +

  • Constructors can also be specified using their short class names (without + package) or using their full class names. As in the Java language, the + constructor specification has an argument list, but no return type. +

    + +

  • The class access modifiers and class member access modifiers are typically + used to restrict wildcarded classes and class members. They specify that + the corresponding access flags have to be set for the member to match. A + preceding ! specifies that the corresponding access + flag should be unset. +

    + Combining multiple flags is allowed (e.g. public static). It + means that both access flags have to be set (e.g. public + and static), except when they are conflicting, in + which case at least one of them has to be set (e.g. at least + public + or protected). + +

+

+ +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/manual/wtk.html b/docs/manual/wtk.html new file mode 100644 index 0000000..b8c70b5 --- /dev/null +++ b/docs/manual/wtk.html @@ -0,0 +1,58 @@ + + + + + + +ProGuard JME Wireless Toolkit Integration + + + +

JME Wireless Toolkit Integration

+ +ProGuard can be seamlessly integrated in Sun's Wireless Toolkit (WTK) +for Java Micro Edition (JME). +

+ +The WTK already comes with a plug-in for ProGuard. Alternatively, ProGuard +offers its own plug-in. This latter implementation is recommended, as it more +up to date and it solves some problems. It is also somewhat more efficient, +invoking the ProGuard engine directly, instead of writing out a configuration +file and running ProGuard in a separate virtual machine. +

+ +In order to integrate this plug-in in the toolkit, you'll have to put the +following lines in the file +{j2mewtk.dir}/wtklib/Linux/ktools.properties or +{j2mewtk.dir}\wtklib\Windows\ktools.properties (whichever is +applicable). +

+ +

+obfuscator.runner.class.name: proguard.wtk.ProGuardObfuscator
+obfuscator.runner.classpath: /usr/local/java/proguard/lib/proguard.jar
+
+

+ +Please make sure the class path is set correctly for your system. +

+ +Once ProGuard has been set up, you can apply it to your projects as part of +the build process. The build process is started from the WTK menu bar: +

+

Project -> Package -> Create Obfuscated Package
+

+This option will compile, shrink, obfuscate, verify, and install your midlets +for testing. +

+Should you ever need to customize your ProGuard configuration for the JME WTK, +you can adapt the configuration file proguard/wtk/default.pro +that's inside the proguard.jar. + +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/quality.html b/docs/quality.html new file mode 100644 index 0000000..29889e3 --- /dev/null +++ b/docs/quality.html @@ -0,0 +1,44 @@ + + + + + + +ProGuard Quality + + + +

Quality

+ +In order to get a feel for the quality of the ProGuard code, it is run +through a regular automatic build process. This process produces numerous +statistics on the source code, Java lint comments, Java documentation +comments, the Java documentation itself, html lint comments on the Java +documentation, spell checks, compilation results, an output jar, dead code +analysis, a shrunk and obfuscated jar (using ProGuard itself!), test runs with +memory and performance analyses, etc. Most analyses are produced using freely +available tools. The results are poured into a convenient set of web pages +using bash/sed/awk scripts. You're welcome to have a look at an uploaded +snapshot of one of these runs: +

+

Automated Code Analysis and Testing Pages (at SourceForge)
+

+The pages will appear in a new window, which you probably want to view at +full-screen size. +

+ +In addition, ProGuard is tested against a constantly growing test suite +(more than 500 tests at this time of writing). These small programs contain a +wide range of common and uncommon constructs, in order to detect any regression +problems as soon as possible. + +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + diff --git a/docs/results.html b/docs/results.html new file mode 100644 index 0000000..480cd4f --- /dev/null +++ b/docs/results.html @@ -0,0 +1,155 @@ + + + + + + +ProGuard Results + + + +

Results

+ +ProGuard successfully processes any Java bytecode, ranging from small +midlets to entire run-time libraries. It primarily reduces the size of the +processed code, with some potential increase in efficiency as an added bonus. +The improvements obviously depend on the original code. The table below +presents some typical results: +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Input ProgramOriginal sizeAfter shrinkingAfter optim.After obfusc.Total reductionTimeMemory usage
Worm, a sample midlet from Sun's JME10.3 K9.8 K9.6 K8.5 K18 %2 s19 M
Javadocking, a docking library290 K281 K270 K201 K30 %12 s32 M
ProGuard itself648 K579 K557 K348 K46 %28 s66 M
JDepend, a Java quality metrics tool57 K36 K33 K28 K51 %6 s24 M
the run-time classes from Sun's Java 653 M23 M22 M18 M66 %16 min270 M
Tomcat, the Apache servlet container1.1 M466 K426 K295 K74 %17 s44 M
JavaNCSS, a Java source metrics tool632 K242 K212 K152 K75 %20 s36 M
Ant, the Apache build tool2.4 M401 K325 K242 K90 %23 s61 M
+

+Results were measured with ProGuard 4.0 on a 2.6 GHz Pentium 4 with 512 MB +of memory, using Sun JDK 1.5.0 in Fedora Core 3 Linux. +

+The program sizes include companion libraries. The shrinking step produces the +best results for programs that use only small parts of their libraries. The +obfuscation step can significantly shrink large programs even further, since +the identifiers of their many internal references can be replaced by short +identifiers. +

+The Java 6 run-time classes are the most complex example. The classes perform +a lot of introspection, interacting with the native code of the virtual +machine. The 1500+ lines of configuration were largely composed by automated +analysis, complemented by a great deal of trial and error. The configuration +is probably not complete, but the resulting library successfully serves as a +run-time environment for running applications like ProGuard and the ProGuard +GUI. +

+For small inputs, timings are governed by the reading and parsing of the jars. +For large inputs, the optimization step becomes more important. For instance, +processing the Java 6 run-time classes without optimization only takes 2 +minutes. +

+Memory usage (the amount of physical memory used by ProGuard while processing) +is governed by the basic java virtual machine and by the total size of the +library jars and program jars. +

+
+Copyright © 2002-2009 +Eric Lafortune. +
+ + + diff --git a/docs/sanawarelogo.png b/docs/sanawarelogo.png new file mode 100644 index 0000000000000000000000000000000000000000..bf7218b48cf263ba0b783f6bd85e2498c5139cb0 GIT binary patch literal 8552 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 literal 0 HcmV?d00001 diff --git a/docs/screenshot_console.gif b/docs/screenshot_console.gif new file mode 100644 index 0000000000000000000000000000000000000000..8aea61e11ab563a913ccf5c59fa5d989d81474ee GIT binary patch literal 18930 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 IeHj?60eFjLd;kCd literal 0 HcmV?d00001 diff --git a/docs/screenshot_console_small.gif b/docs/screenshot_console_small.gif new file mode 100644 index 0000000000000000000000000000000000000000..3f55f5b676478471b308c0b40103ccfed31c82e0 GIT binary patch literal 19730 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 literal 0 HcmV?d00001 diff --git a/docs/screenshot_gui2.gif b/docs/screenshot_gui2.gif new file mode 100644 index 0000000000000000000000000000000000000000..aecdb35f230bfde4694246613966027d4cbb858b GIT binary patch literal 36887 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%0D-dps^`tNMQE_}-QE z>tBU0ullxP-q#hUC0|Z$?aVo9SGH;T-8bp()wjZfFPQM^7b>>=X0$$WkoTNyQ`z(c zrssa;{LgBe3)yXy_r={@CVub39@7^df^U}Tnbma!lq894);Ow>C-`aF`bQ$0BV2X; z?tPpu|EI*&zUtESfA_v@J^Q9Ne}l)h?f1T}Z?}EpTwitT`n_-4kN>p^=68ttcJKRs z_PP(v_P_6l-~Vykz3x-(rt0Ld%RkSz*L_*4@B2vm{;%uD>%R4$ukky0`S*SH`X5K% zpL?}C=IwL$`d?S~*L~Z5fAc<8_2mXu^}nv)|Mz`+#?Q~Iz8wC3|NpC(Ymb~({`rYx zmeB!bmjf&z4l^&=?|HQUfAawj7XIGZtGKot;68GIr$=jAw(j)F2l!bIiYM;&vDCQQ zy;|7iph(C;(VEqNU+Mo3S}!o=pri1bd|4mgn;w13ITrJ0man3{qZ}IZ%#n!V;_62UL znr!OrY|MN5kl7pi-sW`{Qx01$Ic!z4F6p(=^gzX3nw#y8NQQ0RUK{Cbu5!d $b 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 literal 0 HcmV?d00001 diff --git a/docs/screenshot_gui5.gif b/docs/screenshot_gui5.gif new file mode 100644 index 0000000000000000000000000000000000000000..1313db22b3010c7080e025c00d0b2e8991cb1eec GIT binary patch literal 35909 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 IDd!*i$y9x-3bgFznxvM>^LY>9%c?TlYvm zPAEO~f}z@DBeUe@&q)ShkA+uW;4OV@-uBqSZ>MJ5W2
  • 7^HKt|dE!C|iGfY+!b$ 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

    hd(!J8_I0It<()Oez^3A-!B) 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 C#h+LJ literal 0 HcmV?d00001 diff --git a/docs/screenshot_gui7.gif b/docs/screenshot_gui7.gif new file mode 100644 index 0000000000000000000000000000000000000000..bc5d6ed932489e565781168f5950167bf88269c8 GIT binary patch literal 41922 zcmZ?wbh9u|oW?w#>G>K41_lOWW8<{6wB)A!Rb4aZ%$YNH?%a9v=FOi!f5CzU3l}b2 zv}n=d#fz6LS+aEL(q+q*EnmKT#flXxSFT*OYSrr1tJkbqvv%#;b?erxU%!6Ch7B7x zZrrqK)8@^a7wPMkP-^5n@=XHK0ub@J4?9p|5(I(_!^ z>C>l9pFe%(+?g|HPM^7O=Ir^iXV0EFd-3eK3+K+A+k5Hx*>jinU4DM<{KfO<&!0Pg z`TT`T7cN{lf8ol3D=#iwynONE#S0g&9=iJC;-xE>E?qiw?d8Qw*A8EMdFk@iOP8-- zzH;r#l`EI8+&FsU)v+6|u3Wu-_3G6tS8pD_`TFX$8`rK~yL#=`iCeEv-gynW`*o0~Up-ne=9=B+zt@4mft>()4MM|KYRA<`Sa&5Uc7kt>dVWQFJHZS z_4@Ver*FT#dGqG&+qW;?e|z!%`@47VUVixg{{8z8A3l8i`0>-HPwzhe{QUXzmoHzw ze*OCC+pllmzJ31w>+|>D-+uo2_2=*Z5e#%dIRKOw7&!hhL~_b_Y*^qJ#>A%;b7I57 z!|ejfUUNJ)E;`yRVVrg6#Ky(P`xTtKWIQ)5IXPJ)cvXy~k)n5_Ui_&!o|~7Qoo!M4 z>dwi{%g@huXg+l0#iaI&i#;Z*`L5Wq^78V4#a?s0wywImI%0Fy-BVjvUtgbaxJ%Z1 z+nSr3GcK=+J-u!1?d@?h(?kPG^t5+We13KJ^!D}l_ct(e%lYis@bGZd)1;-^1|MUO zOi=co=d*Lu)6+AIv+v1#|M+N^&5JHM-(6c?US1KrI_~VQt*@_dNIpH!clWlpw|5l3 zzIS%__V@P>G;_=Q?b-41@rlXP?M~e&KGS|))-B&6cE#7%H#TSAKeu=H_xBId|Aob` z*kM_GK1g)AyL_na^Y0%XpPui(f8XEV)9*U#@<;s-{_n?lV@ksh(ToR;9BL~bH1Tk` zJqSAY_4vIy;eX+Y4dP}i9=6H&u^wnwh+=)z9zXHM!%mH59aCZ!=^jmL>6QHYpi6L8 zSzM^`suhp>zRo<++#mRpV@a6vr;H~PKX24fE_Sm$7T>clbwx;}ucf+bi$~hZr`1kv z9*;WQMSm(YxXt8vHY20X^VzhVZI&}9d2eCLz zMVT2vX_IEYn9*V+^vk@)+NH6n_224(6?@;U(%yUho9D{y3%GWFIBLaqCu?WC+H9@G zYgToCJW+q><%aZd@w~h2=C1qoN=WvxO{aFUz5Q}6wEXSY>j}?Gzb;*>_+-}2wF}SAx^-&n z+i$lEj_ZEEQ*u4```wD?Yrp@yw`1d4soSia4hJ5zi0A!y*rC4e$DE0(YO^=i%bcfVe5IIj2m&6ewVzu#`# zt)t9n{^i~8_XpVZ|9m(ip8x0L3H9}RKI|}m|L5}scm2O#u7v0R{dyyP{oik!ub-58 zKfOi&-;XEL^Z)&Pv3&i%UvIX*xBJObp#T5Rm+Sfe|NeNs{{O!}>F@u(Gk?*-!0vH? zN$NubhtC2g@e>EwtUffd_Qd~J^Ek*A^`S}P%mOy^j{W~z+sYSlEaY(aI3zUdLyLyb zLay)=hs1VGXc2l7!;ofi`1#cdb>>eN@Rgr9Ecfd}`#*;>bJ$tSnS&)hc6j(K5}JPE zh?>>M&VZgpBFkqSktllCX36vD`KA>|^{PI0C-5wmh%|S(xAIX>hRnDzx?fTeT z(6dc`UCf?%~8|)L+MvqNu<9gsYlScVAD6{9lWc zhEbm;%{a3}O+Vt8^qNPL7w|0AaQ8eFH0#rp6+TO~!cTey-U}@5uvwyzzVd|2txFT8 zon9;_Sm_<}D`@(*CrbLsktcnnKF>Jev&?9B`_}h&6>O|4mpZD6dqf3Yo;BglQyp!~ z6WLY9Gp?<9s=slkZy{gs?8(i`tgfFtSGMc(+z(GqFza1E8FuUQydVG0EVm2SJj?#$ z^8EW>R4tgjPRf)`p7i*Sn*Pz10Yy?plb-K+rtshMVpr6cMG|LMxS5~2*jM#su>$W( z4|lIilV*KcqT##JEBw@@X}i8GHRxUGlfEi2?9An&xoZ~tosaOH%T}~JZ;oQX>l^-V zVwV^2iLOxEDS5H++oT1)XVZejcb!=k^>tN5=rZ4zH+>j_KCX6~lNiBl;JUF*bd8UR zcGS{{D=~7Si#$~|oTa_4yBBSo9$1?lyK>gmeZRi0Z@Bs}tnk)V{(BEvJ9r=Rh)OdA z>TKKCw{#(gc(l{0sIW~vr8>!mvm?Z}m9DF>%}`G53|VsR>be=yYcmgOhVHQ2GNZBg z-`bpX@95XO+luD4EXZTEaK6X3K-lEV+JeU4(ahhb?O?UZE0}ot&Rx3?oB!<2&Ry<( z_f=GQ^Y*1N>i3V|{SbP2H>1FPo`c@^KJ|VVdM=t@adCItw`tpVziZa}CsTR%*RAjS ze%y^KyBryzPBjyV5I?#3tW3YQX2vnfxb7(!S}a$-0ewp=Tb;Esr=X z&$nqpyH5&t+m6XS9-AgjKl4P*`sPXFl%gq z^UTOv@`S73=6|!UpGkWuyL0~@>y|mseV$w0{&}u^UgF%ZHqRa2-8^4(&3Hb4psy2q z!?`9qlX>E2Usx~Rd3HkImL=-GyUgRWQuj!=EHgj*(y#j0zC(-S5++*?*pB`0qRwey(Vu_nk)u{X5UhZ!bK5 z)n=~D^Y=^V9^S3>6rU@ty|XE;>Be!tZ<}WSeUst8`_}by-?r`k`!==QO3|_W>*cF^t1jJDHr;;i z`@Z)ZUeEqrbG`X3b0v4)y8Z9lj`OxpUYsnveE-t-PPu}j6>H4a@((`|=?cew1>GxmDkImb#`TpE@+y9;a`>tBPa8G>Jr@8O{ zJSg7x^G;6PGavmwpX2xaePaLr%4Pe%zi$7pTEG1L*Z*^C59_`E&mhsjWYKU+xbEHY znh)RWK9zgC60cvm-8bS%*s0|W7s3O|UF*M3Z-e`@RVRg0L(#fMjiNk4bXt1-VMRaYl=-yb`HFa`V>JOifUxXHVbnpAoon*pr$fD;+L=SU7hmu*v*DqaXZuFe1 z@Y>7KbIGFD&V=D)agTI)$LX|)*%~49Z@4ioaI^o~`(%dOMUUPWGy23+dixh}t~kK8 zasy|714q3Adx8P0b3<=iM{UQ8(CnpQJscC#OI^}bCwQey2yB@U@}$H+y;O9E>nn+g zLOZSAyy*L&(f=i*|Hq2{lPh|kltrXhL{2n~>~)P)ww%;x;xu7uq{_)j{jHJuH~&r2 zI2oBE(fv`qb3;qH@XpCsA|}3<=>Hti|9wXP363(?j+Rqbqdk8{ds@aEH+48_8sirk zrb0+ZIhK z6>()d=Y%ZFnT;o= zIn12sd~%}OOCO1{MB#5U1=(gXiY4;7&6=z*Yq{sF6_$x}GZT3@J*`&E(C4V%uyn?z z%-NGXXYRV$I<0e})6R*mD|;B8C)-X-K9-q$JTuA6EctY0@`;~wte?%Xo;K&m&E#q7 z)0URbHvQKz+v3IybIF-yJ7z!H*}V7Vw3(7~!qOtHr6zovmvn7j;bNJizhg&ortcBN$~yjs}Ewn##1kx*88jAgUlj~Q>xr`^k(c4Nu{lU-rg_*P6s!T?KC5zdXxOgqec_OJAuMCTqUXNMvu2w{Efp?boWFAB zp_$!>t}QjbvUH0WL&B}>c&lZ}Red4iR_s|zbEIk`s^;-YH3@jR+zwk_R<*oh*7BQe z%T`>T5PoG@!>#80TMPbKX)U*@V*WC1Mc1wsJ-1eTI<~w~YNd(Q3d>s)i+)ZNn7(q> zu9b6ct>j~0IZ0~OZqJobv*x+pC|WUV)v8^q*6b=;ptWkltZ7TS=1tei_9TE-f^&Y@)8v|Wqkf7bH--XL(>!mP7#k!t8>$*AO;zAr?U zvbs*2`+Q^F4|m^Lm2;PGJo3FwLSm*E_a^P?f9AGfJQAb17 z?;SB3JI!XSt(4vnIeYD;Tf1giZ_|z16DYpxR%ZKw)7w`_@7nh-dl%o0-2tlYwZE6F z*}a70hQ|!<-H9r@m%Z}wp0V%M?tNZA=IdnbJbrra)Ym&pt@o|py-Q@qrsc19&3L|c z;_sb{U+-Mjz5kx}p8e6gvS#n)Tyx;6)!yl^53v5(_2jnev*^{XJK7}X9F$tq_NiIURjFj`-X;k}!42k?uXJtGD-Wsg&|=-#TSa>yfPyHG2YO zmfA=kyivX1aZh`=PMu}VvG=z(KhR$K;CGk~&v8@jO^&~#;r%Q=2?_vXXeM;t>A z{_~4&d1`T@CFVrVlhtMI+ZS(M|EajOE_?0cDEl6slZ@TgliwWw!+fIc*TnNTPR_g2 z(~(n}U$MdM>6(jM>s)`YpJHP_{myce?2|LzxXzlhZqv5zJsFcX&N+SA;&h6~?s;EM z9*{ZnL*&%1m@{9GpPm(Q;_(WudlDfJU!2Lla;DA4{YcK4Yiky`tl9F+a|QSAlbfC$ zVet%OUO6FE_1uF!N3PbKeYL0b1W$qVnn~I>C#n66P?wynvoi8)%%qPozVCUQyR1*K z{XX%Ueb*|TQ&abxSYmVGTle}3nRyRhEialHwccmf`KpbUp5@Uln~OCr@ZCK1+Q$0r zobET?4yReCdUZ~X^!yhS{&I?1?$k4(Q`GCpX3k9n$i`HH=vAD=} zwmoX~35l}@xN0wO%w2zQw$;i%7q1Fm+BawS6Jd|~m(yRm&UkWldPMHkR?Vx%u^W>r zH?Ez!-d=l4dCWEInrr@BcUEz1N|Cvi)w{PsV++IWsh_lG8cH0tytDuF?u{DWhh%Qg zIB&hptowLH$F+nrQSm1)`_))e@AZ&9*YE4@t>1N7*!R|i-FFYqJyxZAkNxkqQ{4xS_udhic{catf~i_N z+OE!L(MwI-HlO3&ybm)UaKD@Pb7$(G$Oo+ZcIV#NXf)^eO4<7vKKm1_udnvq=@@fo ztM0y{+M~Cs_fF7`o%G@aUvFJ=?L*Oj2XuRG7x&ycGkbq-&)kcrFaF83KBb$jDfOg` zEu$@Lkz3sp(W)n|^PafoJ!w{Z62N!sDevRpQ>{{Y_jF|TtemsyboQ0L>c_EtGxTfj ziN)Tp@_np1=aBWi>tAe-MXkGiZuf!AfBS9!UHO-L#K(Hg-kKHv+;2Uv`}cfy+L8vo zELomyTWSv*oZ6NvSH-N|s=McQ3g6?}n5Q8z?R$D#Kis`H`Ss;@zRz^>4x7f@-?;bK zXWzpuYgrWZ&Z~oud}Kdv*P`Pm_D}<@Tn) z>rZc2O;)*g?f%?1^}JC+wO4p}j_YXo%U{f@OxI>Lu`NFS)aA?IeI~`_SDhz_l&;f>|E>4ZGQJJ&gvnb!@Q_} zpVaC_5wBx4T{H@{;&pOY46s z$Q;dH_jd06U-f@}GV~p3eB<*s=J&Sz-z(}5Sk&#B^6uBZ_0GZd=MLHb@tgBIe&6qz z@wfKx|8s!8`@m~Eu zQIoIR&ImotFK6ie_aWc@f&ITP@&8v}`1f)C|9Si$D&GCL>vNjnVApX6MwYx4PBQ`? zI<@gI+wd&-km%gOs~dO3Lh!L$pBQHWljNkU%@b68=ef)bdg?VzH+El(WbiYeS*E%7 zj?4^x?l;f2_8*H>$cunQuDx=)mJg08`>u#sdg}|vMS07FWjvAxyi`0VGjVbyJe}%( zP0CRj@U6A_L2l5uINyS z%?3`K>Pt2_ad*!0GkUFcn$Os;OPO!adk&))Lc;zohOVN4H62G8d~!Zcl1QHN@u*bd zl801KbcrCY~n z7SXY0?X;-e?RUkZa`yY0#T3e0inyqsw-pZxyL>k!*6*TgX-L@ZP}A6O!>Q)?g1*Ln zkF9tsyY*iA@1t82n)%%<9?mSed%-(ikoDSbL(e^pg5CPZERuVT>rOoCv*lw*ndsWq z@pyvd&lyi92mjmgbZY!Pi?o@#dgd1!^WC=JFD*Z2o-m*BU!VAkdd9x1_gVkmHOW}q z`fqw%>-;vWtd*ImJ5I;hnwT34s>_{T;JlB`I%nf?x!+qi#B(#eX+P&z{nq(RnDnCc z7w1*yZofZmci!HU&vw6e&a$&gpELL0%;#0S{!(G(Q@`zeu`IQ8&&$K9Q@;d;YyL0E zI&1!X&*zxwi}J$x_W#+sdTpz$O6k?`^u49m74P6;qddv8j5we7W87Rh4fAd?xy-e`d4a$8KNq@woc_n$PFm z?Q6eYPmlj|N7{W(<$~wB_k!+gm)CuoC#hmn5%~Ii{O2d?8(xWCXkd3q@c6gRd{=ww zTjx8ABV<)99J#_SG>IQcU^Cs}$X9luS$@rf-$i1pj=b%zoF^6alxO*&u+me(r*6xx zY+=`OXA}tTUc8V;f4kN{)pzBbEJ*^b7OPpUc(Oe%MQzx1oK4N_VyAyglE_jESFNy% zUExQP#O7-_O>xLqkBbqKXt!`PnpW83x@Xq6Ng9TUQxEp$wpDtEJZp)k!4+#&d-TY(mU$frD@xbr0T{0^bGoTY5IPaXDvSe zZaS#g1x$_I%_ux&r%#&M<(cPO(oB|G`eub)o^?G(O}}}kZ(iBu*)5XK1eLEzuA7+3 z@!Tcd>grCvvTc{=zHdpld1~ojwJLb_{UhmiUw58wZS->v3s%vR^z=&HN#1C zS3sNDm4*DR87`_;fvtJVW@s*qIloI{vg5fWi;Ygs`8eTI;5?R3Mfztlp8ePvG_6k0 zDCW>TP1zGO1xtGunIFycE8P{`6?H|`_z$ONqSBT5c_o!@imw_w(nFSQy|U7ub-8`w zDTl&knF*%TC!c=(3)}NeAXKvU&bbF%t7XN+dJb()e6nCy#4$0|IawypLMM8voC>?PY5LKe zG}F~LtEGDD)z4i2Gi}?Bvf62}3y$7@IL&R#CAPC$vTavouvY9}$X2k@J|`!yw0rV# zy`t*lJpK(W)-jL7uJ1VRnpea+B}{GQsX{+yt%HA#?|yi+f8{0BS-H8^&Nr;4H~h^$ z8O3I%;(cp=%~R|6U)QehJMdDcl3C-D;G+v$x4ez#|GV4f z&8O*^jV|}f?`G|<-YL-fP;^Gp`>7#c!YsDGnybk&ai=(6`HjQ!Y=s>^58ZiQDZceu zuGYh_6`L<6l{EC;e#embBJ$rHL%!Xsdv*7y_&9KXzj1udfda$KD8J^CBPZP5iY86n z^Q7;Ic!d?8Zr4)oyQ0PxNA=|5c$jq_FD#wDTP-bXM*eK4JO6H++0FaOBHL?P=$4yj z^V^E&Jhe%;x_Hotn$H`%RS4zw4gmvL9B}W$fAUso+>j+a1r+ z8%|Q&1iUgHC-(VPrTNV_KO3f+@%@ldR?zfYSC+e#t_t0o6}J7>)%9kj^D~_up1Zi~ z^7dn2lb2{&DLa*&ICQIcL#u60lDPHxO?4-i9nW|jV}AQ))UDFPmtNd9ZJU+kGtI+w z!WzN8g6Na?j%}Mb@o!Gi^xJm~e|~Yeo+BXmZ~jx=;)UFMZm$)uJpcRfW4rQwU)R1b z*?j%hi9PvQEPB#Sx6{m7uKVUjHE+A46JyS5z9T(`3l_%Weil)r}^Z3ceiessEpSkjFHvLySoff;LSpH^*oBgZG2`zO> z3)t_zu)I`RCwL}sfr0emxMPM2!dnu0FWq^yWXsR>yTdis-S_lwVA_3subzfur))r~ zdi8=U_e$4k|5fu7-|VM%_OXWI@;yhJe_#D7w|7nU44ubJHrscZ>gG4D{?ID^XOlpE z#UXRM4-MtJKeI{Sy>e;wy85{`&+=b{3;X}NFz0_wId61?xA4ERFQ%1So_yL@el2_5 z`vayY&ZO8IO*_bws=nLyZSH%c$xrWn-}l`1L!tfe8LsooW5_PjmlN+@5{=%KUAg?)TuX!Z3xnh@;?uJ)~4FAtw>!|JU;m|%YW0QBu2NXWp%`xt{y>o8+gace# z4scI#c)WO>m$AdmPl_7CCLYxr-%Q&0XSLz$#|N&gvYD)<-*?DFy80m76i4Q&1AW=^ zzg2cfUpXlIBw2mU+zg^f+#F5dnBw7k+1U9Xk995&m%IJsN)^hU`kPUlxTD((Kq zC~)YI&Xq&DPn`IFIcf$wTzh5zjNAFDm*TI9@*k>9RyZGg-EB2NYqR;BLzX&AGnh4I z3K{J;=Foj~*zU_=dlna+Ux)rhPdPGcgCWmeA7x{EYv+BB);Yx-x-4vRW~R-BWV0zn zc2-whu5Ug(LrKkavy+|B(Lj}>K_;%YT{}~69|@hZQ%hu;U(?ZuDMurh9QE~bRgAI? zyW)Dc=;*tPOXFFNC5RkLJhC+U&e3ESw^c7)R(&$H^-;@dI+iizSmu&rSw_cFjvUL` zGa+utjH*w^@>z}-h#arn<(6x5ytsxh&qZxs(($sACinM5r1`orj;5Tk(so~Jb>_sBgKM666%=!v{&K4Iz?m~& zI<~9uq)t9_;m+=*Ij5?exi8mv{R?(Dd*w>^agnpv=NzBQ;?=Hg(bjFz;%sr_L2vtO z-qz|JcUZhG7Wm#!IhPZ1a{7|~FCKnVz0dvq!2h&||5?wur!kh(t55n#oO^WTTMEqV7A?%f-scW-dsZ6j#?Ym5KS zl-)B}d{1oI{o;h{e1XMGy@$U~In-UV=XkPBfus#bZ9s0M&GGJlgV_OvohLQ6h_dK% z@&8rg$lkRpI3Rtu$0Ox^54i0fN=u5RUK9;_Rg>LDYr`gRo;MwUUgJ$))T|XD{!O-Sy8z?W~Pg@g?ohAn(KT6?88e@Amk; zdH+}M{Xet!?=TGhHGBW}$!k>5JEH zT~b|R$GFSTMt4pJixb~mJqOjbFIJz@`?|6F$N|r#SG=}fxxpB)!)dLHtqB9OgTLyP zdz}V>PeTkA+xTWXEAyPt4K^_7wt8_Z#9&Xb$JPzqZw^Kuy&7}%>gSDtim8_(rk-B> zCD>_-NzmT4EWuZo3Wr@xJ~&AyOuJf0Sj9nl@vehWm;O{AoEUQL083!h-=*De4i$)A zFI2rQ@aZ@!%O%4zm#t+_>%TrwuIg~`j)TiuFSDNAWv-!%m+bTSH)oULpDX2G!~CO< z#Vy`8`}Gb7mm4jiH(Kv5D&}{#AhYmi;qZF6*5>CNe_H|>fd>V95rzowaPEF5k8}xa#J=RYpp#;ZtK*cCR_Q_UWy4U!(j#ojK|e*;!+~ z#`Lz2kb>;Tnr?>Z=Rok)m_JODSx@C?Z zGQD%yHKv*==3r{f5t$pA(fWOxo$8j{Id%8=(cC*{a*rP8UBT0Adz$s`g{PWluHN}~ z>8bg-qs{>$V(lq+ua(}t?y6n+XQfz-%cM^iZp+?YAk-t#61LMc_MOXJf0nI%&37M} z-g_*nt#_ER}%N|O%otFJ}k%jM!(VnE2z2S26!bQJDgo}C@UrAECcSLg9 zBa?k`PhGF?oDw>DYp}Czq)v9?|GSSE_dQNEy&6_}Xwjw{s%DQRU6M`Jo;-THd5Y2o zr^&${D#;7K%DZTX9I%n{l#6%O3+tPDq`u{rGHcYO%`!iDQ+Ag;YPxE*=2F5I&6L-< z=YOr8`pKW#jy0>EhMbGL#JY0V*-1-2-Hl*-Hf=`go4rq?%+jLUI@VV4 zrtmSO`lY4irSZl+O<49UU-sz<(+D2Brx|9?lAb-wFMB5aA#L5Rr<&KEX1S$LlX~{r zHMOuWt=#Qd#kEy=X=&+o>6!oRo|jyEUK5r6S~tD2?Rmq$=VfKjtLxHgrroU#d$Igg z`jfxU8^kgS<~^^Tm(g7J;?L3jF2#w@O#>qIR<3+~Q6%QY$vtW3|Jq5_y(p4P??`)D zQ1+7NpQFW<*uFZx{%;x@TV785x3SIc-jr=G8ta~=>b)oz%W6^U>wc6hx+F#J>s+0$ zHmlFB{`xoaTkDe#s_`o4o@n*PD^5N9Eb88zYcD-?U)r=J#hAUm_V#|MuO0uEVC#7& zZTha+<%Z`TeZ1tHQQF&ADZ3?om)_kVcXngg-FKF+52l^yi3{)E`bf|%QHU)``(Cmx zn*w{-RhB(BPO)Y0cQZa97niH{=A53k*0Njw45nPw;d9hXd?Ue};Cdv*Y3UJvzJuTP zzRXq4J#)`)-nTcm_c30OyQ1*zdi&pSJ+;tE-^AT^2f}#+g~LK_&9l6H?CrU0Z-xHF zFA7a?dHZ(9xd=m+gAearH~9B>&$q`tdvl(q={(DOcd+iAoLQvUq<71wz0LTWwVE~6 z-R=GAs~5fRrLeqC*_3N=T`d2a^7~I_uQT@vgui?L?_WNHe=6g4f%s=nnc`nCyB9cx z6|gV=(6ZCx;?WO0?JH{5ec)R@uldRc0rA3?M+N-mg)W!gaL3){aQ`4=|51GUtao3| zNiP2=b$^XTY@*e?Ovcuaa{lW@zHjf_eNIvRlT!Q1nY}LTmjCkP(~C-&i%yD8dobmb z=JHPqN^U5f)w5oAWKr#t2`%qkL{9#A_gd|H_NA1w#_pd@%v<9`S8iMPI#||;#qW)| zd!mte{;4NtY_5N{4R4L>UHDt_^jo#J!hUaqwidJdpE(xt#WmmCzI~&s?9IPnZ(h|s zPO~lH+JAcAl`p=}zxb(}x~n@z+&v&8U$Ud_al@W3*7cuq*v#C@zlO`31>}FWUmvk} z)@73`MgeahhlGEf{>b!%X(opahu!rv*LQGixoDPj-Y2sDOTyOqpSH?Os&Ppd{d(cw zr>9T9Mwk_wmYeU1@ZIsC%yj+-mGj?<*m-WQDZ0GiY@2fL{e<4zJv;9ElwbZQQ9jY^ zd$s-dQ2o>tqfZPA{a*N3{^;@xqW{B+C|wsMp<53ID?d4BWa$&=bEjc@+wTVBa?u{{0E zg*p7wIc=wBXh@XGrA!dbrwFJU4LJ@?Sk47qiJf zHsa1-^8SNcbw<-SKaZ-9mqx6RG>J5UYSngJ>TVLt9_sY)Yzjv*dl@a$m zr|fB@^Y+7Elpx`TUd>-AgfkN&-L z{jYac^=#hAsN;z@*8MH=kKS(j@3DJb)UK+1*RDJi+iv{Ztd}*(Ly|eN`Rl~3C|9>C<|L6Mu zzt8{w`~Lqwdj~rcyO2)C2Zci|ERls-FD6`NZWmGyT9ffn=~$1HdC{8}AC*r`P;#H7 zlle*I)D*4oO*t<=sh*i(lzwT71?KqZ21S>yH5CS;3Jq5;E#qGhv^MLj*0nWJ+l$`* zd-YZO#_HgyZfi2X>D=0qb$wIr>u#mldURVE*0Wkp}C|#sw-hRzt;}U z<|%2jR<4{o?N!#&wQg48GtzEVX|LNkt1~U`L?!BFB=2jLx zn^)Z`<|SYAYGpgiwwp=bEZgrEt=8S~K<`)hVo_hItj77Pv@>^YUgsUSdr^_+$|an2 zuh#8eF)K=c-|uhQtC~JuyA}3t3if|I)T4Ly*)^N|v)?~ie_mt$TIc=wPgS>! zFSvX*+i=KJd#}mmBM(zz)+=q2Tr*o}dB&UCYpHAH1!AlJn%+pP=GCjz=(j04SwBzL zDDAguR{ZIwhqzy!FTKxG(CWy)_wzlb_iOZ)SATz7e9v~W)Q;t?x4C65`C9+8crw9w z&9n6?)3jyh9MwB1c}#NuiIlQUjdCygFU_jk^-{x{``4sGXV3C83qRTHzPRyx?3Xij z#hF{~?%;m6`(CKozH1*QO4r+b+HJ?H^i+A<%YXMbgd10Dq_s}UJ9_J8z09%scYn{c z6$TO8Kp3tKg5W(=3u0ohL*+7C)DxFYv#(|#BI#x<7%nJ1b^De4wh zCthF{S*&qX^VLDVusup*n={%i3O07fv@lB?);MPHD1*0T!C{HZ9PI+XHuUDzD9b$7 z5Ld7|QzR(u^GqX6^1{^>J#{h8td}peISOs!jnhd{T%XQ*#qr;2+bdp8f=ZevJ*rMe zKjyqHbZDuk*{O|_=lxO9aDKV)>C(=I;O2;{A1pS$+^}fUx;N9*CKhNo#pdUB>C6-^ zUg@o<8kjtDCzHCX=9xsH%`+I5BtM;(t`r)_YrpXgqsd~;vzgxxuwUDfR<*9vH@k52 z?8$%BEP5}T_#U7=?ZK)gHx7vTByZY0_g&5MPw#?GDcmxgdeKv1bI5dch2Ea|O2N_J z3?yd73UQV!a!#5gvDvS}Xv;#rT8+F3kq#kp6J~POJk`ED)2|>Xd(K6xxk{2RFBU3k z#kiahbKAc)pkvdPrFyk5y;Q1BDJJDj?bs;jC;WJpDx*k^^6xX>yu?l{WV`gw#Q9f` zUwPFLm30|QH?5YP8YQ&)sG@G2?9HJ6R!c0tCT6WN_^TE1P$^h3Ze7RGON>#MvzoVV z+PXGxE93S<%Y1X~KDnnWYsA^JNo{L3x^KZpX`*mz)x0&T%xmaDgXcc5P=?>54X`&I{KXpRiUcSQla@$I2 zE{@g(ud>c<`=upuZCl>PO^SKVzi-TXAW%QaR<9`DDKb^*=$fiEJ*R|b$%-|uPuX#0 z_53xfW3LpbFSm?+yYtC&{oD8aHz=3r>?%2SNL1)u+1lFp1MkG<9OEn7adNMIo$RI< zX1&jw{)t>(BgM?qZagorr$c3l60_@R7ULZU!+r?=v?_La+fZKjes1jhWiIwV{%WT` ze>%JHzWeSUpWd3s)vm4mygKR0yXlMmo>kU9D;%p5xy(wARo?RO&$D@KiR^a&Hue`P zJW&*`JYoM&?B=s0Yq*x5D%-I*|K6HkDYHATw<`GE;c@jz(w==iUa#h1K^pgc(aAf{ zNM{=Q&OPmQ+91?zP2t(}&FO4vWsWI)Y(kj}MLmCRP`Cg6a>3jgXKra)->j9Iwtlkl zokU&zvNQWG&rb^Wxij7L)|qK~#GUv&6&8<)?U$D_q6oM|MQb^c2}<2@MrO-cY14cjM9Jg{Y!o7 zXg+=Uw$A61p1Cjy9=gWd+r_(h(knnRWNu! z)G_8oHf}y-bAR6D`N_P>x+U99H!2#O3SL(yRI?L><9r_Q$E7VLUuPe#8-?m@hwjV?-uo)7|Kz#ZyED5a_q^V` z?9BZ63X+n_HlB~t1S<}#lV4!G=UI6DKkGY>`zEdtE_}TvMrf;T-P;{yZ*SfB78b?4 zzImy-?BdMpKF7W}XD4{g-CtC1^F%pcILK{nU-0^uS0{uhzbp7>dh4Li<;_#0juh*7 zR!CV+@_HA$-Fx5Hb??pZ8up(*b>h#|O7WeJw(^CtrEz8{M+E)MSKKByxx+)Z5}m%ZiAsf&%}2amOA zawbc}wuH`De^+evi`h8`xpQ?n_Du|^DdehT6whNlv*+K#*?U{A@A8cD5xM?vs{()G z{cpMP-x(ilK6x@e@OvTBbdXoN{bxi-1E3s@zc=pd* z5B~UWxXCxeHGbdUKCWF0#JW8HCm#K8DSf=v_wCs^+m{GS&P(*NoqKIc`|^qGE2bu1 zU!W*xFtaK);(~_Mrms;VVUqGp{SSAD%RQ6-mpfB5Z=s?VFVC@rZ)X)GzTMea!!GEy zNG0m{@rUgyyB4Y~48EV+EmPIKVCHPue~Nou<%PSH{wz%3wGG{MS5aZ!g50bAGZG&v zo_qATo^$K1xO;Q0N6Fq3b7k(`@J$jFx-YO*Nlqy0U+2W6jhssR zOqBTyXKkFSq#bta;tD0*vd5Q>%$wzV^ablfm8!XxUg0cif=-?ajJKpJr%vFy8o$u= z;Z)O^#!S)*ehW>*9{zpXW>Tf>Aje}-H=n7H?Y1sw`Gom)x^c4?hVfY~N#Rgt%wyZx z7|DINd*900oJ9+`Iu~hQd#F(~bIps#dwU;neoKz=i5Fv2@qTyAf$c%DA~)l_#Rq*= zUi=98Ch@?cX@b$I-nKPQ)EQH~`JNsMh&!w@`SDd*pLLS#iplp{kGm}DDPQXr*UI=} z$JzLe^Ew4p!^@TyNv3{&@aWjfq+q4R!ONz7Fzn87?3S8!oHuJ}__3uiuTFViOK^1h z_r&j3r=L^!&94fRIYcsED8&0E_@7&vDEG{~X{qMKP~|i^YrmA1PI<#Px2Ui-rOXL8 zd*g45swI^zOMm1QTXZMo+0qk^YHMdMbzjJrrla!nz|-`7YB{@>Bwf1vv{hMq!eSLK zwY4wR(x1%B2~jP#Nxc!8(&BOTgNXm>MJ*?Qu&9-YA8`HTvB@cGiJYZuwx9W)4Dusmw7fh>OT6+7?~a_EKzo zbZevT!gjVy&xQ=9rE+CGFC2|xB=_FTS)q}sce*}EC4HN^$G#VLO&+(OeKA!piu+*l z;<>kNA7yO3*xF{be8Rj;H-VK5X=%?5RL;!J$n0CjZksvhTiU^`H`Sw7%5(9yctvV{ zTIrsa!I_k(6}R}!mzC46EuQ|A?T@VdEW1}OD>RS#q{ZtVd@+%Kir?&8op+t}Sqg+b0b!@Wv-Od@_e*-)wJkM58LFfX>E6Vwbm#} z&+B}`I*$5Z3pP$lOW{eIGB10XklLoAjD0UO&!nU*DSdJwM`c0T)xKS`wP!tPpBilw zw7O;9lEs^j?wgspebLG#n}iHsohXfy*hxR9X6GfJ<4iqt z?CGH(_q=s0>NuVq{iJm4+RL;fldd0_WV!e0lq${>ZEMaRx^m*)vR!VPOlAx8)gDM$ z+d|&u6TOZd0#tTU5GFGizZ^TFIJAWoxUSz1g)W z&N=Hj_A?#dV{2aq{!2^ym3mao^L^&=Q!X;McdflImv$~l zJughFu0%;tLw5Vghgp5OH-yw1CDgrSq6(KCDLOZuSMkmLeY%&8(srm_;7xj}d`Yu= z+3M7qS;tNVsii7O^{IPpTVAQAz4}zV=L+>VRd0;b*0nd~rdP<8x9D!1#lIq`G4j{U z8!K}wcC1(wxPmh=lI@$=L96u~=L8;oSiLv$M9VgRuBeQhpV?elujL-CoA636{Y|^l z(zJ}3=N@SZCY1Sm%;o!D(>8bK{foDJSP!kJOr0@p7yri4gl(@h?Jqs<+m|u*SJ=Tr zt@&4Ve&i|MaZ>PK`+oiup7I4}<_n0ja$jnU{h*Mj7JMi-x~ zuJmb@qj!zZBI{MtrK@Ldl{1{WZxy?Al-(>XwfNWnpKUy-C&u)8kDd^>?>NY%B&-jwBTQpSV7c* zXpQcoubu1HD02Sz<2h%o@5V)aCdt<`_I$c25p&;Yv-$Rfb8c@WLY{tekhmG!&)KTX=Z8k9}iUotjf;3T63fo)dz zZ}wMQscY~Hjhj9(px`9Wmiiw{9MiWj#eb~1_3WVBM~dX9d8J7a(1l+6qLw3fTE3X8IF-;g+2 z>}&t^?9(->ua3_<%kKP}gT*{^-XG&?k(m=EjUvj`A9_xHd@TM`XJn|N@ur2#BaPMD zy8cDx>l%j`OS?bUsy(K1+Uc0}Vm7wq4|eC-UVOO{`!w|TEWZ2KigG8a?{Rw+u~3d`E`FY4Pr%gxV!2wTtReU-5`MWR$U^Zap_>ix`CNW4 zcx%1Nai4#A+V{S!_`4-MN&EF*o`OA9MvFHU?oC*i?>x`;^;6+3#sL$JtGAn5hClNw z`oMnpl}%JpseaVEKiOupKGansad@hsV#){`37xH1?xqpH@G4m2ddlNH~3_Ouy0$r|iCWW!n~MHNKWFIGp*C<*Rovcad>P zfOwZXYsQDDwiR*Nsiz;S7H?|T-Kg{GyUb#P3Gs<6P`Lb>viidgb8Xf6KWqGrwq|`&5&pSv<_@#89h3Tv zCSO)K?x>UeCiKJ)kMgRm^Z6xtS#~X8w~A;t<*{Jk&}fu+v!U-}-jQjhJiQfP(=4eI^9R_ZPLrMk`KN|R6q^4#v zTW^cL#nhcqzwX59i(bRp--^?% z_syQ!Xgp`r?@o3d1{Rh*2l#Ccitjln|L1@?!y^4d>IsM9tas!eJ2v-K$NJ~HkD6bp z%zst6;`oZ%U=9}s?gI@c`fW~5-*a-l&8f*Xd?k)*HBHKE%;OGjKXKRdX#AeD+k=l) zPpC5}&)9N+^#p@Na`ATo&rRV?sw)_){Z;aU+|J(LbD970Hg!QU7Tbv$jjTNl7x+Ws zKGrBZIEg*kEWX)~+4Ig;@tw)@OOM*V^KSUZnJ;TuVQ;qI*7nZZ--lLypP%Ev_TywK z-**4M9?C9fi+db0X_C()uRlDl*b-SLv&zt1Z*#DsT`;`XP1q~VXJS;CKWlpGDH~Zl9 z@Cg>X+gw(id1bu1-_QK#V$1Nk^$fRt%egBLJlbA+T~TpSfhgD0T+#iN!FA8Yx-H&+ zW#JWam?3C!p+}fY`b>u)i>8oDJHPC=lb2ePrd#tUrnOA@_kzdOX`&D#)0dZ%6?7sF zEeY8?jOcq#U?7%pdRSw)+?ub%UJW$0>9~6qEew* zmzIYwHcRyqT@|!8Xl0(Nm08a9^}z>co!upx9l9;{?xLyI;du-@NNuKdw$==1jRE-0SgR5h3sM~rb&3Q+732y>>jI_ zEDU;l(Bz6oap3Y#>m2&KZg2VVh{Q5d zQggD8GQ0jWfg=-KH9VK}>c8a(K4W;e=kOVeYaYR8O^Od+JZqjG-0%ABMNz&Zi|n5K zL)PD?2smux5LvyCQJu%&y!Gww{IyHDLPPd#W79ozo?mnAl}p}+XG1Rg8uA7jozgk% zV|>o$bEn_@q?(Pcj3u+qUJXxFZQ@Xw5OL^Qbm7*kESzx%R3_Wb;t0Eu5E;*AKR`vUn$@F<-9BN+Hn7M3U`8oYAtndJZKj5i+I?|`MKmsfUk<_QPJk8uUkUH zg}0mCxU=NrRxyo;g+ks(UYK=F4&-xW6s!?onGz`W@nE}b#=4nlG6lyZS^1|F9O6{W z;IMk3(4lwh#p31(p_xlFb9ZG%EG!E>*X6(VbSxWl>}v)}HvPx1nP0qGQEV z{&3%VIOo=f{gwMe9^7l>kNfekQ~%zf1D+yZj|4fcj&ePc7}6_xGP8e{*_XO|$|623 zu98nVWCRX%_}F+J>G<64YhTM{#IY@1vt?@Rx2YN1YmeVaxwNzK_ z|BOY`gE7^!;30S7i$jT)XEV*Z6nejGKfv^ELc8skhy0BaN4R7Q3Qo_KU|!g6$T97B zl}XO6OVgI^OE_x4Dctezz|WTAeV+p-c3WmRumn77wd*)oovO2V`-TE%({+aJBEpZP zA4<4eo}1WLr@ZKs$~NnescMCnX7^USVP|*b3z|@3@I;aKr>d)#5ns2@VYa@hZ0-(B zQH!hZa)}f)cBLE?Jo~DN^K69Mikqi8x9pm_`pDx|s#`8rmX+SXokmuG5Xx6yXC=ll`lk+0SJed#$M%5E@R8$f-8L@HC zx@**b?1=N?!nN(wo|-(jyg2h5(=DS$cM)G9QS-g#H_y9&-J&k#Wj-Ne>q8DHi$=*! z8`uT8T=n9_OIm2&kH6TMZTH4)TNS=_D|n%DJJ~)>HjRv+wb3P z*H`#Dx8Z`2Ip0>_xw@qwN>BBZ`$73``F^vJkQz^ zL$$9N9@3A)Jho=*Y5koLlQ=7U@4KmbMrV`tw9_uLpJNN(dGUqsr^sC|YdkrWDj3C< z1TYIVFt8qH>=#bEz$6&pz{oy2GpcVF{44i1-zf1SJ8k3ay#ZAUd-!_RU)}ny z^x~uNm{$SQ^i~~#}0*(Af z7PQ=*)S|9&aqYjV)eGd5`;WU>p1HYXtKZhMr*^ISB+7ZbcZqYIyuSHj&pqjB!afU{68|c&%4~38S2kee zozTGQl+fvL{h$Rb6(2BYt28GCMk#R^NYPtDmi`Z zG+*+hl-Vp%D^OCe@1e%>ux(O{pG3(Fk(5&a}>WRLWze$S3FkM?1etOp3w|a7G({Cre{}iNN zuqloum&5Pc9XC#`j7E{X&&NNOtiN%$>QdPvPp8XKicR05m2+0fz6&j%k-PTa^sUZs z5<>EKoPGJPWV`*`R~szL&qzdV-yJyb)4qeVcQ@|c`sJMSQ*&FJV_SA#<&Qb=k6BYE zF?r+3JD$53IQ(@^Pi9@}A(7I~`upW=H$nN$ZC@WxS?gGS_QKNa6ZZGEZCQF{$CGWp z_WXHVTD)2+q12kYb=kV2t?O+obkaAjeg5~+#|h<}kGAfvs6Q3F^sX$&M!}{H>m3e9 zpEQWb?_kkbFoola-oKQCNx4_Pye--G{lk;V+y6Y(e_E!p?@y!2qTkss_eC`>Ru2z4 zaY*)EL7UD8j`?X7%!*nMI|C*h5^i}=Z1>k^!Y|**XHgSuo;AwXJX{|0`Tdg`{f8<0 z?@kU?6AcxXUm#y=*TE>z*>FTj?4y9!53iF89=NF76A1k%e2Yi?t?j!y``CdzaJk?9%$b z3I2neI=D;KI_QjsVFJhjnWE^*sdmk!S zz?53Rmbsx_tDs*mpz4jMyT)778GSEZ5||VYFj+9LI4Q9BG_Wgqu%P&w^Do>8Od7VI(+5rXy2PO>#CaaF{HSCPd5B7AeoZ-~JCoUi> zW%bi_Z(e;{^y$i~CwtZ`VaT}q#b623M=s8fM>Yw(+xDUH!II}{ynbKa2v#p?&T`^R zV_-{2;FUTkxW}RB$G*B54O6kIpMo6LB&r|_{f2IGd`5s2yT5;AnANw>(F__D9*ow_>cTr?+U% zsp}L!c#>J`0Oyg#LR**xY?d8!S~=s!hph`bGT*GvoU`$Y15d2Pq(?SdkJZj8ZagP* zRPBn*nnxPz4(agRcI$Ci^)AniSI+a&*(V==q_uRq`Cl^I;C3vT&BB2#skw&dpqm>z zchLc6l?2u~4^)1vS&*ULbnd*Qqwec}5pQpw;(cOQ^myI5$LDfXW*R9?4LbdxO_o1- zt(TE@;2V`~c3z&7WBs?b5fO$X{G39>0Du(ULP4A9n4?GPz#(SOPM+QM*i%N2^^;B77%v{K-jx|WX91goF!z-Pfhz|lah+n3 za$sq3X1yKsv+6^e#7C|lMarH%{`+!o|0*z;EcDN4exF(ICqqjei=(`DcQ;y`<+1!3 zJa@|Edo`S9YurV)Ca7{8a`<|Zv(ACj=RMCk2d=)0r8WtSeh;jB*Xc$JT(a4~oR~W2 z*^t4a_$t@CsjL*vTb)!M&^NW#B}Ht`kMe3rfScmPUuJ3$OOPA2Zpl?%YK` zCRV)%>~De|&JYk_5MWI=Rps+OrI7x8)70p~^i<#fI?tu^dNY1k{#c-?PF+QLS5s+D<}N6pr2S91y}epFRizCc7T za{JNPew~f;j&iTd|MTw+OKwxj@?4GAAKq4M{uH-SN|;rYG0nbmvcW%wjp<(>iIz`G z-@j~UpIGwDZHXq|61!fke-pqxeX?lDgRG6$*tV2q@7$K1>k#&)FQU7v`^;DNH3`x8 zwpvRig=sU{tZ>-+rAX3OQ2TdMW?_lJ93!!hX7=wlTy_vKc=OHQM$d5ewgOGp_{f9v z?v)fCUFDwiNX>Hvn+^l3-!onYM}ZY8#S@?Kv>XkPHf!6WvHZivmwDT!-g&BcTyXn2 z*6ltaveDOd^Rjnt>bV>fE-S5CcJQN&;wHE4>q?`ql-8S<=9^TMPcQphcDmj@0jDxui)4w;&40oBcJ^A?= zCjDUbIr%=S5_|%k6P|=jv=Q95ra{PyQAEl~+2Mzx*h7vu2hNtm!n>Cqi2CHdzd_^Y z_16=wH@y6;BxxMKNa(HwpKE>bm82bKYF=Lo*v|j^o9juz#@-u-v!*BCUU_ZFbnbXp z4e94LX^;2Zn#8Q(z-iDZ%&{<1RDiKOfmMrvt>tlA(XyViJJM2)cFqY-PWh}Uf7wAz zul@Vwy4K6LV@&$o{Z5M*ckmit>Dm6~T~h!1;&SO6bM7A zznE>d$(c5XL&E5Cq*VC!S0&xAGeo3{h2QMC81GZHWcftbr^{T^r${q?K0WWX+w&Pq zT~>84S}p(hXvS%0n}3`lEVgdkdK%5wGH$i~;#>B1(XA5p`YlO6)eB0kR$VTcxLB;p z{##=tW0pzijG)Tog2!rUW@-YNYfj#p5aGb$pgmI!`2kh$)?)h5;5&H~?;SD$B( ze*DqmOJ{Qwv+@GQga!ebh0pFi2{jQ3`!;KhLiMJ|-CKn#k|iUv7MIJFIu(5gTK$$k zr(8>MAxCy?G<(ZeRuKoLDhG=?u3+Ea2b5milesV__V><(zn!&y`~I@xV*gdxbTX{y z0m~Odrj837(V-!`qZxS;nAbV{v+%g>dro<8p-Zi6+1AC@`<_PY3w*bE@Jk_I`k09p zyAuPGPy(aW0md^Q{F%S{z4ks}uE6$=fuT5e!j&h2##4Id?#^$Xd1(Enb+N@({1^7+)4eVV#G*)h&hET5HPRa+?+8 zP2N7ibyI@DoVEWxXkE%ZVOtZve0OqG(Xk7U)#fBHuUi$8|Ht?AEWWBEAEXi|mCsr8 zjML-zr{FFN##8+ICyN&>45EZ`nJ=$z56duR`l-O zerNjSi<`~w&pdCOdR}|ac|pm-x9|2nj@thAokD8@kL!c0>SEy=R_-|vbX}Nd;p)=N zFXyhs?oi6CY`gz?g7vM-wKwOdTHMV1JoWRjbw06Ir++_R{B)bT?d@(?rWS_nS0ngh zT`fLcx<2<A8r3P89v`(d(o!P-RjW48)oStIX&fvKJ9hk{F!jWIAi7C z`LCld9DRB6;IDZPmUy{3Fk4Hnh-cn=bmxP^syofCZ_iJ-%l>m};N2Vfl5HQKKDrj! z?kW2uQ1)b`-~(T~2j@#3xPQ;pmGjd}V2nE8E5an?;K4hGLEv9atA$D;-x3ENm4{Yh zib5IrBGtU*O6?C%{-G-sbM{ip5<}daXT6d8@8W-V+19+n`|GZ*{8edt?T5oO z%fmCD>D>0U;&8vGAUtiUkk~^$g_GP?D{ba9uqG&QFL}Uyj-mLzgZr&bx^wqDeYks0 z(7(?U=hsKrZPt~$ZE0<0#bMSlFY?Gv7Oe($Aw|J03+7ccF!wnxe65-L@an&^Ns;>9 z^QZOM|GXMsF>U`N-MUNX4|hcb>(^fg#}neJeoJaB@2GBkbhKyp zgxVTc-6tngOw(9BO*TI}JIA{EACJ|R7Z;a!&sNJ7SsApKhx~l)ZQhTD`oq%zv@p+E*8=XZplkG@__NZrU<5#M8U&Lg?k z>|RH5pVQOrQuXWpir>yrlzcI@QEK7Qut_0Nu3Z+h`M7@h6QlD+r)xfMv*=!9d|Hb+x8z(8 zU#i}2KYQNND;7InColhW%I%;2#P6?;byYlFDs^`b!|&g%MXYN-Gzx^A`M}6!W0Q7> z)jh`WUP^gN)5(Zs^HQJReZ@Z7t`e**=BCt>sBWFO(MQ|E$hu)^&8#ZXZ-oM zTR>@p!7)LdBL>GLQ~qvXSAs0lda|?@>_;G&%fzk@1nCvQ2pqB`O2>31zZoV@l9FJ61Y%_ z|D%GaREwDUhXkjo5=Yg)eUMOGqri4Uvt!MQ4IP0EP6DMH@9kT%!(52#UCZ;;kN;dz zx0mUA-&PeODaU@)U3}MszOTvid3UBeEt4&r*pu_5W>SXfja1jN#YwDRT_j}hcbqMY zpKw`LfsxZw$B8HXrz6jmvV-bAnIg+quxPG-;l>u&R#oJ}sqixW#0B0>t&a}hkx$RC zJOB4n(WBr*+0$2TFFn0f;BZAQ(C7Jy46ou@HjPhS|0@^$=k@4yNb<+i@Ai3`?Tx&s zBYc}#;T&g&Ye19mVg*;VcLffcL)Uw5m6^^zS##$+$+I)O4lDmr67`W2do|5|^&EcA zSH{yn8ZErVq~ct<%)jy2o5ClHmbvP8UCfemwSOP<=<25FzUt@v;_up=QSz*QO6_&MljSW;{5eZYS7jZgZ^b;;WVZ69d-v?CI!~)Lj+W-*silr6aTcDQhw0 zDm$#ZxiUmMQkw%miEDYDfyER$7K>1)WU==)sPcSKED z>CF=(yzti%`SErAK5iY0^P3mlP28lPJ9TxkJon8L|Ezk~$@k9n z&^~$gdEj}!?7bY3%7?_%&oHn#E#O!cW^#J={*E60 zx%=V5-z$ozqSgc)=iD;GkjHnrV5PBkcjc99s>XR||HQBJJ?3}kVPB_2)1nA@7Y-p0 zhq?K^uQ?JNSYtQ1s7h^~5ti?MEs&!*Xt5!I z?{Ximy>H;Q`Nx~9vEv|r-v_e>cAI^&Tei;a^~ia@a{AFNW_I?x@4B0JPtfO!+U{?B zp+oQUotJu+b=Pxm8b3ZAuQ7G|Y01egGfvN8k+eAEKRc&o&TE_JC#;%PlqRlOz+L;| zq?1Sap2crYp9!3C{Eo%5rWX$#v;I6{cv_@n|J}JG`A@&?nQfT{bsiFW=bof&*FUBH zGB(t_^Tzr-YiF@OR>_zJtWO%vH{506bU$#?S3mtsr-0Mx)af5i1?O8GU0nBLrFTt# zxP1-RR}K5(_T7i)^%dP%9P{nWbgA94y(zu7V^7NZXFp$}zxQSFzUC{d|9L7_YzmKr8-G;YKX?7_qUnC$%Z~3=|Eaq_ z;MJpRd%jMrD*Nvy+O_C-$L&ttoVQo1|Crc2B`{n6`>4Mxsk3qS?}@T?Z#7aBJzxBN zuX;b=VfDL9_Aw@|{r?MvrUp!$UKrZ$Ke5gDX;8q=?N0hEdTbdDM_MYcyEm?zTI;;X zH|u(|_NTg!+sYFk)EOi&>Q0E9;F$CJdv@%H#*g3X-d`_h3U4&jXf}?J7oQP*d%56y zQ+4?h&DHEVUIB~>1+3)(oO1#U-8)*`IXKHFu=-BmnA5=7cOZ1h0Zwkm9Nian-3Qga zl+`tStv2CkOVns{Ol)4!);#Tr`Mrzf|Mb2$iWV>?GjJ|3;MzB>#Z!W_Wdf^L0sFKM zoKqM$rwVY*cu>}SgJrpTar+Dw&*gH-Cpvmxbl3*AnN7>Ovt1?gV>!EE{m18J;*&TR z2ym(_vd*2v8gzg;NP)%p0Sm7RNBM@J3(O zKh)@ZbfR05!}Z@JtuT+A*E0lm9M{orV9IxBJ@iOg;}MHg08>~(uhRk9!xG*9B?>sh z3kn=2ux3tR``P+<#RTrm+NU$h0$K#iCKcbA@vrltd5_-%mQI0=qDRu}k1?hsb$MM7 zuyB~9>N#ms`=m|oCEUj*=~UKF5l^x)ESn!#Yn+&R`CFn%WDU>B$uAyF&^m6a`a@!^ zMIBS-l-v)E>7UqE-v}z(E^+FGYe&1fIA*S&raB@i6&UnIXlFV+bd8A(XdVR21R+i_iDTk(| zR~X)DY>n{9Syd{g;grp*zsho&a>0$x1)G;j z-FzDOx3!UfrJ&wX=}l>@IoHd=U(_AZU@+esS&weYl`+3C`%R<+#IUT*7B5@ z%Qv2qbC2@0I^o&U#d^!JMD65iwaR=c2j+uXYYxtubaWT226H($pdnwjS{r%|XePHpx3SCU)0 z^j9AfiU?+|AN`m z!h}0JmOn4+RV>$i&|G(u_0~kU1qJM)KkIfa7PCy#)$GdSzP&+PJCdK<_5C;2i;UTB z;`v28W!H$;t>!Fm5#U-Hz`0toez|Cza?2*2>@Duy_IlC_KeMXKtd@8fUbiug_5R1A zqzxPk3%KST=yJ(i@pYNChO1d^qnvB^melNR{)@NV$#nB-sy;Ua zTSWWJY|fbvI2SN*P2I5d%}q7-C&>~l^HZvKtX#dzWYV^Mt*n2w=6!tDmMG9(JY(m~ zZq8}{HnjM0=O}#f-LZM`MuHo z0CST=YgZy$?xphg$LIYs&rv(@IW9wBKI4k|CtkS|!W$-RUu@G=pL%Oqmd;E?o+1IB zqt!NPovUM~ww5_?x;9#g2?vVTH3rFh^h91@pE7~tYuI6C^<6oa>h67Xvwmuxv}@7I zD)*%2NmsTP>g}reT~f(+qHtc%vXWCXJm1JwoH@SUMo6{iWX40^xgp0Ix9;DWQ($6K z;Fih0pXbcMKc`RJus#}d=GV4}Su)H2dp69knwD-=TdH+D^VG4^r&le%b;eg`|AsSX zWhZXiE3T6z8q)G3>yOw;(>0s#e4JOWyl0wtP1%#fxmKsnzd2@mEAzX_o;lCfT~wQU zW6fEcTW1;1a%OtlN}o`g(l~XKTgl4l|CpC7t=j7~>9EzBcODndTuMp#+WS2F>}9T5 zS5F08-?c9PP166CIZEjPPk+svwbNqm$%8#F18#6ltJ1k}SLbMwa(vX!#*gMbIgc3m zCNOy&*m`iq`UBr~^jVb+G%m-hJeUQ2s^ocCAdvknE_B5NfUxz@m`)#g3-7}Jv`uxbl1)xN!6 z_m?TMOX+S$2d`t;^gq(6bFX#(J+;Y4tn5&V;4uNs07k(Dj7kqwZ62_+XLNWnqFbXeVihRKOAf2^f*{pZdS=$siuJkH#3vT&j z;=g&#jeEThR&rmxxX?Pbqb^N>iSq#Cggg293>-5WII9hMIvLZuANDsSaKt$*5|Qg> z$vo4_8j);#?UL7?dxvxvO`F5Yb-_?k)5mwl70$-=xewBB?>hCd%HhH!$8`zEgBZCE zFdZ*qH+2o3`M|Y~JLfN3I#c?T!Ub%d1?(p}df3?~WG6)IufFi_uFAHUooCJG37hp* zMzjfE<9s~3akBNhJ?mu!6THndQrRpoFz`3@CIxUV|FBacjt3)p_|V%EoL zQBy9~dItzj_;>i2WbVeYC&BGxN;9!xz?^ z`keDN`%eky`7_@$=a)U1^ZCuOTknp%TD|8*-Ile#^);V9Xh>xfRhXSNfn&h|&isHy z>m}G2Jo5|E*zzB6#Ibsr@^fY>uqGyKZDKgq%~*eE+T9I%_4fpdo$^_}JZACf)v0&x zdEad-{m!#|f#(r^f6HL|j}qrknao=&)4#>k_gKOCqMVA%&H$JPqx%IgvWpUxAJS+sjqIg zcU?>j_3RQey1*dnz{>ENGiQp}n|~|?W$X(axF$CEE&k7>P{0y)fn!3#o8Z~!Zav)n zFR0t}-?yX-*Dm&{ov(Xen9Wn$H2>@2@Z6C5XV!UrbUO2)ZU3{L`#*G6ze@`|Folts z{{UmSg7{1Ywv~sHLm1MVCU8zGVEuiUwdgjh5$l0ZW-ILcH@!ad$SLIaWV=hsVwYC$ z`8P4`_@h||dn>(pHI_TaoHaT8@}%Uu_xu8LSomZl4k$SKu`w&8+_>=2xkFIZZ%M?( zN3K1Rrg=|pTzu?4LD98OBI2eyiRQGmSWVZLx)$DK;4+RH?5Y9`JR6J*`$rW<- zWEBWxa1;_b`Yv|QzskjHYA;=XAAi8Vk54UU$_u}_s-pUSCnO#^9iOP`zbxkFr_?hu zP4l1KseF8LigxtA9?Q+od>bvxzdiYAtdY&=vcD{Lm&u#Ax3^B6lo62Rxx}ZBOZn>F zlru9nrYbHpynLtfGne=ohDlpq{46!j+!BBN(%tIs`VWt`|Bu`EC$VLfZF!r{&c9VZ zK0ZCaJpTT_+CN_$SEsxbTIMq==a8mhQ%e@F26J-q(LEoJ8T0R9JIwvCQS8_P7GcL@ z5y{Sc=1(3w3)tT&SmSEY$-?(G$fuB*YfgpoB)5<$g~v>0IX`xj$*(Cm&VEsQ!ht_c zB1Ilb-6o$rR3?X9TKw1L^ZG3ef&U)6>}5)H7BIV+rk%%mXV({@P634mMou52o6MaD ze*F^SRGJ{5*y``r$ik`oYRhIn0hI@e+#XUZjX4~cS+DpxHs2_+&`JxwqAkxJ^C{3n zd1^_Jm-f~#C)9o`^B%Y?<9q(p^){`p4YJ~>%+MJTphwCqOW#sf+2E|+~aU%b+==SyV9;;Cg(S*t^hE?@j-?0XbteOwESpZ{PQD6KUy>}i&Z>$JY(*q z$ZX-Tio`bQvLA^p8)_#7=kb60b|4^HS!;vgKczoS4-7Ae2FI4I3(<+~B*>=Y$^#ISZPYb_GonDbXfv<_%38%f zsp4|((mR%>0m3S$Y!-{$y?9?b*flwJ)8%Iu9_#NZ1hMeVT@nY|qOzcwCZ3_tVXk66;4tP{%9|6E+XwfE9xt^H>s4$l6a^*u&NsiKj~ zU4gUu;`?LXyYK1EX;{!G^I>gD_^#~rvHH7nuGNX}|Qm2TR=d@HxG$vWt#m_grCeq%ojX-X@Vd*5Z&**M!Og+z-E2vDxy^x?uM_ zI-bAw$KjJ9e08F?Z%x_NrW&SkN}t8#Dz{2PlQsvFQ0)$;MMswHfA~O`M?K&G+lGR6 zpM*mZf0AOwlS*Cpmby1Pb1&pf^f>%xXJGq@W@WCIGY*?w``B8fbN}0y6&5!4KJ+W! zQ54{<^lkzptbx4RsulMG9v$~lnv$ip@$ayfZI0PJ4Vkq=fDDl+%XKfUwx$yxD zx5@*SGyxYior`mfW?h5h@e<*@^YpV``W#;C%1Olr)%Zy6fSbwjk_R$-fpjau-3k24}-!V`Q`7xGGbU052pWufrD z+N_Z0&c3~Ep=*LKKXcbLv!AFG*qP~-TzQD0iA&=kPb9+;**D*0q?SHhe%OkUNk*VK zHnB;#?M8OMMAI3nN@51?o>~eUS6vY9TR)Tis9XrQlCzDQ*yfO>a+gHh_dd_$Up*&R zF75hdpACJXTUW0Qi+o&uZNjc)b^k>CqxWBK6%Aov+bwihdX9t6tVdq_hgI_m+fO&K z$vCi-Z8$8=QpEnuEqqs5hjZ!L=va%C@ZGns>b1XcV1L&p&et0okri1T_hs4k#C58R zl=n)WJhZ_#SN2hWR7*mm(2|9`zn|tyue*K!-=WWCWr+uwc@{7#u2B`7cY-BaZbpms z-IGmXKL5I=?`S!AdqQ~Pv(Wr@+dmIIH*TLOK3P{tz2*_ux=in~hYajF%UKjX9H%iY zlipttn!uc(z`k?S5%mVqI}es!40*e&sm-w_MMXXGq>`Ya`A#=`l~-xLwhM};uB~}0 z_u~M&_JITZOsXvsCmcBKIud5Gs*!kFuB-Xk;7W{Lj(V@54mbQUdtsaPgXxG zp8r>8f?D&I*#Tmroe z2lt7JYzf1Gm?cAFpJoL{b3w)JL`vHn&~ovr&8tcv}cThRWyeS_X3Wpno_ zTb4%09Pga4q3%PY7{k^nMjVW6IvX1KXDndVZ(!t!3TP6DU|{0*XkbzcU{XwI7h3Y; zi1epbO3$BUg_|?Yu+Lr18ftG`sG_Nu{>MX-Z!`PW6Q@`0@U1IyC=LmpR-L=^{%Qr; zBQej+7F3?itt*xeFwly+X2k8Hz#@M^hh6yu1FMQdBS+6uM&1GkW+?|oz6}l>Q7kSR z9*muVw|yg)nnR^I;allNW7YSO<&`FCH=Ufgig zmqWe4QKCtTRdG)Os|ttX!+-7*m?W-DzE!lZS>2B@EBkb1TA7i!=lAI!9jx$5^{8L!@((iB#6GKD{c`&HSU{jpEqCoh@Yt5MFn zle@Hf_1f~3lg%Pe8sg2aDQ!Fw&>7s)Byf89zG8=Ed2bdoevbO9z-P|wzG&^=O)Rmi zzO&D)ywqI3Q0~dnke%^$r>@=mX5~};?rpvAj>!^}xK{11_{-n^{@1# zNi{Fu?cs1+kl9OvH7J6GO=N?SmX_JXjxa3{V(hNd}kJJ{jB^k z+y0C4eo+&R&xI@a_t;CiZ2IH8T1a^60fT>24+rTaO=gmt!Km1wIiqm{hxQ?d%4RQ( z)}RF}hBp}1YYxdCVAP!Bq&4S|`W}TqExt*IY@Xg+wfvLZtzr%FH;YeJ+44VGFtK}u zb(Z~QA?tNoj%I82Pq?r{VveKrn+;MuYyT>D9on(u-G}LqFDS`BVN{)0a6{qylUKZGTv0L6LXp*9 zfo1s$Q_@I^U)XkH<0<#{2=-b}|f ze+^IKuRRrOJU1#eNT2YWd&hI0jG^?M!z!=T`#(C%eeBZt&}3`C;`oBu@I&8Cfo9tR z7Vifw0TQkL9WCYu9Qr+_e=13@{bDwo$9tp9>7D~8I~5q_UvaMG>FIQlOkH?P`vqU4 zAhUx(iz|nMJBNZtLyL#TWS(b9gV*2 zM_hPCwwyfUdw0s2Q#~E0kDR?fd#i`iscz#{iw{UHe$j2r!17Fl#i644rp1;llm7hy zYtE|J-Ksis_m1DYBYW?)blmURsxIuu+9?o~IVW3wzruK<O~gc#hd@{M>RnC^+C_L6hW*?RAeC)j!N&k)84G)<1#L z+Xv5|JaHxI_{U_PV-EvQa~<4xxZg-+XaAq2A0Gy&stWPvatNF~{wq+Vdym7~E2ol$ z8@VcE*(JC+EUb7n8YK&u8XV8;-YsaP8(eqfywc$d`zz%nws0u01}#lmZ22WnHPBO$ z_mb+};NKZRZ55a1Uvd8&aCzN|vxim$m=rXL9cWbS*Zs z-D?bcctro~Fn=1HIG5kvmBS(Q^sk>*vu9qqx#5HiLnE631AB*+V!{M{0VYuiMm~o| z`3nb&{smq>wBxAi2ABO3p%!oKqMy1gl{)<1I{a(!ie*U$%SyF!Ra^y1!nYmniT}DP zK{l-ZYfqADNAg_P1wCCtxo5a`spOqzxcaD!_VqliJHf6g9i2hM)iQn`WJaMXEcfnFnPbZk@Ne;*E`!L%-!H4b9@r(QIjt& zf;}tN>mHuk8vaJp-S5s3t0z~dKh-(Qv43)mtL53qT}M0SEe`8`WHXDr}l%D`eM(7%A|pO*97*uxt4JRNsu?n;o|c9`ebndy`7KJJNG_?O$Y zl96o!gW`uSbB~sNM_P(xNh}?Hl?m3bBI9#$vD1t%2fUAv#wUI+v_@=jQT+1a-7N>yb#Re@dCzuwWP|toX zQ^;y9ZIuuqt2z(oO^!iMw*7}q5{!J4+Ac5T+rmh(CWdFu4Nj}b)vzr zfyJG}MemsC1j$EJ4lbQ|`CiMb@Y;JBeap^BTX^%f#V+9KVgGu~ac=L%iYB9-&Bs+Q z>MJ&FRA?$)s1WyLr%|?d>e^mYrfc0Ecl-WjUVZx9p*P4&jc4+=Sjo@}8-FyF9y~Dl zTq9dYL+DDDc)M4J_8yxXclF|94_3EOMz*XC_YxPng{f%8-?qA6XX2+dqk%&~_OfHf zr@6cbk2b6f%VwIDD77uad}(-9Zo(7RlNB#(LoBc}law?LCEhq9E})PCJ-R08 zty=tI{{O%x35P~0i&go{nBosJuv#>5Nys{%XqhA#m-hCZ%+|EmTkpL*dhcmp{=b|& zPd+;)C9hz~8Nam}AOBz!InluTfT8xWxp*j}(1!-Df`$*vx?~KxJbt9S+jii~x;>|p z^EZEuX*;#JZ*o50d%s`*9tJvQyk8MizbRXbfsx;WOTD6zf5ATnaephlTr0`-41yhv zzeJe*ez25myZ`c7mh`j-r&;gz-ibf(u0VPHNq+T!e6#86E;N0Z5vajFqg1-t^=uG&p$tYzfu;hn7XJq_lt=g;;lJcjQf4*IjIs0~%`>Bg+FZ>P>Q59em zd6DyYN|51+mcR`xx99bmGDhYe&b+(xImf*Z=J6#Pdp_q~EB^iWwoE6Z;Dbg@d5K-o z%q9^nffB4v2Ly$Vp9@yb<4!LLKA!IWJYn&^+|$34?nV@f6*RH=elGml?IO_{yn;o^ z?9OVwi3P3=n)&p!{Tf43^H$X>=seMO^GL6d{NmhO(P$9FfsUy-u@U-9EPnqL#| zm$~Vc9sZY4z%H#-&?LVicX5a4`wGFB=PlM8_t=2VimzP$cxnTpcO`X>>0 zPegI8GSZyTWIlu0^aN9YQj>KDi@yYG(1{jngNrG7tCRn8b+3CcG2?Stja2ud;J(e@ zFaOIp&GYh?8dqxR*9EN4bsFC6R%sDQ^K;)J;K$G!u;Y}u1Ye9xvC4`K)A=Izwmrx= z_@i$<|KXX@^VzEU-Sun4rv~~dPnh|mIEdLfqvg`Xmdj^Y{5Jf0(BRi~Y^K*2nVkRK z^U4=T`r1!42@1CjD*E#3dbip&?!6n;JySkq-ArD1LFjjw>B;_(S=-mIVczz8Py5M# z`^!&W3|`2j7aD6@wcY!d=RdAgPlw8D>U$SF*9l;Dyx_gBq~&?d)A?QpYF24h9%j-G zxV$0!!G62_m)76g=N9=++p@&R_0s)g=B9aHPA2hX!0fo#x*Lza*{=#-FxQQnse$_nY>h!@lRHK5qOeE!eE_A(UYg# zZ*RrsJ>DmqX8!)(zQa%W^!A*7aXzF^*?(S5%9APP_lE^Q8`G+Kz&nbRZx*)c9uE`TmLAx6Z7=(Y# zNNii$`t4@Alw#Kk$!?=pj;wwQ1U03mPWZ&BFe&NOie+g$*IBdXH+8u#S{&6lF~jrE zj90>rtF|aik2U=n6BFttc`bC~y<4JDt{YWSBX31cU0oC9*nWR~@=1}L4f|K6>TKS7 zife6o+{amOrg$IfS~Kx#-sR*{>t z?znuj%%&5{lVdi`d2wm!x~4Z;FZ5bwZZv8;V|>|X^FH&(Hg~vr>RmillQi087A`#a zpn=JFMc|5qfi5yxdAoJHR$d8;-m`8;cH`}hF%h%xY`q@eEW7PS^7+nBFxGQ2JZL%7X)%fQj<@?o79N3?08dqC<$Epd)<)+n4$cnUYjksR zaNN$P)05}ze8w_sZbVb&_TAr33vK$OeCKGT+p1R`eE;6M@K)L{WK+z#682l%V)lgw zjyC7LFBh3F7u@sV;O~7e9xJ-?{d#uV`2L>H=bh#M&YoM`YIeGA6Yu7?@c}mLmmLQt1g~i8ap`et)W0FBR|66~^=@c|Q?7p|V>hbT-{i{~lsr9E`l2%~k&N#rV zbfM_V?5?j$kBureCRN|P+;oW{-SPY#4Gzl!UY;a{W=WYw4x0c*?zjU7g%=61sYEm| zrzBYPw&YhB%}JEHm2g=4mH?mC9Yy|1i32Q5h8<2aN`l=#=Cl4<(#TVla63YAh3bkf z#Xr$^Uzts1=CNo{U|q?;z2pP4NJxT0l#H^Z_<{yrj)MgY4>C&syM4k<;-H|L*h@y) z*BS2C|32uQj+#9E#iFhI{!G-r@hL*#=jSDm~2L(znywEW0 zH2d((r}=6g8)MG3`dCa9+x)=!jOI%AdGA8FeFZqrt1e}oe|(YO=CY&y`D;IG#dvy$ zohj0dTX@vx>zl=fQ(sg=zn!ATnLQWHx@OY6@Bx$kgERN1{cF>3 zNMRC|+Iju#yQ?d6Z}H8IHtx4s?V@X%_|$`GZ|01WTftvSRxUew>RiC#Bf;N)gv@=y znX;zi=j9G3(^WxtPrFzKUYyp+*Hqxm*BbEIr0Coyc5w&Bh|^MSwjoMFX>ZT6Y=0H@ zSk&xKt_dOL)_YDgaUp1`^j{WcSi@7;+a>)En z78N~q8$`N|!4bE_GFeEYH5 zTBR$$R;#Kl{O0RF|sdN!4e4 z!NRjuQZ@?vo{V~Lw|VPhD{$VcjF?x4P!LE}F70TbM9; zYrlBz>*&X`?0duJr6_i^#4|@La%fHz`Tl(2!qP5gkpLz&3&)PT9meKi5ss`0ADp!A zy`EN3t+ahQL$>3)jg`lIQr4Z$eOJt$cKwX1!5NLP*`1xw0_L82x57<1mVW`EiE66B@+deVTsw&K=(R5))%7lhC^wN^-X<+vhA`acW@_zI=DP zj{Gwg#W#vC_>8lo?>`g#_)pH}SO5iJzTEmD<9nd)_U`m)r;=M zA1l3PY`1c$f2w5Y-ZZ$c^;5}u%XpSsvM&=wzaBi3<`W?D zCVI=p156SQY)1~iJ3gfD9{&Na^)57yKMVX`IqBZW%^?V@YCCmCPN_cC+*)M({ZcO;W;m9g-fX(9I zdmA5d8At9j4I+2iBG2}oahi(4LQ01n<9B(;pY;{fmYA``_F!QQJ$+cI=(X^C;r!%p3f#MAtkBk3T5>PfkcN_n>0H&ua^R&g^DP(%U2+ zB>G5y*BoK9aJO8xI~TZf&z!m9;w7DMfN?^@w@mrp9*)v07Vu=wmrY1E%ThL*bzZ9C zv3b>E?q9N6r>@KYdmtlrt?%HY&RTcNMHOC-LcEKP2R)r($ zOQYMKI53+y@TvG^a2%ITVbo|++OK-5!%-#X?A*nYvt*Vn_I)~)|CnMwYiNAp5}kjN z^6###z9VUSDN*)Ove%ox8xIx;4{Vhkw$6BMduWk`6wmDdZ$fcDeYf%pqIm>fwQGeLZ?Z+p-H`fNln5} z#o~|>N0Wq!i}&Mg@yQG8O9o|9MPjRpb); z5Z4svSh*;@*(&4eN_Cb%kD@z4{BH$h6EfP8R@8Jcs!w22>u{8LaDm6tk#mcK)E7n- zjzdQ(=laH7Sfbllt;E=NM7Ah`quDN_?^VVj*Nm@~NA~1MZ(rF}^X{N}gqM(jmr#ux zSH=N;1}9Yqrj<|nUrG36@Z52CQBgT0FZ$p`U)9U$dQyxLqKp$VXU@u;>GkX$V>*lP z8C}iCvllhiST(6f99k5SENXO$JHUanmqR?6@iH9^OePGMX7K;)(coR%XykTp&w(YUPF|7w^(Z3h)h46Y&sO-P zY@0JnPpLJ9-GLwr#H{@oi**=EW3*z6YWOnJ2qa^mk2*z4*ww>g{8vch~(=Zk&5_ zV_jyh+e6)x%f&qoa!$DTyeaQRQy%l4IF6FWhdQ#BciSv>Nxuqx>*@8>b5(?#SJsnT z>rSsaQxNI8{GGCPK+mcfNku2rMgKT(cD(zjv|h}Wfo+ZhUj*ZEt0is@aeqGC+o&eS zdu{cpOAGYw<$bTxS9-@4`9UvrS8ve{`He+xTmc8T1>Uig&Yo6urIAT4?~bF_Mc?~c zGq$C!EV5Y@%$N}Jk4YqA-@`}8-hG!Uc*3P~y+{A1(W0Uf=|fH%I$vaRP4RGYF*vBA z+V+OyRYjXZN|UOH#s#y3LBBX$$~5O*dB?bVL*KES7@ZHZ^4zwc)ZV`J0CNk2h;POO zyNObZ7@NOlrca!=N%^^-i4|_GgL%bC1JWl~?AU z4vH0j6sum`x-Mb9QHsF+mp{w;1+@#MR(~`yEEKZbxI8PwGaRG06uMkKD9gF{qtfD{e_H)<%I24qC+lnb2!CIYuj>5d!@Kuxox&;>ha{%S zEY{I_w(O?n>Q4s3#YsIcXDWT>_FvtvA(^WtdFRA)X$vQ>%1G1b&!+cP6)GGvRs;(3 zWc+7YGGWq(RSKKt3f}jLJzIa~)RKR!!7nFS7V`)(3&|h!QF7ds+WrB}9vwdLEot$Z6>ij8( zx?G;PrA}Ms+W0V`rCjK#++lTDbyeT{B_YZGwzz%QtL~FHD6(95NyrK_rH6-ny)~m( zt<)B4@n4>@>1*KI#CM;gHkU^4{u+I_H0Jczn9HTHx4*_dE{%KrHSTk1{O_;v%w-AO z-x7q&5~aT-Dwic`e_OWhwzmDm);-y)TnxD9I4Jcvsk&_FO!?62b7AicM(za%>ff#Q*>fvIi!Qh{ioao0cyW8h1GyXj&i2+$mc5&D`%2TRk1SuB z)@`p=u4uZ@WYep-L)tsmw|D|){NJZY)u|GneswKYXMRvM*kG{2Xr zHnacR-YpAxddsUgYJ?89wxsu1eO>?YM}M+qQ@_O&>8CvQ7cZ1v*|o~=N5`Y6xse}^ z-JhENbC&zp4*Q8cv$E!VKj3nPW3KSix$KSd`5u$M`%m4!+$m*S=L*Z&!oOVmEnF6T zcW!PQ&MtG`B6Z_EC@t+;x-@$Svl)jPVYXZn3tdUasu;@!L} ze(%~`z5Dio4ZW*eE7BK>$IhHR^?p#}?qy{@yLVj|I-tT(bAbEL0pXg1(ti#r*BsLR zbBKG-j4=Mg&NWB8{~QUfIT~Ga)Y^tQ_Rq26n&Z`fjwjb7HT*d-+2&ySo-Ixnu890R z#r|6AoR4>FSLN)kmFj&P4Ozn9zrX#Z`nu2o)gOP(GuK|={(C{V_M-IPi^{c^nE#%1 zo^;9j-`~s5wO73VUJ3qt#kkfuwDwx|-)qIS*Q0BbDr#?Z@4XQJcj0mQbe_V!6=nLx zirxP-Z+H98x@dLloy~P22lWTF_g??K_qq1|@4xq%>mG3bd+_@2)nJi_%5{&l|2;CU zdu(0zSbATm?Y}3%bx))JJ$0^2O8EDz*zW#xTbcBYeXn=4eVQ=ovhmY zCA?eXK;4_u|K41#dwcue+sAe9UjKV{y6%ZE!+YlX58VGh2-kmy@@F)8QywbfinldWuPzKYV-5?c_;%%! za7Mtws0$*dR%t#GOTDKi75=)iQgUhRE}N}IqS;|3Xt$(!*&m6bl#`P+_1h$c z3RBO{wk-elM{>*a)9udF&1$7eU!7m^`zTJPu0j!j*pczX^Vq^US03&Cy=2a$Q(9}+^f%1ja%a+My}f^g&KMk(ne3xy zts{KabBtviRpKW&e~4DV|pbv{I2-r>@Qtez1oxRJvL(%y*Hu2McFR%%IY1G&*zlhlYIW5V2|0_ocR$&>#Bd+O1)h2UOH1bh_y)S)$+M! zsadO*%B{GGglUZH$-y_u=vW|CKM#v+u9&{Q3M|<;i0Cucx-}|9(}!>R0vrKLR)Gn2k0xeh+@| zUn9ciedvV>*%k2&k~{V>UgB@La9M#(H)EHuXSZm7)T9efLgzgGvZD2f<|Mw12xqB( zpLp7BSBMMdxwBSq^2WVObp6l~;iBBNMA$Rrk6>i4U zCic{eBwxF?!p$Jeu)pxlW2NsE?(V-n_DrZzQD%)isls+?lGhst>Gvm&+pgQ#U8xhQ zV!iRCkJiVO##JY^f|pn=+{2Uha8l}yge@xbMcXq>X3Y(Fc4)TxS)pmuU)>e#jPwZ* zd?0i(*e*HhPbKKi;QSvNa@Sv&mjs?arsU$f(0cZDC7DpNmb|>$_q*@2-8Mh?Ywf!x^_VyY_3!(|-SXIfRNvzekJx$ltzNrn&z+EYeCAq< z=jK-`Z&79ZoVwFhT()jk^pXc58t;-sx*M%y54WEFUSj#Awr`&N*Av z*cY7e@he)nh$mIeTJmJ1TT%O#J5N=ef1dp3Kkd_ugEc8S$(5&^_Z7`NIVa6DTJlWL zJfo@4-#oM2Y+{&^uY@AItHKIvMMe_rsKW-{mR znx}T*yH3b%_&i&B?Q>)6S?9|6HZL=beIh(RAk`t*^g`6_d10H~%ll`^cE_quzt6&3 zmiN+dLgn3TE>Wf%2gSZ^=#0%tmY2SHGVI%?*1L*n_R_a5PAl8wX_}iIzx&3yW8b#z zw0)aZE`8_DwQXCh1@iKySKnIh7OUOLa#{A8w}(yD_dPFbWkPqWdfwc%l&AB`;;P%( z9s9(79MBZvXqK0G$Ql0QkmS9Bc6*seg6%LDttF4c&+&#^wIJS89e%H9~+kW=03RRK#^!vWcEz^UYaXw5> z7+-pZ|GG5uUdeKM*;j$ne_fe+PjOYe?CZ$uzpm}PSGq3x?(0PH-#1RieOucc`&!nZ z`o`6|GU0X6>U&E}dlPCjuf3JH*0pM`ScLW!xoa<;?c%Gr$f+O0w1e?uXZW8-lJ_f) z+sl2LIQ`EP(ff+0;^jWiy#D8z<^9TY(f2+t6#x6eGyd1v=D5$gfq!2`uAg*%zwI+U z(JVdY^V4?U|M#vvYVN`>ey{KI?fY=hT#fNWK+R)$`JX4l|9zTyzvj8U{IBEh{{?(m z8DIN4UjFyZ>vi9j@2`DdFaPJExc#@?_I01<$N$M0HbgKqxb|y=?je98=U0=nA9gQX*UVufnfZ2Hhi?;yNRsPl|eb);5S%04UuEeU96u`Fez|pk+j6eJg#RBmh z3|v(g*y{y2ngcl6CvbFM;OH0Ntl!`~X#(f$3!L)>xE2R+EiT|(et~Pf0Qcqq?u8q; zwqM}hAHW$Hkos)Vx3)I7h7;fCEjgyqs(I@I?_q_Ymb9xa%-}3<7S0DJ&4MR8%h~*247YB-$PZY1dC|)lp z(QGKL>L$^BQKDZ^a&n;L^g_wbiIVdLr4|QDEf18OJ5g%Apme*T$^zAI9Im#0f-)-? zu!R=bCY=pf!6bV*PUX z@xG+uFQob}I7msuNL}uLYP^tIa*$g3B(>~IYWYIy#X;)jL28Zus`Ww|%|RONm-r$t znf+kVoE)UNyG3L6CC&LlT8k%j^b~2XzNEEYNPBaT_V!8IyDw?)7t%Q#q;q_d&gn}! z=Y@24vZN;Incupkd-sysy&%2klk{F+(t9tY|2ati`y~C}m-PP&888PMuunGNzHGoR zY$zOTC_dRx`m&+Cu#s}Gk@{pKc4NK2LRWu%GSZ%GY<=0-Uf9Gr*u;IZiT7m_e__+$ zVAJqmG?(m1_lOWW8<{6w5qO|bLPyMJ9qB9dGqGapTA(if`tngE?Tr` z@#4ixmMmGibm_8X%a$)+zGB6Sl`B`STD5BR>eXx3tXaEu?YedA)~{c`VZ(-v8#iv+ zv}yC^&5L)O*|KHJ)~#E&ZQHhe`}Q3>cI@1_bJwn2yLa#2vuDrVy?giV+qZxJ{sRXN z96WgN(4j+z4<9~qY~4Pn|w{`t<2j zr_Y~0bMDNUGpEm7ICJ*=*|TTQoV|GV+=X-J&h5SQ{Oq|)`z}8}cmCq}^XJcoWF48z?BylE?&NP@#2MxR}Wo%aq-fXOP4Mky7uzorE7<;y}We!>ZQxqFJHNK z<;s=IS8g1=@#@%(S68lHzk2oRm8&<8-+X=b+Kp@1u3f!$>%^_sCvUyJcKzn{>({Sc zzkU72ts6IPT)%PW^qn_1Zr(m~=grNVH*eg$d-K+vvv=R#x^?U3t$XM0y}fn&?(N&R zZ{5Cs{@&Z$ckbP}bLaM*2Y2t@z4+kWr3dft-Me@B;rsjd?_YWJ{=tI>*B*a(`0(NN zCm*gq`S|G3qnl4ZK7Rc8*0YaKo;-Q_^y%FfpPxN@_Wb$t7cX8seD&qw>n|@~zI^rS z)$7-_(h z{Q2{TuRp(h`SSJa*H7Pmef#$9^Y>q$zyJRFR`Xr4W##4N0gJundTm{G zb#=t%th=YSuD-rL;c%C%_qH`RH)mX46?=Ny+S}XXW~PY-l;r8`sQCQq?&vEkw2sHaIwwGBST9+{x*JY^+A{5tg^UJ<5epj_kEqYqq#ruC&!X7=T8|=CVt+ipZMY0 zgx<<2b3>lKcs9S`(AB3Mii0YM5z2S(G zY0C7~YPYpkt#9glv+$^!_S=SSuYPG4&seu&Vv!=(nmI*ZF+Ly?n~W1CLxWPAJNT4?#(uh$cv zmwsKkRPo8In`;-IoptNf*0%sck~ zZ*41I!m*IU-Q$qZtPd?3J`1_RPaG24HK9f5O$glPph0YJHm3I7L-=?aZ^ee4D2|&{<}&)zdp;*5^4de3n~XKj}Bk;z7~eoTWC; zJ8P1%dwRy28O`8OU1nBod9v2(%R+(P6)x&t7rUaq zERs08!p;2D#lEU9ixqfRdboRCnl$Un5)I##Ug4)MO`BvQ_I^u@`e%>JrjI5pGhee( zCVjwR7s(7P&R`7O&Chc?e-*s>^WqJ{H1 zwgp|WPhW-2mAJMs=;LzFzpDDxlIQaIOuM;{rbW-R@{SXlvZ~_j>bUP#ZmUm;td`$$ zkegllkffLy!x96XBw=r7L8)ym{k=KK{IhQy_M5gr&t-K?>r3CAL6bH!v%a!lt?9GX z=*n8Zr>nEVPv5%s>HPYsum7pAq-!6Lyk^EQZ^6Ud^4ZaMq%LgRtE*5@Dt+hCrEiV1 zjy{QvJ$>hy)%Tqjn{}UB{oMDejlcamZ^MtY8F$}J>)$<{;eFXw>9|kRuJ6898eep_ z!sErR?|VP=zJImEdZ(Y)qkTWluCM!kI{x3efc^jX<~Oj*F#HjUIKb-mp;7S6gMU^( z4*rQaqtP@>TyhtiV^;k^Uo5sQAVa4L*nV;F=^+>!u?*c^i9N zeI84-M;sDAx3RDMOfq-cj>+8|n+p#yCt@>v?hu!yudGpRQ9e!IDiTmy{j?YTnBiyn?-S?$e^sh@Z&TUy{e)gqb z^{>lQ?MxQC`@RZNzje{3c?<8a1Fyn%|GK)NZ|jwh1Y^X+N# zfA{@V^uJFt++`k^n>Vz*`Pe-_TJMRw|1X*Qwi`}+?|l`1{?|3_{Lizb8MM>|K980|Ho4Er(e>ye?QLe|M%Yh ztMiZl{~0PcUb%a)sRlS+4co6?^?7>(Plw}!a+fsGMj?wvk&3Vl(=C}FuuJV|lzG9< z{KMT#w2A#jb;7b=wJt2PyehTLp#vis5e z`*Xv0lNOhV7Pl8(;vJUEA6R{EwD|pCwa5tfFb!aw+AwKLt;3AgC<|Nu8-7NHr9lF1 zNfvEE3gyuiZ5bJ!P8BUVH`?+lyn?S=WLmVBc+`h~&EQRE);SSuAmPsVz|Hb%d(#a! z%kcKLijIFNUm64>!h}zBBu#ZmeA?lo(i!a185YvfF{5+VjsmTY_H!-ula5C8wMO)- zb}g!KR^AdZ#k6bniipWiyVg{6O>d2yv7>WaMYqV8hR5bH+m3ecINH63HHP^~^d8Zk zeXKp(zjhzr(Q~w-&akIm6J4P zPSV;rN$2JyEzLxSXa7=T*iu8=Qq5MTn#@dfoi;gQTdLo*$rhEVerl85pG{P#oWf^cc;I+OYKcZRsXc(hJR|HHb}XdX}D% zIjyp7TEfg}Q7_ZnJRMmhr@AVAw^h#GVmWi=wDw)sW*c9by+(}TKxFoQ%Q=T7XZyF>~&%e>>;ixjFaV&bhlRa~e%^pG3}kRyps5WbTQR z_NO@KzWX`vgXH|TDs#PlaDA(s|6}I-UpwdjxjFye&-o0u=07}{Yjz-yt!e?stOZ=F z@?P(>f2%oPKx(0o)k0gx`AzM!n4|Jpwl9>qwNUQYLdN#wuJ+c2?u!aqqZWQ%z^EXg zZ6&1pN=fNqtuaHF$~;Np!9i_I1;7P+<9?w7DwmL;>mf*+mEE>%lBW-a+Xb7AF; zLcd>20;HA(?J87y<$ujNfJpaew?7wY zTRF2hIx~MaE$|$nud2`}ff zuV$TGwdSnU+H+BBw$EJ7AX0j3*V;R`*53P7qQuptV6o_Wc+}&TMQ&H?+PP|at5(hT zTD5c4s`pl_7jUg#!L@3Q)T;Mf>wmpk`ps(fcdhkbq&6_#Ue8dy;kVTWtE|JFB+VJDl`UI^l4&1A!b!}ifxZcNl zOTg3ERDXgV$CQsjd9c z>%&)X4e;L5r@cCQ_m&9mold)V?Cjb(d-jg6RV!!x-nwk{vc%h*N-rm=SUM|9GOXp^ zya_ceqLKoHKiC zu=K8(zqd^L_j=Ez=)EzkcTDo$dS&;9DbiamRPTDiy>O*9gN)=v@tG5)Dko~OCBNFe z@8#)<2VPfwtKR=(_Wm=|T9MdM~@qRzB^0 zeY1B8$!wXyy({?k%E_Ft&0t#`@& z*(q7GO5n_ausuurrPl}4td8V4=(YOjv|lUU-8!1GXEn#117=<;W4RCI&6)Mwo1@6) zcuCChq8{gB8|RW5=V}>-$~VXVmHRl?t~uWF=6F@k@eZ5gU$g6a?wsh0saqK78F|WG zEy`-~&0|uHCk?bjQoWX0EOb?oLcwi)S8(6zs*l? zi8=jC{A9N2$wf;~PqW!4&v=T5@r?e(lOh|Bnk$}JH0R8#l6@5y&Yb&m=7P-GOEzb( z#GJiWbM{Kie$gFg@7y_?e09OE&kIi3oO=>;PPuSj?u2u%_MCfj=iIwL=RU}s|73Ii zL(Kl>it|6_oG)NG_fy#Z(C_mMvKN?aFR;X3V5_~rqIsyvoQ>!11-`!*1Y|D?*{da8d-s_D|v$*-l_THk+iJzvO{I6x#kpxbN3nl-4ARgFuH{3Kds9X9 z9*XHb6yBH4fA1mZz6T0+H|KttsS@`{%`S6Z<)azj9xC2@lylefnB-$4yT|4xkGCCr zq&M%e*66&PFn4Ivi7Pc_pc`ba!-Tq5J}nn_ZW>_AIaNsq>A!_k6~` zC`a}cbMC#I_wS_zyFcr}Fb16+b4#BVKYdX>Z_h-(hRNq%S)Z>eID+udQx0Pw#ur_uhWzx!gZ?ADb6nbJ_RoNZyXB zxFgl~p56cQW=h}3ynioPTmP+S@p{5P|I<&okE@pL*Zcp;px$P}+D|6;Yp?vcWikJ= zmAqYb>}R|Bf~mH*ob10WzWdp}{>#m8*ZcN<@!9{yt^Z5F|Lm?A*F)mJ-u?3>aQ@dN z-x@ORevNzI6tVtml6>X)wXgRqzLGKj+X|6y$@jk{U29c1^DWQ*yVbU~torX2{b3^e zzt`OVUibfdgZz&s`yWmAu{!hHn>el|`d(|Oxc1}CkNEdoRrRl@#Q&UD|C7gYez1Sz z#E$EeGOi18{0f`zGP(cfvie^u>Tj)Hnb`in^LKbx*V-GsqFvLLcCF~>>T&(OGyivY z?CGWRe;ttjbLjuUS@(Z2962%L?9CH5Zl2AEVfnY^&%(Vur*53sZ~y07{ofn!7axuP z#`5a$qp7zaXxzSDaeEi@eS`@VO-b=amIzkzWMX! zM3vrNQ1FziO*Z;l&aJJv_m9nuHupJH5Up<3HDe>M^U+>;_jxvz&l!%-G}pJgP+9!4 zZHE8)e>S_myt-yBeV#A&XT_&As#0}(qyJWYdwX|(yL|kXU zklXc=C7Zmo*B>$R{#mg{f90RHXk{P6<0_kdjL*9m`^w~-RDdGZT7Q% ze?<6jgw&M}?nnQ`bn!T{t8NK!=65v-bQMqC66h|kYvL#QdC8U_Z~dcR-1J%xt#@9U zb3-X4&|P(FNU*=FX=rG8>ekS3NseA1V04U5ii&AmLo=E`|CtvXh-h{Sf)Z4t@+ zu4a*`(^JE4L|i^>8kM9$*wO73n5cF2ub6rI1H)jX!~xa#(p;`6TNv84xVuSJ#L zZ#BOcx$)~~Z-v$a=JB=PpKgz@|IccX(8#W~<3a81spg5T;%PhFsw!pk7&_IL?MUj@ zKW35KYyNCUa=-ny9sZWmYCBUV`|o?3nERD^XX^C$Hp{dLuJc4vXXhWYd_Fhi+oj7( zbN(?{Wh`u0+m*4n-_0s>>GZT+nTs-~g{H4uzHHa4dEa_A9-rF2dr9{C{cP4b8;`5) z&e?q4%{q7MLAM)O+wZsiPMi1t%~j#u?~hsM@BRL4cmDqWY&Hc4+0XBOyMy1|rZD^Y zw(r3~a_u%nC)JnlDLSox+@|=f`SX~f!=miAB^NbQ@1#oyIog(94Nu=&dOg0~w(Ms5 z^1a`#+RNLP-z`7B@k?$jqg}kLh0E<~zh0ky_SeHzuJdbuK3_gx?|Y+(ef{6>&-d4Vdb~cK zfz{%`v^(#E&l$@V{}ZqfcxEWjc(C{Zvnq!JQ`m(j@h2UO)01{z<7Fw8Ymw!!v~Uva zyU?;~u>xD@jzbJt7ue>`zT=>z?i_StLfe_jJG{&R&eHD;+U;u2@t3Y}KJoBFyG@JY z)1VVhYG#F1dMb17u{CYitXgCo#?x?jRfnst-^Z@dJ4xc7*^cRSP3%tplO(ygW4o%= z#om0Dx!l*qwl&tQ?VG+MS&sREscqTX{)#)w^30jX9qtKEsMASN60|(NVXI(Ye@n{M zm>U9KW+@6>J5`)aW}ftwQ<*&9rbA8m(43|Mp(#thq-bgH^lG&*nzX*<>B*QKVo_GA zI_ZYokp(-wW0$pR?Kq~c1x_su0 z=~~XS7c7cR1DdB99ko2yvU7sXbC+|a2Ns`u8^CV$@TQ;5-p_N(+K$hC{f5uxV&}Q! zNtfsU-!g?;bjgB7o+}I3U0*o-<_u^v3-Q(~nb^%H6xbDZWszX)3TM+@fxd}n&F8$j zxov?-(4=WsmZ+BoxmoTCn&x$)HNPp-C)Fx=);7&U{1kuguL!gpP}x~}|acHGxp|HAiuySl!fH79}9I^vL+*@on|!bjev z8XPmbwz0qU&4Hw^(>8=%+qCiFe94pTb8@#W`*vKy0-1w z*7dEqIjPpsx2|2=w*6>sUg_@Wd*7~Y-_NR-Z@+8x+R77~k3ZGUXx<(3%}~~3qI(k9%x@gzZ!2g~wMpa(zi~+XSV5cV zo`Apr{wL+WJ#LwIQeWwwWV!D@ z3N_aiPH44BQ4+s-!riTCQfSTN+_@J{`nMHL$!1Sc4ZnFR{8-Vnt$R}SjHjR6J1Jqt zQJXZQ_L-+*-HK;j-IHdv{pQ&le?JxcF;BO;e)HV(>f(7{_oUl>zj?m4&v?Rv@99qB zw=T51l`L8<{lfq5&5QkQB|px|OnJ_-U>h@MZu)}m%sWL<7w5B;u5j&5bJJgX=0JA> zQ*iC8$7^R@JvF<;#pdnH8<(V%wk^|L=ejzZ_hZ%dX>x1VyW8d@iQm3)PWS7}B{5Fd z45Lr2F8;PTSNwG}^X^-l#LBj&=VtoZFBiVM&8&DsZ)RbA^yOR2N_O5=dRO#s_3b-P z_`dHt@B6MidiT8-c4hm%?#-_&zrM!d(?`LH7A{TVh3)L_7KeD_3RJi*wlmjP99WtA zt|UJC#sfF=W9xkj`;x6MAGl|B+%&Fm(&RbU?*99+$g{)VO)DdV7^3e zoX%shlQ)jed2G|2xaa5HvbxXnSARSbbcy4%>$%+N>uX+0^Z&f`cJ1qlhoxWn+Hb$K zKJMeP%`(@Oms>2qYW*#8NjyG{Qs9v<)garFPK$Gz_>_BP&4JQaTL)AZvt&rJ7Mo-4oidH!?# z^2uktF7^KlnmX6SRx5P>ui!ZD!W>t(Ee-p*h5=|uG2$J^MdcS*{B zdnj!GG%o$uz1@1n&&==t^boT>J3Ywf75n91*Y0!aw{rTtjo<(4Scu-IT>o2l-p~7? z$G-dh;&&g{e6RZPYJSznqxXxR+TZ{8{kVPaV*W?RDlY%O?ZV5@qn39{En}4$lZ?av z-~+cVZ~L~}{L^Wx{MGjRy6w3{_He80S)aXs-{S*MF7GOTz4!3q1Amkc3Yj>*yk-CW z*Ob~M$M+M|Yga8Vo#ZIKhjUl1v|Mu7YKyZ)P;Ph{wspb}mO;LXJ59 zKK!s^m3zw(k0~w@mPcH-9PvJK#3b8A;o&O3FGu`YT+>$`@liP%Wa6rH`-p$$>d=&< zVI{6*l1GE59F1IZ^o`fir5$Txt{jbha_=?No7X-)yjM5* zc*&n_(bAjBZPq?Ly-jMfd({=)+8EusJ6q!ZH9M5V*ff^t*6VCZ3fbKfa-y|m{VnF5 zcZ@tDnLR39)^_;lcF#ExV{Ei$_VK9GTW%jZQTxZ^wvk6|&xvv#&yFc45*BZ{C&Pk4#lXKTNJnTMR8tuvdl=?0a6u>vo9G?G*PrHfL{$c-=GcJLR(fPKfUn zmUGwN_}vO*b1rtV@1r?Z4KY4n?)bi4bB_7z`KL?#{;FJH&h=yUJ^Sa2 z-%}I+X)zbrre1g(bBf(H;G@qup5E=hRs48)1768oe5`YUZL1%@Z6N>NfOktS^veXW z|2@xJa^~wC4;k6OK<#7UpD)U@UV5_7|E0)9&bz00|N4sN1`4O1kroa3byPA_12HmCqQFqAnVaf|F3v*ngp}$z4TJV?(vpO0)GQ;+zI*+b5_cA zCmYL!$G0!2z4hjmy=(mHkO992cBQK{LN%{O7|AG(kt%LL6W_}%(WMU zVlQgEz2N0~nQLyKZfo$@mWvO3F8_A9z)>5_k?KF4Cs@Gss`%HC&{TiNSU*|O(1lm7 zgs@%>etSlhH~6*7#lX3tFVBSDQn~EsdogTnkfCbmpPrMhQ|+WBwj5SiExYx+?%!R( ze}naGuj%c*`pM*y#@PU&t7r3N&wII^)3ZIB?Rvc{<|_Y^(C}KDI-BdEvFFQq!yT4h zurj^${@?~(IPTZ8x9i8wFfsKa`zNc3ve){CNNBPNwz z^nZO(A$04x54Set&ePixkiF*owW^Z~bN6jI>ZV!Z|Fc9^pv!E>(%aV*Z+ERdwt4M| zIjPt6do8!+-qzUSb9Rr6(k8|B*$dAJEIP7OQ7$XyP^eNC&z+M?V}hr6&i*oc?(Rhk ztd$L=tQHzuoq0QZ_u4!EE}7o-cJXM_nf-jh?(Nb`oG&fD{+8#et@I_^ySI~FmRpQfMEn_~ijK$~vNsIfRb?<*K<$2G0|L4;9XWGYPkHmj^!B^Sk zSW~55b;_~o)O|)fzMpIFGrK)V);^}1@_?=E0gK@SmT3<-!?q;dImCVJ0Z-mUj%5${ zz9racA2ShoD5&;O_2C14w}&FvT+*M~OYb-=-u6%;Y_f3JL#b^KwX}~pU3n<`?4j$z zhth116!Cq zu668@fmrebtz&T}kB!|PH!wanOnYp$ZEez&V-|fgpO!wh+V)s8Bq+oVNYD+4yRZ@ac_I#G*3q+cHMNAm_4e#4|YBAzWT)X-fccn zQ-8A%zhh5I_ZS8G9dYb?5}KC!@zI&JZ*{%HPO3~@J1OUQ_n%XK$$HFhjk~8@zxn8C z)tl%Dy{9qvo*oE&8W#2})lQ1d#(Qq-<&#^^Z@%krq~_U19iQ*Xk^53EZ9C(c$rqVx z=W}pMz_Ado-E)GbSU*3+62)s0x}O;L-;@AW;l_)6{C(625p>r2l~jEl-SdPC-DbWzK>;-z6T?uAW% z8@g)kwTxpgC3-Wj>s+e7dN`#og>S;EmCIhO+V*Pou~%!>Wu?Az^nMzUG&OkMvmkHT zlP$Velb5DU)r**-mmU2#s5<7xblIB=mpz@&_S(WVbaq&Dh3e&4S^rkqh^fmi{rYo# zsotw8wSiloy=JMs`mE$t=e1*9VQG8^G8Qd-6ZS5v@aYR>-y2u2T(A0<^>5F#P}8@; zCxb6eQVv&RAYjw{-poL={4!Nzx?=W<$nFWvt4;)Ov6Fc728IrD@Z=n8Mu!dm~HC zo@J$dT9$fMz1@7hUEZCxk80-~cD)PDzn6caIlxx6STjCY=lkW|cP?L1OEX|8au)l< zz#ygUF6GAVu44bhG%Y1~-P3v-qnGo(Jhl4b3j<kfszD+&Ex5-0vOAiOl;``1AIQrGlSPrsDt@NZ`K zN}T+@ocmE4|Nd)+yp)@IS+IH8I=^qJ&&zc3z7@PFahEU3nqL<1|4VlJw`BE{@b}-! zwm;0T|B`55p7>9{JX8N$m3(O_zk6Bv_qzWH74}7y>&uI_m**TWPq3dm>xoqtIyoH=U^X^nk zZm+!a_s6HKN;dhQ*9>;gxLzqTukzESSM%9_Em;0)_W5IT&3}o!`#Ckd>Odw7d-uIgrQ+WQ@&6zC|9vWNy7RsIUU+@tm)eu%|8+L} zxv;(IdwuD*gLeC*tuAeKPVh(N!VnN^WsCIn7)vD(2^Gl zVat1@k}WU1_^5nhf|C0roy<=vr>1CyZ_0W3N%hPOqx4H_GC!-Gn`2e}>CMZ}>H#xl z9FN^f3~6YHaP5x^dGuvvuzJw)fVEj)wZhhfZ7aI_@707yGdCn1F4D~YrW2*d!s(Rx zdYkT*9YxPC?e*A_d|^-3_fKzMf7gF-pov{rFXzXHQw!y%zjIi1CFAk3!nH+bCw(<~ zb|!Rp(Y;eoj9;A3zptd3yUS$4l~uv=nQwP}op57Q^8R(Px8Ei0=_vpF?(J{$4-XEt z3+tZ?-spa;Z)*G-ovWQ`tL82*-g{@}!_-!`^#$+G?dAFL;lbr;ttTezs{FiT@@unq z|7`#K`1Jhp`uzR+pL!=ue?Oh)Yh}!N&KF1cS*0oznmDB*ZU?`td_K40(Zu6NoA1V& zDKwNE-FnaM?cMK+9g1BRN}Z~+DuU}IHK&UdZwz_j8h$a*{cg8NXQ6W6Khvs>*BloA z{IR(I<;4}rt}?4$JnZz;+Nmaa5ukBl_`a%EY;_h-m08GC1l$RnKr*A)8(8Vu}aBFwMs>4%lb zT<_j(NzsrtkV?%lR#H&dNwmP}<7_A$8NaC?ujkmY=Cm7UK{)oyRw z#{2Nrtu3v&W)B*$PI*$4E+TH)EcsHv4_;k8J+3-Sh`o+P^zrZi;jA)&DKN1o~ytyN9rsZn5AZJ=mc z>J}n)&?E29@`JoZ0+}9{gjX1}$bC+5)hai>obFY;dDdAT4yy`9p7@Gp$x9pBOj;Ck zB}}F-d%3>Z?vJ9tV-|;Hu}6#f9Pjil`@ZyhXQ$JhP6fve(>IsSeP;as<>ZEn4##gS z8@uEFESl6N!EKk=p|^e}@7suNP6}&$+KhV=c`kDp&%DWJ!gr@9T*J-L^s7Km-5+Iz zX60kQIvw3bPj`jPyJUPrYks#B3Ex_tK9kn!K(?RmbwHqyJLf28l^eVm5Hdni;lCFuxV^mrvtNqR`|S=YyMn zeX&q({`xj{ZI7zSV$HLYIs~0xR!@BNMqSLrHbq;-Thiiiq|u5!ZF&(`9>p$Od9HL* zuu2k(s?FC7(b#uEEmK=MG~_28U6t^0mRL=iHM3TLeb+}<@mH6X`W1FFseXxFRh_|i zg!A0ix52&1>uGiY7l6Qd_3zTcNk@Nb`^Z>x0leuT-bi!(2Y z)Fd6@GUhD15WDIMSM=jMTIxnY@&CB~Mf}JXnU)fDd8v_U$=oMBrOSk`tQ7KGay(~V z#JaAl#sWb~5_@lmSzo!banjccdEd+7YYWb;*<(_8T<4ig!l}>&b)U3_UaGlGjk>n? zQ)zM%Puzz^wT76v0%l8&z4nhwNsRD>lmtOEI&Jk_k!N)oBL)OJNM`= zR{Gg?lPR~1qkpPSR&e&p{eEl{duw%b<~MuqJYcq^O8PCoOLWxDIbmD({e3$*uWG7u z($cjZ-Os(;BTpX8N}C_jxwfH-`_9Xt=`M$SU)n5`KL2)BdWi66DZ9(FE^d%px$Bwj z`Z@D%i5}*@YvdH%_ zb6Is09Bm#+UcRCJYHohh?Az*x)@|Qyx@%TshxMI3dNYDd?TjXUG(Mei^^?-Wqxx=@ zJ;|%r{Lp%mG^MgF#7k0r=jk}VGn4*bePZZjdVETwk(+;wxk4=4K9MJ%ra#tsK4Hp_ zBSB%8=hj9kPt1x~BC7pqLPu#`%IR3 z7CruTY5NAdIzi8sRpEOUNiNQNmb}z>?W@rKCu?{;pB-_@^6(4(WYzg^S%R1N+y@Su zcU}KmTB^@&`O4l`H2RuQ=9IH{wgmNu@84Hvwybe&jO5a<*Miv$il48{$tiE0J@2vU zmczVve4`x?b%r>375cu-nQeXE$_wwW$CS|dB!#?FNf;?kn|2d*;Vnm=N!+q z-48tU3R5MNUPb25zLt|zwv*pCC0%;YBPF$Rf8|5(7Z%0LPFkqF##8oV`}CceoL3Wj zf^$Dkwcl}J{n^s__s-_NJ6iqh-jeB!T-P>xo}c~H?zzSx#XQ!>Ni$v~8m`i6{`FG4 zanp1A`YP+@xX))wDlUCqbY1jiXGZEVk7v^ht*#u_^DTZ$Eo+@ z03tb&1zl1l%E>7Qk$bIwvzgvnE%BTGQ`{A4GElW+dH%pNyd^F>wtn(j_oqtYn^s)VRQF^-K(NiBko0rK}R!cmpF4!C0 zoVR6O=$8%+Cq~snytYmkz4jfwJLlHc+PijrDt`C6jjm1qC_CS+soj`uX+Rmb)B^|h zDF^rpo_sY`Wb6v{vs=1P=3#)R%X^zZQJY)(X{x+u8N$m{!`T)a>~mnQaS&>8{JnO< zD@8?TC)Maq7%%+9`wxKpi967tgK+T7n@*dnXy6Sd<2M?*vAJhiN4 z%d*y~WiLu&RbXJ2XjBboYMglb+QP^3Ma%Na)Lgcm&@xr4ENNh}VJH+^UMQztq_(_B zN}ai9sZtA*n!#iLe^>T3hEKfnBri>U@|DQ>M|z~L@^CmD;M&7bIc<66JoTz&%d2Lo z^A$9zwKyreoO`FCGP{DmEK9v^7Dsu~3Ep|E+z}2u4;JuG;&d`dQ;l$vl1MplFs_R= zt*_Ri3SVoV+0iIA<&_}MA($Tpige`NHSQypjIH_wmEnAkoY?mW@%mKa)jq6t((s;9U z*R|L3I~)Vc8f93V6g8Ms6`HnR@ml-jlwsg})w}B3)N&FV6vUniBusT+*}d`%P}j?^4r(MgW$a^RF>w$OX;iCWQrd7@(vN|y=GY}S#taQEr#rfH zw&~p8m1AAxcH-|z(S$~6mL}Pfb|(S#iUcOL9gY<~kD>(9qfHz|TpFW87G<`y9b6DQ zTOsH9zjuCnp6d3>9lUe)oCgETn(npRxZllU<1=7j+2Jbw!BOJKlj&8QuM63pGriv` zHY@Z62jju3-wqz!zMzpUMMuiykh07vp;@h5Dh;eNSj9{Z9dBFg6~>=&HtgZd*+Mz` z-)Ft*O>__2bEDzP#hq&!ST8V$+&HLE(#U)@x%>eGs{#Y3fQyO?)A_z*={M4R|6RLP z^Yi`xYnhI=E?RRHV#QVprZjL)VHA7O__~k1vW1;5#(~j=fk&omZ4}?ah;!>K{5=fM z&Ff_3Xg8R)Pxw0nui>H|)=Ou0Eofj@ag1bftZsUvWyZ)I;J|2cfUDv3+8vCqwUmBV zo&M_BZ{F24XWuOW;f?)bQXwaz1cWdB`JgGy;>fY%fT#;2Z_fetIS1C2xeK3Q;BGm< zqSCgKZ$%Xzue7Z?;dP_G-&3~a|#d<+tLxab~j6Da~-#A2GXyAxo zVD)ie5m?S_z`(5Gz~s=te!!ue$3>-vNtMGzNB9T}uUM%}T*=Qo)&E7?rY)Jl`sDCZ z_kRz9j=HwF2~Tn0YH8zNaDXj@q0p&;CFKCe8V3OtmWmcf^%f?joRq^c@n0A|s#ncV zV=}g4|D43|q-ERmiwCc8Ci?~UG4RSfdScU~)Z?VF!|_>&>ZelAvcJ-4DtFfUGO8{w zF3Zwg(KN?pLa|2VLGB3-0%uOR+$x$etyQ+=kYgD@vM70+d~(N0)gzqcpi4C4si|xkI~Y|u zn)WC)ea-r3AbcY-=x0&bZCF=w~eUzy8tE!#5QJ4*avRPtG-q@bnhlVjfP zq<&+?>`#f38h&?E8N;H>{O)~y-gr+bapJ)(2Ff)r*7~hcOJGtJags1d;NIwcCgbFm zcNcRXfAe4~owiWYo>4w(<0{D|*$OWlCB78@);lG7;rW}rVI|(%oy!()<%wp`kLK_= zz#MXbt)?MUNww7FzW=$hM>-~obIq&1D|2v3|NJR*hO>i3&je1&J5;#=EiyI0#3$s+zo(_c`u5 ziS3Sy)JHy^{NLsivlo9zI@uJ}%9G>3Q{wtq%&9EnxTr)b%L)hKn&VG=IDDT?wA}w= z+TzUI( z=#qm9Dlgg=xpEpfaNN+E8KL&Cvncj;=KEEff8FDH-*Dvef;Dd)C6a`HI0*gNDmlYZ z#ASZLEQSsJp5JX*-WaZMu(#U8zG#W}lOqefq8>O@9&+G0(ID7xkZ;KWt{n%eWtu$F7hnud+*wj}YhpWeW*XGi~T>1h$1(Web_yT2Vg$YbtM=*Gah#zExA0nPx1 zX8rWSO`F(Q8rLopxU=TMt&TX$#<+vhd&If|Gd-n3Y(7{^IkK2AWVJbPnK+6{IC4)( z%bu6UvB1IXc9zp5uHaQyPA;wyl=^9|T6pq8-|0O(0yziRT;85BNf4|sR9oZS@}B3# zUmq5+y%*0fSe?weYX4*V=r0q09WZ(Hc*dW9j)kX}zY9=5v9$ks{a*G}f70IWY}|A9 zoIxXh!~xC|XT3MMM!#U(xGO>bS?~E5*RGtiy(_<js(YMc1|s$M@pVcy+Re-rkrR^a_tH;NV~G*-^DKRetE~H5`opho|8Aq z%m~>zDb;(re&VqymXp(bXPXy3yRvg~y8nFpMmABaDH(x_-6yJr?wYdFe~M1>+X-3@ z4r^8fyIWn{HC6eTPW-{Txkl60gsG)poVRz=w70i-g(oGvGFjmfySu#c$<^86?Oa^? zGOsQaHWwrwZe@KfVf4f!`M8&Ydz;U+qNf{`7cR@$HM2PV{CvlDG22-snU|LbF5maF z$bd|0cyhsJ|@wwx~5y?Mb40i{hwzgDdl+^w|U?(-Ax zz@ws(ITw$LC-!_a{^d96t(~;{D_?g*r(YQ^AGdV9*{>*_t<>r0cJN8Nd_}~ilj;j& ziaOMqE-0To+L5!yTK$N0w#%IY7+>@WK5KeYrt8?GH>qa%J&d0bAz_F6G81DuxeLHlOv>Tzln`x8d0-o6W5|jm_31 z-PAv={Hr@>|5}GFk5Wiz_u0kbx2KMG3XktqXk<^|XueZg`QiP> zps5y9PwQ!VPYcfccsBfg?a#O28dLH-;P6^Rqv_8dC9 zyT$+LwTu04Vz1rrcjSwFGSQH=LaWj7t>B4Z_tG3g_2|4aH)Jx_%}gshTB_K{QBmM= zCs}-V1((B9){w=0o_YwbI`X-DqqTUl-s%c9=z{rT>8{(=Sj1Vc`DuvR^-Y=3vc&#-{u zAtQ@O!h%MQe`*a68c!RZzr%P^`2qu*waG!1*Z1ye+`Yd0Jj3LBRi0Y!-(OGckNvin zd3sdCA2Xr+BfXX1ncBH|92PJMCvhC=R!OOF{P}cd{lbcP=8H!r#rt3H{q=hF^;_JF zjZam7dw-BWz9udEf61%-o##E`K5oc!YG#u0SlD@YL-^ur5#`0qLT(aw3zKg*iB9_x zd9eDi@dHM|84jXT^Zh;)DeNh^KJ~*4h9d179mlGs2g5Xdwi%q*UIeHVrbrN6uU2${On>6up_2Vlnp8C#t zPtC*v7`P7!wK>=@S!QM&k~dh$*>0gCRMg=lp>(m+U4uzz`Hv&v4oMp(y!hD6;__sM z)J*T#cb78z_sGuG>yUO#U0WX4Ai;MaiQT8?k?{NrNBF`%um?^_nliP6MZQL$)vbd` zxPQYD4K2sh97;Vp2`f{-=SgbDt(!de?Um{JnZn2UrF8tKGj~gyEab}4I>aY6!$DlC zv7^@{kyZbIlgOTgHith4dF3R}{c~>Lyw9Ucz4zUg7p{g~Y8A(nS|+>1q;_qacsg~- z)TIJ1!aW=sWfhnNcRF6-Gh=90kIG778zJI1;h%P!s2h2L6s0O{rEN8Z})Qxu?Fo5WYW4_T7Q(-8k@-WKd{g2I@!55r8?>tb|W@%(ne8Hsjqd=P9=Rk$A>k4)hv+6&&gMz!t4)S<@;Nvq>XI@*<$e(D?9dVE= z?BkVb)jOWPEkC$BdQsDt6$gFi|8_87{cETc8fM|hnz7-!*op(JIvk8FTmg-0U)Z=A z-}3q~^0ci9o!D}Z_kE+_oNK-B)YtLtUgH+Dpiv>AQLxM5YD7&!qi{|ro5G9+W|0L9 zTx%9Y*og$Rux**Xx98NFG}D5nM488BzrvIs^E}IKTe-NOfRIWRsjor$WP)q%u~hHw#|&Te!4`%SNC@^TYvW^&5?DUI~oK ze*`DQGRmr*ung>EnywSP?bFVC4Qc&8X`Ki`t8vR1mQHa%2bNa|(_5NJ+mnUDAH_E=*fAPlYdoy`rdedgAy?L->s)nn^mjx3QRxq%w z*FAk`*@BLs4kdvq*#*n?>YRw@o_*(O*sTgyPygaF*J`Ux%#KP6I}AdOu^R{&ANvx{ z6&jLsuk-h|%KKXHO0-VjVKx7;!C7`|U~$O29Jw#Y9{HrJy?)3q`oCF8<6>vf94F!W zLpjaz)*q^6=R8qmm)t1$OtinJ?`eehl)ma(X*UE*H5>+`(`Jp zT;d|T=!~DeX~f%yheW3A+RazC^SrHV(s#3^%8}RBZjR`P&UE^;ZG|ZNZMUZ0*w{NS z=T#hC&i?dyi216Ielr=HT-n4c9Jn_qh*_~;T=CoS&m%|qUl$X8eq6fzdD+*F$Ko~$ zOtBm-)Bd0N6p>VrJYW3p+rslAON1xwQEIs^+1b4_YoSR-VTB~pc5$1~t>|Yg1%093+3h>@Y;ON}I(K~@Rjr-jKf7Y2BILnh3SE*zt6mV%fIZsGn zF*v}nNu`bNh#tog9wkPhfE=Ea22T69lx{p?nSO!u<_6y6MIYT%Sfn>F%4@OdG_dBJ z_OmgtkXtCol*6)egVH6Z-AbIScRvV-=YMZn5wdH8pzK9GITwQq-9OSagoKmzWt8+! z1RVYHuZd^1v$fhu0l`9%r+$LXEOAl>EXmnyk%HX458jkDi$-2ll4(*(%ifm6tz^Zb zJ3&F@`UH{2iJW)&&C{~^3%M4>Entc`u+c(^C37S5PKEBIJpfZHVQJDuXl5(CX$ z45b+_-FdUl`LA)u?Ub|%_+pj$UW%*pN^u4#zR3ZMbBpie6kn0 zHaqjKH&pO6`tI{_u|~4Mc?0p;iy2>f39}s9#lmXAm&LwFfg@!BXT(|mZ-HW|0tcEt zu-68$xn3&$=k-a$m7gn}(>y|uqy3ZSX$HO}MOsUX{*@_AdGmnpokKu`AyGAs*&9Qam!DQ!80yD7V7b%a$fUw|a22Of1IsE0 zon{B6c}5z7pV|8hIJ}n|%6>Myc}Z8*_~4rL_D@)?OJ*xmHt@9e$0`*YrGDPcR^(DONmSg}{3gSJBMkv>7@k$RY+O^Md*%So zh6LSxh87M2O!=?H(?47C=Pj0S4N&OfHkoY6@aCb&YG#=StQtzZ%g!l$HMFchEY&My zbum~$*sow&T7wGHKlyw^7T$iNP2NnB3Tz5Y3j`Q>6}b*{6>gkWta7>7p)ps%dX?_6 z$u^=Uma`dHcpR9T7%bS598U|IZ+UMtXR?E-$oU6FnunQ~Ry*)*d@ZNQrPZv!=Cgo_ zM}g6YfkRfwu>6Cjx4y&qV&~j1y4Nq46|}!Rrlj<$NOiWe^OOF6Iv4&)H86@aFu5<_ z+^5B3u|ZGT;8d001C}ptYo{0$mpq(t@ifClvFl7)?Uy)ICopwy`KQppWOab0Ac3QP z1G^!kTVjb_qqf=lEq>CO($Rby_k7_}XyOU}?4NDGoR$#4SsD;I*_3mMpxr^CQybW2 zKK|Vi$n)ZgpXStFkq_1i{|;MidTbyVyfLP5qgV*rOfL~RMjzqefH~)1h)AkIh7b&HD`u*9vKiuFhIp#^tU5>5p&D z$!~eC$8vI+xqcYuiD$D~DR4S53co64+dnb*p$La^sQb0I-fzV66}QKKm?B+W#NK`( zE>-YAPXaqrqodX$o&$wk>Di9r+s!MIOU^wgR4y<5xYTSn)9o8N*$g~d8yomF7zNV| z3Y!Je7$@o;(0%m6wKTH4V(!w9GxDGMghyW~tLzjgY&I}|tx&bJylU}ut=H`AwY~A3 z<<;rWRi3K8j#{I<)|tK3yzpVLlHL~Ymg)bhZ+?HVq%1+rOPOVb_O#E8Cj$%$9LYv!B@$jv+f-~~frWa=BCo|-Twtq6WTEG~fz?l~;CR{8fzPgcl zZNfG4M#mdIC$4fINI9paEULI6Y^DN}kOJG81>8rI&l9;L;>dw->{zu37n zZQ#^cz#zAPNh5(tsi8<=fm6a4bG_&0O$#b#u(Ln;r@$-JZCQ8a`wzXi4ZiDktn2z{ zF=c7%4U_XmdtQWWddw=uz|_RR+0?-5^?=#LfhmZAdzXXg>IX&lgcogCAi%^pdGl+X z9j134O~3ReV#>syHVX_+S1plG-pJ#`z-XpWUVeesfm8U)15M3GMLLfR{x1;N#o)Hm zQp2~sYR$2FG4~)x%b7QKrfm9Av!~}roNzi@3zJX+E1S#A3x-qXZ^cb@Vd1w8mz`}Z=I-3JKJmyVyQZgeBF#@VFumK% zBj6}vb&xmdi~2zY!_*H&rw;H+B`OFg@h)QExo0ZiG@WJnE=z-DlaFWCIeM)A`)kYp zrHhJ}lzcW-X`DCV_d)gLNi~JO_?69(z=@=(y0Dgy}mUB_J)CN_Y{`)uTI^& z_e#!DW4qL-QP>u=fYIRryU10cwuT>WOAPg%?~rrk+>|WfD#rEifgqD&-@#WpJz0yy z_8g4;qbk+^XBS7DTLYtq1E+$cu+&0tnHA<%GCR*b&=lUp^H1TP&(@9U8`^4bBt-o= zI=5!;>*n*%Qg&3koOC?E7~#O9!6?k+$nz?l|A5VzgL}gD+yxC7h3+XBzRcQtDqQ3A zfvi2IIZiDHf=Vxw>Og)#o zcd!2>cavYCM;2fI%m2GUBjJ6}`I!w?GahuVEqJ}{Zr1|aTm9DQ@B8u&9m@Lhhesx9 zLv5>e`z9u(Wn3~$N@68$owKi9{Ci)U`*OY2Wj6+N;S(DPhsItIWW|8v+qlWYP z4j=w-n9X~<^HmI}YgYnaq9Y0Pie?jsFb(@t@fL=j{AH;ST?u6sqnnP?#FrecAf0y zd&l`hz5nHv)zQx{E^hDQwri;1XHs^XBzN!hZ2NjU4-VEDg*QqrYlbMy)_;9?j;68I zgMIeDe*eEeKj-*Gx0psYxsHS;F1-^8&3tw{rWN`sE|+O_+uQcgVa3d2QrYs77Y}mw zhCXcOQhRVgLR@RzilpRT*1#qfR)qzOd^%1>Uh0W!ETZ}oWJ)GTIPq~V5tp78HlaaS zh$C^bpB-oFlpsIP)Tui?SBMmgW}TcKAIHR@)?haGLZhHD>qaMbg$)y0YV~_rT!r;p z1P(H?dn7msEAABZ(wuOBvvqdUzAtwYeltE@>gTSpQsm#{FgvcyC6oNTGM7%9)v6jK z@+dV?hr5<5YlV~8&PDuk8!jXz8#WX;vPxA1Fmdbc`M|`j(hzWvnM+|p1B(iaVPwjb zIYM3188Y2Dn~r;Jo7u%F82QA}UGC(HWqom7x!Z2#ozC5U@7Aw6dFP1)KzIAGEXZDJ2*;A%^zlPVF`28v#ww1r$ z8k;cv_9y8+d%nsi`DYw|%1kIf!p5u1@-gCh=z*6%lM@4)PHA?vysNyUJ?ZSPtcz~k zKOSy6?^peHoAHc_qHc5X(?`X(+v&E6?Up>sXT;L@Syby{N$_XWsn6Y1S1fSyl(35F z-^*v7bH4Wbo#gq#2~yr~quy+v-(UCZ)q4A|chS?jA8xtar1d1@==%vQ=Tbway%Jp! z{;}O}#Uqic(X$q083|A2IabcIN8;zQvMG!k^P5E0EMUF(eBWKp0~#sW3yzwY{hKoP zM0Sg9hm%0p1y-FKEF3p?-uu3(-PYW}No1AAQRPDpa$gu2;|(h>d)P5aU!Ah7)aA{D zpL!ifRI~~^6;3Pctk`aDxMy8yz;A_;HlbFNB?oz8Ee;7BIKpgja)bZ!A4e4aOxF0T zbAdC6dEOttVi&bjg?%M!7EhjYLvz#KcfB=FCS+~6z-lX^Bv8ZAEFUh+W@~atXs(2- zrV}Hl`JTKV%$7_iZYgc_wF>ad+|BDZP^#)4Id% z|5!HRUq<3V-o^|TU2R4`?*~G{(=uA*4i(HTSvA?Jjmu}D-%p1|jn6Z`tXXdBsClaB zYvKGAnP(mRI!|?39^|Rl$WZwAppDP>bg%TMx!Hb^XML&?=Y3zZ!c{-&V9lp>9-&_r z)Cqh&`mg4TdadJh&*BZ|O4Lp*4Ayw0*?mH)E2(6e$=b|^Cc6$s@zF1x(#sTh_H`25615WzVOwrF z3NLyZJm2n|qL1w>=DAu|cbqC+*MCTp-I`_VHP4du>=T1IG(IpivA$vacZz{Cv4uo6PI=Wtl$Z<^!(s9jv$B9P87bv1gOtPKzH5%v={5 zT38dESvj4!TsAZc|7cjacWcuJi5tQVMjJLA(OqA8{D9kQy z(7 z>`NAKifKPhSfs!#&eC|OsZxKBi`OL<_0QXTt2T7U^E_UWQIH<*a*B z?{1lt(5j(fVp^dp@68(YkWKHO#WA0}O{wWVS9nx^Cb@StGV>TP)tx%ev+M3#>Bf>J z?}DZsy;iho=6RhvXQjS+#J|;y-z&hx9J7FP?%UkVO9>}he@#ACJ@1g>(LE_9+*KF8 zwrt8ivgWBWt0EKUgTnN?AKIJ6wk$|{5#V^~L%V^5O68n9o{YtRW;qB~U0L#O$-@7Z zsq5;tH>MOHWKt4nxw?ZcvcICO2of~DI?W!JuL zuioace9fJcY&l%B1Xxx0&hA?8$H1J_k@~lTS8Bdr#2(A%yY9Y^TY1(@;0n*$&sj{* zTB2_~Jh9#~?LZsDxj7R8;;dMj+V97%*!8&f)0Fv>&d(Psk>4!2_5#-o@dG=r_eV3b z^E5Pw9^foeirU*TY5ktp@%I(_%Wrzret9YKU5Amw=iuyr9#?H9hA)21J!hX#ZQXwvLBnrfK%uHt$YGzkqU`;$=`pI~H)m4rC zKi}m4pL%7r^|zw1FZ?cF-mevC;(Wj`A)>=6@Z>Wo-vvy90Sux7EL9tF9hQe*JmmlS zc^yATqaaiL`@_}@KT0JQv($vUFfU{hKEM<_fyJPJ$>c()Si73|1O_$-Mm+=8)&-nX z1Df`VmVI}#*SJ&%58lr<3e=lg(3&VVtW!=O3T zpxA>^k%3t^l{Ha7-h;hJ$|5pOqODP*<3OoQ=v4O#RTtKYVciwU2Fh$pTbUguu^3)3 zUh~yhzD_(l697bjUc$_5Is<|(jeHn1jMl6OvE zpYVZmX#v-)1opbX(%&gPhDRr8bWRc2+5CyU@?Dt5b92^+4Ylh{I3|Y$^g3|PxWKu{ zfNR1NHc2L@#Xp3@x5#UyP4euV_GMas*n|wb&?#XJteF8EJr8^*PRO2hfwN*IXYYi7 zV)vw`hYnnpaqcsxwRSdVS9&cp)(Ad6BV>C~p(MxV5bxfG0Fm^W+Co;noNU66CH9t1 zYvY{NA~rGALu-2GEUimsiVBSU0gTcg80~|ZtPONUmg{U?sWYQ_ws>IiO^+E1|Gk`j zW_zUTqu}M0vwkQkw|v!S6lT<$pm8o(xSM_MMa{W48LdJuNX)xAd;iM0Q@2lBdwB-i z6Sb4V2CF8rB!6WJbC@0*Fl!Za`2xo|+ClOSP9gJm&i(o`L925@>!UfpPtG@3!n~7R zp*zlQR}xHuJy1!X3zYL@8%M zlex(C%(>s}l|Kr3Ff6=jxlngkVYa32T(?5oNj63s7!4mt?F`|#cXCEd1GB6Eqt*o$ zEhcl}@I`a3HR!xrLS_&}Y@MqNk++hb7)yE?#8V`Cmh&;{wNvX^QuMGVwDoJz$x~{$!3#3(E~l z>Flf(OT!kf`X==;a_)a&q2^2d|6j0V8sx2itgL!~L6N~P^_7`z((H@|^A;_~cCS@U zVsjLBDo&oLQ~B6T`r)dA0(P;PEP)NIX$fqB0=ku#8MzXe9*9V)y|Qf5TA>}aVrkYI zzp_=zol*(6W}M~Hc+tq5A}VK;z~a1tS#txEw@29RU2ByWFz^a6Klmb8@pGFo zK09%AEx0%{=<3FQ>)vW@JpH6s_Rz}76KC&~lyVbb3_cO1xFInqfkpR$@wALh^4&}) znEiSLmrk8Hv*%>Ep!G)M)1I?gwbmcbjB!}6s3_IuSi9^c+cvi4HkUSeMy)aF-jca( zO1nj*qT(`Dt5Wp@#@kX)zuCDeM zeeFN{=tfzm z1g{5bhK}pDc@~N}Fvd7or9IF6eR}_&)f{dQm^>e>uKc`mdwS1{)%!U2n9dHJ#{P}@ zla=sqOAV3jjKULGqAWT7FfR{Xz$Eg4=~0)}+;3KnpJK>_A%&)A}WZ_#_iBpAS?9ldDb=RTp%0~$U@lpk-OqGIU0dhi3d4RXSo5%^e;7F|sUR^mUM2yim#Q0Mq~0 zS!a`G#oXTXPe+AoV@JBe1s2^)v%a26x?C-LBs6EGmn|!sMgxPu0?EiXW}Sg-fdOoP z=IE4i?-tqIx_QO%#a5Rb=bC0)PSJkD>U_yOCm>!~;Oq?N)qw}te%H+25y>8!do?`v z>N+hSyVNZXx>w?3jXJBm9u~8laI4~JV6I0RmEU9BH( zDC!?z5d9$0yR)Jwfjy#O!9{E4_TC%qcPo0QyIpi#6PJ5^;#pm`zvl&217}DvEilZE z?Bsm#g`;Bud#r)vlv!+x6|bIjS|pr)^RSM6iSEtyyyEUY)x1v~1O5p!@dPkw39@y4 z;9Ru9d#>&FO(GnL3BnNu9`#)FmUBw2&K3Cg=GF$@yFx3@ygs_c;OL=G%uM_rn8FRL zmOJQ7G~meFAjx^0Jx_o|AeOD;07vWu8-452Lt4UL7s?x-s5&Nd_xs#)s=b$%h{$$M zx~qSHr8R(SMF3~n0cX?1i3Sr`Trc<*G2Ay^xbrNRQ22*wYd_!l(fcrIVb{8kRxi1H zrhL9%RlzkwfK8@QaO+K$869i};vAlT=GDJl^Zs=rUrUxm@k7bJ$FYT#OC1j}UUT@r zmVKcBSA7FZQxi)=6O-fv=K286{tK1|ZdnE|7djYI^R+zReBR^8KGB1g)ec3={&9c2 z-}`}cnt)`m?A1vRnS>jdeExB)a$cuhz$l=wWSges{8tvbhl4Mw&v~AGKkD7{bK#fv zs|#5C+;HvV{RtbU-%OM!1W3LC7?f3`jUdHGTXg#)Y)QjQla zSBmkSG==4};rz#1ce+AfOZ~THwR2#y%l{f~A0be{s2;@nnD4rL;VB2DRV^pJq^_5a zGe0NW#3cNHNpHX6W9RPG54X%Xqx8Rxb9(0|VdFyqJHMp$-;Y~vXwf-2vyaKLGAZGb z)$x16woeWz3v$d#;1t}KcS+2@_Wk#Zd#5FOcC{X2;$vXqJo!mtkzwEzf%enS)^zC{ zJap&M@!3o3ey(3HruA=+yJxY2-d$tsPZrLUn#TWo z(%het%F~<~nRpwRTnfF8i^yi4d3JuWvv!JHfqu73%b%0^*E8hP?tZ<$aK(ysiN)u7 zPQ+}G^jpp$RWqySVOam1l>7Yu5^^`sKlH0fE;Xn>-+)yhhJ{Z><3pfwW2%T=%8d~gMsDv_6-cuvs_U6*q6(o^plhN`1GVLgRQKtTKDrCz@!exi?$z6#ZsJnHlC)>Q2dcKtghms(a{ zirkWUbzSQ0Zx`q5`OKIzwfo4s*ggL$Cu%&ref@pBYA`GRv|WOkCl+;z>Zjeg@iF^ zU!Ut0xXGCHYqj>OjobPnCM2{A#+>8&a(BPI2m>=qfDIEjOV7@Cb1vsOvPqYGaO6;) zQgG&;%!y$st9aYO_l|ot&%l@6Czb%MNs_x_&uPg9S{LNye$F28xcJWrFIcMR>`qkNeuEB-% zHoSL>1ER9GehrH$Ub^9e^V*Piwz_v8U+Pd(;9M$rWy)bL<F z$2TyG?YL)Kebr!E!cL_R&KkQeJmxo_x7I1N>$Zt-j|F>?g@E-xBe4~av}c8`J!jDB zsvE{06jqr!ExPPy>Wt)Rm1(oGxBX0;Q+%y5eO~pqpXm#l#i}wEb({UlSTZ@RDs$Ov zHYrV>)ix5|?(c2WiB&smr-(N$`q#-s8F_3T0( z``SX1Jf2v~*H%88UH-3<-Ftg=#jARke;iEAd*(j6y}Dv^&;G;W@)mnv+g#-O_jF-+ zeeJi~<@MIP*0Q{*l6$rNf8C$T7m5G>=0DkAFT)zpV9piC$Q#jeckPPu>%x~lm@HlS zWv_pe@R9^pbq!m_9F@f23u4p%Ft6gT(@ItlmUcX*J}1pkJOB7bFBaV&P7=og+Hwv* za9b6=m;KoXcD5yfOy$#ezk7PF-8sdnvCX7K_O5}4-ke0?xj$Sq{8qGW^oSJ=b{Blw zBapI6=)}=|&#er0GuYQs& z|M$mn#u+RVnpIL189BEu_0SEpOh{4A{@~%^7BtE9!^CC(zVE;H)jd@G$DpH^ye zJPZA|_{nLhyA@s`N$Cue5>mBee|kk63!1ihNvdvcrFYD;py|7KQarS{RgH!lX3&Rm-(cc@9mt)7~?eOu}Zq-*-F2X zWx;b_r=(lo{pnY6X!8tZ&UBl%mHsvNisuDeEqi$?c)4YwtEs~8d*Ah@ZERB8q8PO? z$yxc(*?hNN-_{J!v6}rJrWF+x`li&=#^pSyj{X`^$-4(?XVNr@r*^w>p}d z=eI2XfXp+s@ZC2`-$&lMoatX1)!H+$$GhS%my3E;$P%_xh9wDE!E=9wtZ)lm6}&Vn zbZu4WnzYc>QU7c+-KXse-Ov`gCb2ft{;iutgWPeOAW5YYuO97YX3KAIxZoK3HtM?c zlhF0mS69b2AJP1nb76(2YEELlQA3DI*v9VEoMhSG5hvWjHceidld4;N^K{u(;f|v@ z>9)Tk&rdU*SbAFF(5cC8S1+_HU05UW!{At}|KBV2SMS_?|3OK7{}wNUrl%c=wZCuA z=Q$vHST(P(w>svDTKLY>sd>e7f5*IVGv75!bY02X>ex4N;albgF1fqHO@iqohsX3M z@iC1X?DstTx~^PRpMmwpZZXCa=CPi+2KI;p%xVRVyfq0d z>JbOI(+ZlUePY?&BMu4A`}d*Dc#4MTzb@}JMWG)hDq0jXy4bC19`LT89<4s7-+RSb zr@EiNlm7B0Bp5F<+`l3^S!Vj_Lw9v^yIhVvvR*pXp2qs?ssGj0>*mK-xGV_!IPJn_HIsCE>!-*1A~){3 zXS!Z;b#~luE71dd2iDc|K0ESg*NsDbX8+bXN=Lr3yM6PVoY~gNv2Wt|ci*~}XSQwi z-yDB=o)Zpsz2POZ9|iEaomd^YJ*%vH+p3KhPBbkm-Fx>(=tjSvD}Sl6?w@@szk!`$ z)xR{YgWP%_>XiRHVC`SE|KOhd7U7utZ1S&zS4Mwq(2se<mDdI`ruglGAUxnnabX$45)W}-)mCy2DSC7|~t(kxKjhd@U z`OHt>E=i?diCXwua_uL@@b@0G)tdcp{>xNS@d$RjKzC z2Hl%K_N%8qQI&5v6+Q1$vfJ~==IblZ^iMwXGeo`AbAQG8;>slW1RoWtvMtg_fz!GQiJ7xPCfTl`gMMO9Ycg< zZA8=0U)S#M`?9mY_Ipl4KUTl@`oLd2?MmqXpQrolK24wh>wbUzugm*SPw&gl z`XG2Ypz(kG{lgr#!OJ=%9GK>8?%vQf$GZ1Pv>kiNe8vJ6&N&WTYaF;sS~OQ5;5l-D zVZs5PI|umh9N=a-$oJ&{pNb=wizBa&Bj20@0wxDVQVxpM9OPc($h|~Q`piE^aUDm| zn1d2`4vO(ONnCMMT6191X6eTf4p%z1eiqns?Siq*?B;`;ITktbtxnj^nsb2tj?)Xt z2A3aB20YG&GKXChHZ%MWQa>VM1vuVf?S05LvFNZx!TwGKRE9>Y6X-)X&J<<1#b>-y^ zhA)j(V^$xO=r5klrTfGwG-e*70!w&}YebK0ij67i}GwC&_rZrG+R(Bv09wF?G*t!PJ&1X);YAF|N6P<}fm_6( zp`I0s3bVH>MjQTS64R|TUw6a(pv8%nH78>v8_Z64&b{L~?~UjDKb{MCycWuMEzio)d`1c8jWXVwbi6m) zcyICX-Wub*EysI%jrWcg?^j*kyViK`-g3H%$MrGC0Tz~hd_hiEPA%K7y?tH8$+b^T zt@rWyCdu$mH^b+6jn9c5pObTZPOb4dy~pRw8K1Lv&YWGMckYkR1)j4PT2ArZJhdui zErU_`QHiHf;0-pE4K~sZHnt5m@eMYO4K|Yv z-ps^n(RdkZ + + + + + +ProGuard Screenshots + + + +

    Screenshots

    + + +
    + +GUI screenshot + + +ProGuard +Input/Output +Shrinking +Optimization +Obfuscation +Information +Process +ReTrace + + +The graphical user interface to ProGuard works like a wizard. It allows +you to browse through the presented tabs and fill them out. +

    +You can click on the small tab buttons to see the full-size versions of the +tabs. + +

    + +Console screenshot + +Of course, real developers don't need all this point-and-click fluff. They +write a short configuration file using their favorite text editor and invoke +ProGuard from the command-line. +

    +You can click on the image to see the full-size version. + +

    +

    + +

    +
    +Copyright © 2002-2009 +Eric Lafortune. +
    + + diff --git a/docs/screenshots_gui_small.gif b/docs/screenshots_gui_small.gif new file mode 100644 index 0000000000000000000000000000000000000000..bc32ccbb85f74add0b96bf0762f68de3ea5fff5c GIT binary patch literal 161022 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�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 literal 0 HcmV?d00001 diff --git a/docs/sections.html b/docs/sections.html new file mode 100644 index 0000000..d955d33 --- /dev/null +++ b/docs/sections.html @@ -0,0 +1,62 @@ + + + + + + + +Sections + + + +

     + +

    +

    +With support of +

    + + + + + + + + +

    + +Luciad +

    + +Sanaware +

    + + + diff --git a/docs/sflogo.png b/docs/sflogo.png new file mode 100644 index 0000000000000000000000000000000000000000..142a6f99abdf58dcb17c5bfceba249335147b55b GIT binary patch literal 469 zcmeAS@N?(olHy`uVBq!ia0y~yV2EH~V36lvW?*0l5&LzCfq_A?#5JNMI6tkVJh3R1 z!7(L2DOJHUH!(dmC^a#qvhZZ84Fdy1RDe&2>;M1%-@SVmpH;MF=iaVKGv+T_RZ`b_ z|Ka0Tuiw;n^zA=CS&5NLBeYw2w4xH)7~WaJ-1FV$^F z85A<-stF%Rk_mpY^&rQBUr$BPDX(RStPSF2UdN~Ur>dhnsv$-5ci^_Y2e;gL%(mX) zR@b+kav#=yl#aP`xZ%m+?8i~3_V=c*Z`ps`>20lauhpU>CGk92{_@K_+O|!M)8l8e zsjK$c_NqQO=apO7_3YPKyQU>by_eHx-29qj%H4l^SG?Z*>b(8_Nxc@!G~O?>us^{$ g|ATtd`ziZ_zj5yFK3VmNfq{X+)78&qol`;+01#>6-v9sr literal 0 HcmV?d00001 diff --git a/docs/steel.gif b/docs/steel.gif new file mode 100644 index 0000000000000000000000000000000000000000..307b57abe7288209f1a4124d0f553d6fd8821f5b GIT binary patch literal 2759 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 Vx7Ym24=6uzO}@iD+>wF78UV)NAr1fl literal 0 HcmV?d00001 diff --git a/docs/style.css b/docs/style.css new file mode 100644 index 0000000..c9798db --- /dev/null +++ b/docs/style.css @@ -0,0 +1,210 @@ + +@charset "iso-8859-1"; + +/* Global settings. */ + +body +{ + background: #FFFFFF; +} + +h1 +{ + text-align: center; +} + +h2 +{ + text-align: center; +} + +h3 +{ + background: #EEEEFF; + padding: 10px; +} + +h3 div +{ + font-weight: normal; + font-size: 80%; + float: right; +} + +table +{ + width: 100%; +} + +th +{ + padding: 4px; +} + +tr.disappeared td +{ + background: #EEEEEE; +} + +td +{ + background: #EEEEFF; + padding: 8px; +} + +a +{ + text-decoration: none; +} + +img +{ + border: none; +} + +/* Settings for the introductory paragraph. */ + +p.intro +{ + background: #EEEEFF; + padding: 10px; + border: solid #000000 1px +} + +/* Settings for the title frame. */ + +body.title +{ + margin: 0px; + padding: 0px; + background: #C0C0C0; +} + +div.title +{ + height: 48px; + margin: 0px; + padding: 0px; + border-width: 1px; + border-style: solid; + border-color: #FFFFFF #808080 #808080 #FFFFFF; + background: url("steel.gif"); +} + +div.title h1 +{ + margin: 0px; + padding: 0px; + padding-top: 8px; + padding-left: 40%; + float: left; +} + +div.title div +{ + margin: 0px; + padding: 0px; + padding-top: 12px; + padding-right: 20px; + float: right; +} + +/* Settings for the section frames. */ + +body.navigation +{ + margin: 0px; + padding: 0px; +} + +ul.navigation +{ + margin: 0px; + padding: 0px; + list-style: none; + text-align: center; + background: url("steel.gif"); +} + +ul.navigation li +{ + margin: 0px; + padding: 0px; + border-width: 1px; + border-style: solid; + border-color: #FFFFFF #808080 #808080 #FFFFFF; + color: #000000; + font-weight: bold; +} + +ul.navigation li.title +{ + margin: 0px; + padding: 4px 10px; + background: #E0E0E0; +} + +ul.navigation li a +{ + margin: 0px; + padding: 6px 0px; + background: transparent; + color: #000000; + text-decoration: none; + display: block; +} + +ul.navigation li a:hover, +ul.navigation li a:focus +{ + background: #FFFFFF; +} + +/* Settings for the yellow note tables. */ + +table.note +{ + width: 408px; + border: none; + border-spacing: 0px; +} + +td.shadow8 +{ + width: 8px; + padding: 0px; + margin: 0px; + vertical-align: bottom; + background: transparent; +} + +td.shadow400 +{ + width: 400px; + padding: 0px; + margin: 0px; + text-align: right; + background: transparent; +} + +td.note +{ + width: 380px; + background: #FFFFC0; + padding: 0px; + margin: 0px; +} + +p.note +{ + padding: 0px; + margin: 0px 10px; + text-align: center; +} + +p.author +{ + padding: 0px; + margin: 0px 10px; + text-align: right; +} diff --git a/docs/testimonials.html b/docs/testimonials.html new file mode 100644 index 0000000..6971617 --- /dev/null +++ b/docs/testimonials.html @@ -0,0 +1,122 @@ + + + + + + +ProGuard Testimonials + + + +

    Testimonials

    + +And now for some shameless self-glorification and name-dropping... +

    +ProGuard is probably the most popular java shrinker, optimizer, and +obfuscator world-wide. It is being used by developers at companies and +organizations like Sun, IBM, HP, Siemens, Nokia, Google, and NATO. It is the +default tool in many development environments like Sun's Wireless Toolkit, +Netbeans, EclipseME, and more. Although the quotes below probably don't +represent official views of any kind, encouragements like these do keep me +happy. +

    + +

    + + + + +

    +ProGuard is the ultimate java obfuscator! +

    +

    P.S, IBM

    +

    + +Also: +

    + + + + +

    +ProGuard is pure quality - powerful and trouble-free. +

    +

    M.B., Statestep

    +

    + +And: +

    + + + + +

    +It is the simplest and most robust obfuscator we have ever used. +

    +

    I.I., Hewlett-Packard

    +

    + +And indeed: +

    + + + + +

    +ProGuard rules. Much easier to use than the commercial alternatives. +

    +

    B.G., Quiotix Corp.

    +

    + +Straight from ProGuard's open discussion forum: +

    +

    + + + + +

    +After searching for, trying to trial, and futzing with numerous other +obfuscators and shrinkers, ProGuard stands out as the simplest, most robust, +and accurate shrinker of them all. +

    +

    D.J., Joot

    +

    + +From the article "Obfuscating MIDlet Suites with ProGuard" at developers.sun.com: +

    +

    + + + + +

    +Its friendly license, attractive price tag, compelling performance, and +powerful configuration options make it an excellent addition to your MIDlet +development toolbox. +

    +

    J.K., Sun

    +

    + +And, of course, the price is stunning: +

    +

    + + + + +

    +You could've been rich. +

    +

    My mother

    +

    + +

    +
    +Copyright © 2002-2009 +Eric Lafortune. +
    + + + diff --git a/docs/title.gif b/docs/title.gif new file mode 100644 index 0000000000000000000000000000000000000000..5e6ca26147abbbff8a94b3991fb6368f42603bf1 GIT binary patch literal 2613 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 + + + + + +ProGuard + + + +
    +

    ProGuard

    +
    Version 4.4
    +
    + + + diff --git a/examples/annotations/examples.pro b/examples/annotations/examples.pro new file mode 100644 index 0000000..270092a --- /dev/null +++ b/examples/annotations/examples.pro @@ -0,0 +1,61 @@ +# +# This ProGuard configuration file illustrates how to use annotations for +# specifying which classes and class members should be kept. +# Usage: +# java -jar proguard.jar @examples.pro +# + +# Specify the input, output, and library jars. +# This is assuming the code has been compiled in the examples directory. + +#-injars examples(*.class) +-injars classes(*.class) +-outjars out + +-libraryjars /lib/rt.jar + +# Some important configuration is based on the annotations in the code. +# We have to specify what the annotations mean to ProGuard. + +-include lib/annotations.pro + +# +# We can then still add any other options that might be useful. +# + +# Print out a list of what we're preserving. + +-printseeds + +# Preserve all annotations themselves. + +-keepattributes *Annotation* + +# Preserve all native method names and the names of their classes. + +-keepclasseswithmembernames class * { + native ; +} + +# Preserve the special static methods that are required in all enumeration +# classes. + +-keepclassmembers class * extends java.lang.Enum { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Explicitly preserve all serialization members. The Serializable interface +# is only a marker interface, so it wouldn't save them. +# You can comment this out if your application doesn't use serialization. +# If your code contains serializable classes that have to be backward +# compatible, please refer to the manual. + +-keepclassmembers class * implements java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); +} diff --git a/examples/annotations/examples/Applet.java b/examples/annotations/examples/Applet.java new file mode 100644 index 0000000..8a5874b --- /dev/null +++ b/examples/annotations/examples/Applet.java @@ -0,0 +1,22 @@ +import proguard.annotation.*; + +/** + * This applet illustrates the use of annotations for configuring ProGuard. + * + * You can compile it with: + * javac -classpath ../lib/annotations.jar Applet.java + * You can then process it with: + * java -jar ../../../lib/proguard.jar @ ../examples.pro + * + * The annotation will preserve the class and its essential methods. + */ +@Keep +public class Applet extends java.applet.Applet +{ + // Implementations for Applet. + + public void init() + { + // ... + } +} diff --git a/examples/annotations/examples/Application.java b/examples/annotations/examples/Application.java new file mode 100644 index 0000000..f8d5060 --- /dev/null +++ b/examples/annotations/examples/Application.java @@ -0,0 +1,20 @@ +import proguard.annotation.KeepApplication; + +/** + * This application illustrates the use of annotations for configuring ProGuard. + * + * You can compile it with: + * javac -classpath ../lib/annotations.jar Application.java + * You can then process it with: + * java -jar ../../../lib/proguard.jar @ ../examples.pro + * + * The annotation will preserve the class and its main method. + */ +@KeepApplication +public class Application +{ + public static void main(String[] args) + { + System.out.println("The answer is 42"); + } +} diff --git a/examples/annotations/examples/Bean.java b/examples/annotations/examples/Bean.java new file mode 100644 index 0000000..0544bf3 --- /dev/null +++ b/examples/annotations/examples/Bean.java @@ -0,0 +1,56 @@ +import proguard.annotation.*; + +/** + * This bean illustrates the use of annotations for configuring ProGuard. + * + * You can compile it with: + * javac -classpath ../lib/annotations.jar Bean.java + * You can then process it with: + * java -jar ../../../lib/proguard.jar @ ../examples.pro + * + * The annotations will preserve the class and its public getters and setters. + */ +@Keep +@KeepPublicGettersSetters +public class Bean +{ + public boolean booleanProperty; + public int intProperty; + public String stringProperty; + + + public boolean isBooleanProperty() + { + return booleanProperty; + } + + + public void setBooleanProperty(boolean booleanProperty) + { + this.booleanProperty = booleanProperty; + } + + + public int getIntProperty() + { + return intProperty; + } + + + public void setIntProperty(int intProperty) + { + this.intProperty = intProperty; + } + + + public String getStringProperty() + { + return stringProperty; + } + + + public void setStringProperty(String stringProperty) + { + this.stringProperty = stringProperty; + } +} diff --git a/examples/annotations/examples/NativeCallBack.java b/examples/annotations/examples/NativeCallBack.java new file mode 100644 index 0000000..2c72f7b --- /dev/null +++ b/examples/annotations/examples/NativeCallBack.java @@ -0,0 +1,44 @@ +import proguard.annotation.*; + +/** + * This application illustrates the use of annotations for configuring ProGuard. + * + * You can compile it with: + * javac -classpath ../lib/annotations.jar NativeCallBack.java + * You can then process it with: + * java -jar ../../../lib/proguard.jar @ ../examples.pro + * + * The annotation will preserve the class and its main method. + */ +@KeepApplication +public class NativeCallBack +{ + /** + * Suppose this is a native method that computes an answer. + * + * The -keep option regular ProGuard configuration will make sure it is + * not renamed when processing this code. + */ + public native int computeAnswer(); + + + /** + * Suppose this method is called back from the above native method. + * + * ProGuard would remove it, because it is not referenced from java. + * The annotation will make sure it is preserved anyhow. + */ + @Keep + public int getAnswer() + { + return 42; + } + + + public static void main(String[] args) + { + int answer = new NativeCallBack().computeAnswer(); + + System.out.println("The answer is " + answer); + } +} diff --git a/examples/annotations/lib/annotations.jar b/examples/annotations/lib/annotations.jar new file mode 100644 index 0000000000000000000000000000000000000000..967d604cba8d2964f2f8b915f82039c3a0a40bed GIT binary patch literal 6123 zcmWIWW@Zs#;9%fjDDMAa#ef7j8CV#6T|*poJ^kGD|D9rBU}gyLX6FE@U;+^g3=Ft6 zi!d-CH2XUGdAhj7|K9Df)?ddHE%YC7Jno`rfIj1$xOjiN(dO6TH0-JBYNNzp`cH+Wucm zu^s)c(|Om$PBn2goHfbCF~;|@_Y5OnCo9b_>vw)&|FQUpr1&-01C5r&Gk?!L{Isra zZ#~0~gPpz3((Yz`l2(CnQ#pHERocEW2O7@!EShe?z1pXfb#KSg8D3Ipk?VE{Rc=eM z_|E&-W8PA}|G5^1`oTfldCrPXpL%Zhy5}~Y+^0hJ=y@Ct`(yQSOM1=wpUQ357K`6! z-SuME!C;a0^La8YJk!4hDr(MMqAh#nKl{ulK`PnC^Ir2W?s&NBp24Zfr_Q(=pPeU` zIxlR`oWH7PW=T{@mmACtUL>KH#caO&wXuQ8m%B}tyb<=dT)g))|IL1V@0+xaleDaI ztg^LR*~au)Ewx_?7;2b7@jU0*@%>_q3=HQPk>eRXgf;Pmuwy|%PG&MV#9@K$>&qzvgG8Zvtqxl+x%eu6Zj~HKP=_o zfs{#m{O@@_`~3PZ^8wp)OmkRXuvn;WNe&m&CtV;i~`jNM#$q|_q6#N52 zCMhMQt@4W02rv~CO4_v~tmNv`bzXW?e`WF5Fz~k)NN6~#=*+GC_TBpTlk@Ap^D~%R za2ALx5PvY^LT^mylA86r!hZ5IrYkQ#^=abgmTvW_#g%&lv{i4d*%bHu&m!-+5^_kp8*FP6iBwSm%pRt$gt$oG+A?C*F)Q6kAL_hC$xg5u_*LVB#l!GhP zzeuy^Ofyvwh$`9^5Y7Eo{{F#jNA`snNP3YwqY%fQIM za1d|UY7rN<@No6@KI{Nat`~oWvhvF<(YmzwV6p$wYu%#W!Ym)Rc(!jy-7G!nuG9Zn z?DY-yUUw=sC^3qsmD|m$O`p+!etS8?c0{=LXb10`-o?3`|IE>d&Q(=UY#wgf71=da zVb0mP+l-#4N1k-~=#ib=I@K+_<#XoQ7OxjNBKEBYVyVZbCI_z zVmGwk{&+gaX-7ud^Bmh(w*Gwo9MjxRmc)LS_jeC;*^%?FAU!CY{{Z*-IPs+?=V*xU z@7!;#_{Gf2|Ky}#?-%A>`C_0zy|*o3zSyn%Q=`;;r|#I7YiFsl3G+84547@^}H9ep}?{Ipkg5YtCHN3R|`SK zK-V@olwx4E$geE98U}fVsE?U7%uMFWx}a#S^HWxdl0?xv6=O+6D+Y{@PAnr5wz*#CSR^vQ+~S!epNNCYloYdXP!Ls=acV@@BP=! z8LnG&6$mU8emLQRU(afzeUrO5kMo~-S{taP7ZIJf^kVmFP{5u%lBvyIH;LOa)aJsi zKMXCG0~3-|OXRxmyUpp+O24hXWtx+vetqD1-u=gyuAXFj$7lX==R=XU)`_nJ>p!Qw zmru!=awaVC-`R`_DlMOXv2Rx^e#mU|`Aur%%sZV~-=?pKA)A^8XWLg_4PyBnB` zpBX*h-G2J-kD6-sf@WdicC|hq8RIR@d$g3Lx?3c6@w*&tS#A>XK{Vas>uR5_Df5m7 zoe`2si`3gG0%{hNn>GXKqm&ysqt7uQVE@(k5l@t@!5tgztPuNB*@d6?Q(|7r`A z3$3!7rTuM<#^)W6p8nDQxLK?1p4!3Lx*C&s#J4V-{r9V+gw(4%$N6kM`MHah-fR42 zI(7SBuI3HR+ottRi`9*NlR0@qzZ_qKJ}8_|p4O<4U}RvpjyIf5@Puwn~?qb&;BrlaF6jSBz!Z)ElsxY==QWn}W{G=b!(+dH<)jX5U`s9S0*D zCNu11Sk83!#xJAA)=NDX)cbGgs#z6kc5TxtxfLEOYo@S<9$p&b-S~N@xu58lHCj`% zq$HE)mYka9^&lzCc;PfP{-^$mJ}EON?-qTrX6d&zMR(8mnu?~xY>E^-{Pv0JEUp-{ z&BaAMpZZQ7wD(B)X+1lt-bVW9#si_BTRYFz+-1<6A-m3Nc6Fp)opAkb{hXqw zS^Oq#@tJFz8XFwCpYy%C==8h#ZNl{A`Tor7-tKi0_;&HA<6J?$!j|L*+@Mg7KJoA> z3nK%=S-hcaKuRdXi;4YyhYbXd?bp_A{Iq_9Vhb0KtVG9*nX7`tx;kcYa2i^^)GT^> zBQPoa)oQ~J3^pQ%5*P4H+>kQ={k!z~^6x*t{$qR~rq0;M#KR;b{A*)j=rR5v!-sDs z?(B(Km0}jSXx;oB9y?d%PfJqeSYEt*tBE|91`CC(_>bl*`M6Bo zyjS^4n3LuDf~)6zMa9?TZqmDX`0f+aSwecZZdyk7|C+7t{$F9@$F*yu|DMc|Io@*m z8~b;)VqeBRAKsLLON)=wGv@OoZut4$GPWp<^Ke+_*&S{yPRHNtnyhYqcmC$#ZQGsY zd28~X^B%e3Dqr1u{Kj!czQ%k|_|EY9F2=;jz;G0A_!aFJ})D1^T-$#9n> zzdqe_%xm(2o63QLKSNf(X`HioQ`i2xUt{!^9(Z|0dbt=R0ZV}sa96gvsc=^2r+|Md zhg_yv?u>3c7nF5gYWmqb9+#VXyu(-x@A$--BOH;21s7VDqBng3}0O^z>Svhy!lrur?oudzw;hJ(X`quW}mwqE#m z%lbyz{pYtEimlfRw1C=U^ErN798lZ=R~Bj`L9Xd(^RW>%(ZbE0y{+6a!-rdb9_&3C6U*RlTOAjsR=#M~Kec}{d<(b#`lL9wFpcxC+tjN^*jSuS zzc;*)TsKq zrriGb?%m)vaJU6mfk1-5g9!`ev(t@s2~U#Hd)K+@#L}RYi5I6CdH;0zw5x7`k?Q9Y z-mCP*Yfeh`J@<qz7SpXa?hPg zYxAiglQx}PrNm!8d3wgFf?Ma#ovgZY-^TJ6bLW=#*;ilqr#-evv&gP5SZ#b=#9?Rp zdhNyB$9@0J{&9SU1l#NL^DniwOSG-6dVRB3Lc*#pe?g>d$^P?lW_x9SWjrX3UZ2pC z`(@+hik8?niSj?dt&Hk2K{p;o28R21gWZy>U`H#U;l&5z!akRdjlrR(oCG1oho$Q} z8S5f=@nOL;MKMVC=JVaZZ{ELKTU%elwBsI+}IrCT9$?!Q3YaUJ!Ro&YawPcc-SLW%p7gnY1m|^atu~WTzZ71mXmOT#DDeZ_|0rxT+Rg!QY%ns3FrW@q!N#FLLsifrDJX?9a24Qb>K#&JVK!Z#O6At5vdr0dN-7Mr`0nl&?!YoxL+{0HG zgDdF9BKL?vV+sgk%b9T-i@g{?HygQM2_5-z}5$4%&;WiIn zs~X(~l?!~BFSAW)y8#{_Z#2dXs?R#^#>V--9~SlK{E@iXu<=&&*{tP}$A0DL)G&;S4c literal 0 HcmV?d00001 diff --git a/examples/annotations/lib/annotations.pro b/examples/annotations/lib/annotations.pro new file mode 100644 index 0000000..f704af2 --- /dev/null +++ b/examples/annotations/lib/annotations.pro @@ -0,0 +1,118 @@ +# +# This ProGuard configuration file specifies how annotations can be used +# to configure the processing of other code. +# Usage: +# java -jar proguard.jar @annotations.pro -libraryjars annotations.jar ... +# +# Note that the other input/output options still have to be specified. +# If you specify them in a separate file, you can simply include this file: +# -include annotations.pro +# +# You can add any other options that are required. For instance, if you are +# processing a library, you can still include the options from library.pro. + + +# The annotations are defined in the accompanying jar. For now, we'll start +# with these. You can always define your own annotations, if necessary. +-libraryjars annotations.jar + + +# The following annotations can be specified with classes and with class +# members. + +# @Keep specifies not to shrink, optimize, or obfuscate the annotated class +# or class member as an entry point. + +-keep @proguard.annotation.Keep class * + +-keepclassmembers class * { + @proguard.annotation.Keep *; +} + + +# @KeepName specifies not to optimize or obfuscate the annotated class or +# class member as an entry point. + +-keepnames @proguard.annotation.KeepName class * + +-keepclassmembernames class * { + @proguard.annotation.KeepName *; +} + + +# The following annotations can only be specified with classes. + +# @KeepImplementations and @KeepPublicImplementations specify to keep all, +# resp. all public, implementations or extensions of the annotated class as +# entry points. Note the extension of the java-like syntax, adding annotations +# before the (wild-carded) interface name. + +-keep class * implements @proguard.annotation.KeepImplementations * +-keep public class * implements @proguard.annotation.KeepPublicImplementations * + +# @KeepApplication specifies to keep the annotated class as an application, +# together with its main method. + +-keepclasseswithmembers @proguard.annotation.KeepApplication public class * { + public static void main(java.lang.String[]); +} + +# @KeepClassMembers, @KeepPublicClassMembers, and +# @KeepPublicProtectedClassMembers specify to keep all, all public, resp. +# all public or protected, class members of the annotated class from being +# shrunk, optimized, or obfuscated as entry points. + +-keepclassmembers @proguard.annotation.KeepClassMembers class * { + *; +} + +-keepclassmembers @proguard.annotation.KeepPublicClassMembers class * { + public *; +} + +-keepclassmembers @proguard.annotation.KeepPublicProtectedClassMembers class * { + public protected *; +} + +# @KeepClassMemberNames, @KeepPublicClassMemberNames, and +# @KeepPublicProtectedClassMemberNames specify to keep all, all public, resp. +# all public or protected, class members of the annotated class from being +# optimized or obfuscated as entry points. + +-keepclassmembernames @proguard.annotation.KeepClassMemberNames class * { + *; +} + +-keepclassmembernames @proguard.annotation.KeepPublicClassMemberNames class * { + public *; +} + +-keepclassmembernames @proguard.annotation.KeepPublicProtectedClassMemberNames class * { + public protected *; +} + +# @KeepGettersSetters and @KeepPublicGettersSetters specify to keep all, resp. +# all public, getters and setters of the annotated class from being shrunk, +# optimized, or obfuscated as entry points. + +-keepclassmembers @proguard.annotation.KeepGettersSetters class * { + void set*(***); + void set*(int, ***); + + boolean is*(); + boolean is*(int); + + *** get*(); + *** get*(int); +} + +-keepclassmembers @proguard.annotation.KeepPublicGettersSetters class * { + public void set*(***); + public void set*(int, ***); + + public boolean is*(); + public boolean is*(int); + + public *** get*(); + public *** get*(int); +} diff --git a/examples/annotations/src/proguard/annotation/Keep.java b/examples/annotations/src/proguard/annotation/Keep.java new file mode 100644 index 0000000..93a469f --- /dev/null +++ b/examples/annotations/src/proguard/annotation/Keep.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies not to optimize or obfuscate the annotated class or + * class member as an entry point. + */ +@Target({ ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.CONSTRUCTOR }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface Keep {} diff --git a/examples/annotations/src/proguard/annotation/KeepApplication.java b/examples/annotations/src/proguard/annotation/KeepApplication.java new file mode 100644 index 0000000..181f9b1 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepApplication.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep the annotated class as an application, + * together with its a main method. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepApplication {} diff --git a/examples/annotations/src/proguard/annotation/KeepClassMemberNames.java b/examples/annotations/src/proguard/annotation/KeepClassMemberNames.java new file mode 100644 index 0000000..b2f1df9 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepClassMemberNames.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all class members of the annotated class + * from being optimized or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepClassMemberNames {} diff --git a/examples/annotations/src/proguard/annotation/KeepClassMembers.java b/examples/annotations/src/proguard/annotation/KeepClassMembers.java new file mode 100644 index 0000000..7ed755b --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepClassMembers.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all class members of the annotated class + * from being shrunk, optimized, or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepClassMembers {} diff --git a/examples/annotations/src/proguard/annotation/KeepGettersSetters.java b/examples/annotations/src/proguard/annotation/KeepGettersSetters.java new file mode 100644 index 0000000..497dcb7 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepGettersSetters.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all getters and setters of the annotated + * class from being shrunk, optimized, or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepGettersSetters {} diff --git a/examples/annotations/src/proguard/annotation/KeepImplementations.java b/examples/annotations/src/proguard/annotation/KeepImplementations.java new file mode 100644 index 0000000..47406a3 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepImplementations.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all implementations or extensions of the + * annotated class as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepImplementations {} diff --git a/examples/annotations/src/proguard/annotation/KeepName.java b/examples/annotations/src/proguard/annotation/KeepName.java new file mode 100644 index 0000000..5dd3680 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepName.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies not to optimize or obfuscate the annotated class or + * class member as an entry point. + */ +@Target({ ElementType.TYPE, ElementType.FIELD, ElementType.METHOD, ElementType.CONSTRUCTOR }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepName {} diff --git a/examples/annotations/src/proguard/annotation/KeepPublicClassMemberNames.java b/examples/annotations/src/proguard/annotation/KeepPublicClassMemberNames.java new file mode 100644 index 0000000..f24b126 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepPublicClassMemberNames.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all public class members of the annotated + * class from being optimized or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepPublicClassMemberNames {} diff --git a/examples/annotations/src/proguard/annotation/KeepPublicClassMembers.java b/examples/annotations/src/proguard/annotation/KeepPublicClassMembers.java new file mode 100644 index 0000000..2be7fa4 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepPublicClassMembers.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all public class members of the annotated + * class from being shrunk, optimized, or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepPublicClassMembers {} diff --git a/examples/annotations/src/proguard/annotation/KeepPublicGettersSetters.java b/examples/annotations/src/proguard/annotation/KeepPublicGettersSetters.java new file mode 100644 index 0000000..6028ba9 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepPublicGettersSetters.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all public getters and setters of the + * annotated class from being shrunk, optimized, or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepPublicGettersSetters {} diff --git a/examples/annotations/src/proguard/annotation/KeepPublicImplementations.java b/examples/annotations/src/proguard/annotation/KeepPublicImplementations.java new file mode 100644 index 0000000..52ee5b9 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepPublicImplementations.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all public implementations or extensions + * of the annotated class as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepPublicImplementations {} diff --git a/examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMemberNames.java b/examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMemberNames.java new file mode 100644 index 0000000..59f0004 --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMemberNames.java @@ -0,0 +1,18 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all public or protected class members of + * the annotated class from being optimized or obfuscated as entry points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepPublicProtectedClassMemberNames {} diff --git a/examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMembers.java b/examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMembers.java new file mode 100644 index 0000000..e918a9b --- /dev/null +++ b/examples/annotations/src/proguard/annotation/KeepPublicProtectedClassMembers.java @@ -0,0 +1,19 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2007 Eric Lafortune (eric@graphics.cornell.edu) + */ +package proguard.annotation; + +import java.lang.annotation.*; + +/** + * This annotation specifies to keep all public or protected class members of + * the annotated class from being shrunk, optimized, or obfuscated as entry + * points. + */ +@Target({ ElementType.TYPE }) +@Retention(RetentionPolicy.CLASS) +@Documented +public @interface KeepPublicProtectedClassMembers {} diff --git a/examples/ant/applets.xml b/examples/ant/applets.xml new file mode 100644 index 0000000..a55b1c3 --- /dev/null +++ b/examples/ant/applets.xml @@ -0,0 +1,81 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/ant/applications1.xml b/examples/ant/applications1.xml new file mode 100644 index 0000000..7a3d473 --- /dev/null +++ b/examples/ant/applications1.xml @@ -0,0 +1,15 @@ + + + + + + + + + + + + diff --git a/examples/ant/applications2.xml b/examples/ant/applications2.xml new file mode 100644 index 0000000..2e28f01 --- /dev/null +++ b/examples/ant/applications2.xml @@ -0,0 +1,68 @@ + + + + + + + + + + + + -injars in.jar + -outjars out.jar + + -libraryjars ${java.home}/lib/rt.jar + + + + + + + + -keepclasseswithmembers public class * { + public static void main(java.lang.String[]); + } + + + + -keepattributes *Annotation* + + + + -keepclasseswithmembernames class * { + native <methods>; + } + + + + -keepclassmembers class * extends java.lang.Enum { + public static **[] values(); + public static ** valueOf(java.lang.String); + } + + + + -keepclassmembers class * implements java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); + } + + + + + + + diff --git a/examples/ant/applications3.xml b/examples/ant/applications3.xml new file mode 100644 index 0000000..d5501e0 --- /dev/null +++ b/examples/ant/applications3.xml @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/ant/library.xml b/examples/ant/library.xml new file mode 100644 index 0000000..d87bd16 --- /dev/null +++ b/examples/ant/library.xml @@ -0,0 +1,102 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/ant/midlets.xml b/examples/ant/midlets.xml new file mode 100644 index 0000000..b17d036 --- /dev/null +++ b/examples/ant/midlets.xml @@ -0,0 +1,45 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/ant/proguard.xml b/examples/ant/proguard.xml new file mode 100644 index 0000000..315e628 --- /dev/null +++ b/examples/ant/proguard.xml @@ -0,0 +1,73 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/ant/servlets.xml b/examples/ant/servlets.xml new file mode 100644 index 0000000..83af0f2 --- /dev/null +++ b/examples/ant/servlets.xml @@ -0,0 +1,81 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/applets.pro b/examples/applets.pro new file mode 100644 index 0000000..ee90db0 --- /dev/null +++ b/examples/applets.pro @@ -0,0 +1,60 @@ +# +# This ProGuard configuration file illustrates how to process applets. +# Usage: +# java -jar proguard.jar @applets.pro +# + +# Specify the input jars, output jars, and library jars. + +-injars in.jar +-outjars out.jar + +-libraryjars /lib/rt.jar + +# Preserve all public applets. + +-keep public class * extends java.applet.Applet + +# Print out a list of what we're preserving. + +-printseeds + +# Preserve all annotations. + +-keepattributes *Annotation* + +# Preserve all native method names and the names of their classes. + +-keepclasseswithmembernames class * { + native ; +} + +# Preserve the special static methods that are required in all enumeration +# classes. + +-keepclassmembers class * extends java.lang.Enum { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Explicitly preserve all serialization members. The Serializable interface +# is only a marker interface, so it wouldn't save them. +# You can comment this out if your library doesn't use serialization. +# If your code contains serializable classes that have to be backward +# compatible, please refer to the manual. + +-keepclassmembers class * implements java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); +} + +# Your application may contain more items that need to be preserved; +# typically classes that are dynamically created using Class.forName: + +# -keep public class mypackage.MyClass +# -keep public interface mypackage.MyInterface +# -keep public class * implements mypackage.MyInterface diff --git a/examples/applications.pro b/examples/applications.pro new file mode 100644 index 0000000..29d8e43 --- /dev/null +++ b/examples/applications.pro @@ -0,0 +1,66 @@ +# +# This ProGuard configuration file illustrates how to process applications. +# Usage: +# java -jar proguard.jar @applications.pro +# + +# Specify the input jars, output jars, and library jars. + +-injars in.jar +-outjars out.jar + +-libraryjars /lib/rt.jar +#-libraryjars junit.jar +#-libraryjars servlet.jar +#-libraryjars jai_core.jar +#... + +# Preserve all public applications. + +-keepclasseswithmembers public class * { + public static void main(java.lang.String[]); +} + +# Print out a list of what we're preserving. + +-printseeds + +# Preserve all annotations. + +-keepattributes *Annotation* + +# Preserve all native method names and the names of their classes. + +-keepclasseswithmembernames class * { + native ; +} + +# Preserve the special static methods that are required in all enumeration +# classes. + +-keepclassmembers class * extends java.lang.Enum { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Explicitly preserve all serialization members. The Serializable interface +# is only a marker interface, so it wouldn't save them. +# You can comment this out if your application doesn't use serialization. +# If your code contains serializable classes that have to be backward +# compatible, please refer to the manual. + +-keepclassmembers class * implements java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); +} + +# Your application may contain more items that need to be preserved; +# typically classes that are dynamically created using Class.forName: + +# -keep public class mypackage.MyClass +# -keep public interface mypackage.MyInterface +# -keep public class * implements mypackage.MyInterface diff --git a/examples/dictionaries/compact.txt b/examples/dictionaries/compact.txt new file mode 100644 index 0000000..5636a3e --- /dev/null +++ b/examples/dictionaries/compact.txt @@ -0,0 +1,18 @@ +# +# This obfuscation dictionary contains strings that are already present +# in many class files. Since these strings can be shared, the resulting +# obfuscated class files will generally be a little bit more compact. +# Usage: +# java -jar proguard.jar ..... -obfuscationdictionary compact.txt +# + +Code +V +I +Z +B +C +S +F +D +L diff --git a/examples/dictionaries/keywords.txt b/examples/dictionaries/keywords.txt new file mode 100644 index 0000000..76f5a7b --- /dev/null +++ b/examples/dictionaries/keywords.txt @@ -0,0 +1,58 @@ +# +# This obfuscation dictionary contains reserved Java keywords. They can't +# be used in Java source files, but they can be used in compiled class files. +# Note that this hardly improves the obfuscation. Decent decompilers can +# automatically replace reserved keywords, and the effect can fairly simply be +# undone by obfuscating again with simpler names. +# Usage: +# java -jar proguard.jar ..... -obfuscationdictionary keywords.txt +# + +do +if +for +int +new +try +byte +case +char +else +goto +long +this +void +break +catch +class +const +final +float +short +super +throw +while +double +import +native +public +return +static +switch +throws +boolean +default +extends +finally +package +private +abstract +continue +strictfp +volatile +interface +protected +transient +implements +instanceof +synchronized diff --git a/examples/dictionaries/shakespeare.txt b/examples/dictionaries/shakespeare.txt new file mode 100755 index 0000000..28b1cd8 --- /dev/null +++ b/examples/dictionaries/shakespeare.txt @@ -0,0 +1,23 @@ +# +# This obfuscation dictionary contains quotes from plays by Shakespeare. +# It illustrates that any text can be used, for whatever flippant reasons +# one may have. +# Usage: +# java -jar proguard.jar ..... -obfuscationdictionary shakespeare.txt +# + + +"This thing of darkness I acknowledge mine." + + --From The Tempest (V, i, 275-276) + + +"Though this be madness, yet there is method in 't." + + --From Hamlet (II, ii, 206) + + +"What's in a name? That which we call a rose + By any other word would smell as sweet." + + --From Romeo and Juliet (II, ii, 1-2) diff --git a/examples/dictionaries/windows.txt b/examples/dictionaries/windows.txt new file mode 100644 index 0000000..fd65dc9 --- /dev/null +++ b/examples/dictionaries/windows.txt @@ -0,0 +1,209 @@ +# +# This obfuscation dictionary contains names that are not allowed as file names +# in Windows, not even with extensions like .class or .java. They can however +# be used without problems in jar archives, which just begs to apply them as +# obfuscated class names. Trying to unpack the obfuscated archives in Windows +# will probably generate some sparks. +# Usage: +# java -jar proguard.jar ..... -classobfuscationdictionary windows.txt +# -packageobfuscationdictionary windows.txt +# + +aux +Aux +aUx +AUx +auX +AuX +aUX +AUX +AUX +con +Con +cOn +COn +coN +CoN +cON +CON +CON +nul +Nul +nUl +NUl +nuL +NuL +nUL +NUL +NUL +prn +Prn +pRn +PRn +prN +PrN +pRN +PRN +PRN +com1 +Com1 +cOm1 +COm1 +coM1 +CoM1 +cOM1 +COM1 +COM1 +com2 +Com2 +cOm2 +COm2 +coM2 +CoM2 +cOM2 +COM2 +COM2 +com3 +Com3 +cOm3 +COm3 +coM3 +CoM3 +cOM3 +COM3 +COM3 +com4 +Com4 +cOm4 +COm4 +coM4 +CoM4 +cOM4 +COM4 +COM4 +com5 +Com5 +cOm5 +COm5 +coM5 +CoM5 +cOM5 +COM5 +COM5 +com6 +Com6 +cOm6 +COm6 +coM6 +CoM6 +cOM6 +COM6 +COM6 +com7 +Com7 +cOm7 +COm7 +coM7 +CoM7 +cOM7 +COM7 +COM7 +com8 +Com8 +cOm8 +COm8 +coM8 +CoM8 +cOM8 +COM8 +COM8 +com9 +Com9 +cOm9 +COm9 +coM9 +CoM9 +cOM9 +COM9 +COM9 +lpt1 +Lpt1 +lPt1 +LPt1 +lpT1 +LpT1 +lPT1 +LPT1 +LPT1 +lpt2 +Lpt2 +lPt2 +LPt2 +lpT2 +LpT2 +lPT2 +LPT2 +LPT2 +lpt3 +Lpt3 +lPt3 +LPt3 +lpT3 +LpT3 +lPT3 +LPT3 +LPT3 +lpt4 +Lpt4 +lPt4 +LPt4 +lpT4 +LpT4 +lPT4 +LPT4 +LPT4 +lpt5 +Lpt5 +lPt5 +LPt5 +lpT5 +LpT5 +lPT5 +LPT5 +LPT5 +lpt6 +Lpt6 +lPt6 +LPt6 +lpT6 +LpT6 +lPT6 +LPT6 +LPT6 +lpt7 +Lpt7 +lPt7 +LPt7 +lpT7 +LpT7 +lPT7 +LPT7 +LPT7 +lpt8 +Lpt8 +lPt8 +LPt8 +lpT8 +LpT8 +lPT8 +LPT8 +LPT8 +lpt9 +Lpt9 +lPt9 +LPt9 +lpT9 +LpT9 +lPT9 +LPT9 +LPT9 diff --git a/examples/library.pro b/examples/library.pro new file mode 100644 index 0000000..37be47e --- /dev/null +++ b/examples/library.pro @@ -0,0 +1,78 @@ +# +# This ProGuard configuration file illustrates how to process a program +# library, such that it remains usable as a library. +# Usage: +# java -jar proguard.jar @library.pro +# + +# Specify the input jars, output jars, and library jars. +# In this case, the input jar is the program library that we want to process. + +-injars in.jar +-outjars out.jar + +-libraryjars /lib/rt.jar + +# Save the obfuscation mapping to a file, so we can de-obfuscate any stack +# traces later on. Keep a fixed source file attribute and all line number +# tables to actually get these stack traces. +# You can comment this out if you're not interested in stack traces. + +-printmapping out.map +-renamesourcefileattribute SourceFile +-keepattributes Exceptions,InnerClasses,Signature,Deprecated, + SourceFile,LineNumberTable,EnclosingMethod + +# Preserve all annotations. + +-keepattributes *Annotation* + +# Preserve all public classes, and their public and protected fields and +# methods. + +-keep public class * { + public protected *; +} + +# Preserve all .class method names. + +-keepclassmembernames class * { + java.lang.Class class$(java.lang.String); + java.lang.Class class$(java.lang.String, boolean); +} + +# Preserve all native method names and the names of their classes. + +-keepclasseswithmembernames class * { + native ; +} + +# Preserve the special static methods that are required in all enumeration +# classes. + +-keepclassmembers class * extends java.lang.Enum { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Explicitly preserve all serialization members. The Serializable interface +# is only a marker interface, so it wouldn't save them. +# You can comment this out if your library doesn't use serialization. +# If your code contains serializable classes that have to be backward +# compatible, please refer to the manual. + +-keepclassmembers class * implements java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); +} + +# Your library may contain more items that need to be preserved; +# typically classes that are dynamically created using Class.forName: + +# -keep public class mypackage.MyClass +# -keep public interface mypackage.MyInterface +# -keep public class * implements mypackage.MyInterface diff --git a/examples/midlets.pro b/examples/midlets.pro new file mode 100644 index 0000000..bffc38e --- /dev/null +++ b/examples/midlets.pro @@ -0,0 +1,56 @@ +# +# This ProGuard configuration file illustrates how to process J2ME midlets. +# Usage: +# java -jar proguard.jar @midlets.pro +# + +# Specify the input jars, output jars, and library jars. + +-injars in.jar +-outjars out.jar + +-libraryjars /usr/local/java/wtk2.1/lib/midpapi20.jar +-libraryjars /usr/local/java/wtk2.1/lib/cldcapi11.jar + +# Preverify the code suitably for Java Micro Edition. + +-microedition + +# Allow methods with the same signature, except for the return type, +# to get the same obfuscation name. + +-overloadaggressively + +# Put all obfuscated classes into the nameless root package. + +-repackageclasses '' + +# Allow classes and class members to be made public. + +-allowaccessmodification + +# On Windows, you can't use mixed case class names, +# should you still want to use the preverify tool. +# +# -dontusemixedcaseclassnames + +# Preserve all public midlets. + +-keep public class * extends javax.microedition.midlet.MIDlet + +# Print out a list of what we're preserving. + +-printseeds + +# Preserve all native method names and the names of their classes. + +-keepclasseswithmembernames class * { + native ; +} + +# Your midlet may contain more items that need to be preserved; +# typically classes that are dynamically created using Class.forName: + +# -keep public class mypackage.MyClass +# -keep public interface mypackage.MyInterface +# -keep public class * implements mypackage.MyInterface diff --git a/examples/proguard.pro b/examples/proguard.pro new file mode 100644 index 0000000..c48b87e --- /dev/null +++ b/examples/proguard.pro @@ -0,0 +1,57 @@ +# +# This ProGuard configuration file illustrates how to process ProGuard itself. +# Configuration files for typical applications will be very similar. +# Usage: +# java -jar proguard.jar @proguard.pro +# + +# Specify the input jars, output jars, and library jars. +# We'll filter out the Ant and WTK classes, keeping everything else. + +-injars ../lib/proguard.jar(!proguard/ant/**,!proguard/wtk/**) +-outjars proguard_out.jar + +-libraryjars /lib/rt.jar + +# Write out an obfuscation mapping file, for de-obfuscating any stack traces +# later on, or for incremental obfuscation of extensions. + +-printmapping proguard.map + +# Allow methods with the same signature, except for the return type, +# to get the same obfuscation name. + +-overloadaggressively + +# Put all obfuscated classes into the nameless root package. + +-repackageclasses '' + +# Allow classes and class members to be made public. + +-allowaccessmodification + +# The entry point: ProGuard and its main method. + +-keep public class proguard.ProGuard { + public static void main(java.lang.String[]); +} + +# If you want to preserve the Ant task as well, you'll have to specify the +# main ant.jar. + +#-libraryjars /usr/local/java/ant/lib/ant.jar +#-adaptresourcefilecontents proguard/ant/task.properties +# +#-keep,allowobfuscation class proguard.ant.* +#-keepclassmembers public class proguard.ant.* { +# (org.apache.tools.ant.Project); +# public void set*(***); +# public void add*(***); +#} + +# If you want to preserve the WTK obfuscation plug-in, you'll have to specify +# the kenv.zip file. + +#-libraryjars /usr/local/java/wtk2.1/wtklib/kenv.zip +#-keep public class proguard.wtk.ProGuardObfuscator diff --git a/examples/proguardall.pro b/examples/proguardall.pro new file mode 100644 index 0000000..8dc042e --- /dev/null +++ b/examples/proguardall.pro @@ -0,0 +1,62 @@ +# +# This ProGuard configuration file illustrates how to process ProGuard +# (including its main application, its GUI, its Ant task, and its WTK plugin), +# and the ReTrace tool, all in one go. +# Configuration files for typical applications will be very similar. +# Usage: +# java -jar proguard.jar @proguardall.pro +# + +# Specify the input jars, output jars, and library jars. +# We'll read all jars from the lib directory, process them, and write the +# processed jars to a new out directory. + +-injars ../lib +-outjars out + +# You may have to adapt the paths below. + +-libraryjars /lib/rt.jar +-libraryjars /usr/local/java/ant1.5.0/lib/ant.jar +-libraryjars /usr/local/java/wtk2.1/wtklib/kenv.zip + +# Allow methods with the same signature, except for the return type, +# to get the same obfuscation name. + +-overloadaggressively + +# Put all obfuscated classes into the nameless root package. + +-repackageclasses '' + +# Adapt the names and contents of the resource files. + +-adaptresourcefilenames **.properties,**.gif,**.jpg +-adaptresourcefilecontents proguard/ant/task.properties + +# The main entry points. + +-keep public class proguard.ProGuard { + public static void main(java.lang.String[]); +} + +-keep public class proguard.gui.ProGuardGUI { + public static void main(java.lang.String[]); +} + +-keep public class proguard.retrace.ReTrace { + public static void main(java.lang.String[]); +} + +# If we have ant.jar, we can properly process the Ant task. + +-keep,allowobfuscation class proguard.ant.* +-keepclassmembers public class proguard.ant.* { + (org.apache.tools.ant.Project); + public void set*(***); + public void add*(***); +} + +# If we have kenv.zip, we can process the J2ME WTK plugin. + +-keep public class proguard.wtk.ProGuardObfuscator diff --git a/examples/proguardgui.pro b/examples/proguardgui.pro new file mode 100644 index 0000000..2cb83ed --- /dev/null +++ b/examples/proguardgui.pro @@ -0,0 +1,55 @@ +# +# This ProGuard configuration file illustrates how to process the ProGuard GUI. +# Configuration files for typical applications will be very similar. +# Usage: +# java -jar proguard.jar @proguardgui.pro +# + +# Specify the input jars, output jars, and library jars. +# The input jars will be merged in a single output jar. +# We'll filter out the Ant and WTK classes. + +-injars ../lib/proguardgui.jar +-injars ../lib/proguard.jar(!META-INF/**,!proguard/ant/**,!proguard/wtk/**) +-injars ../lib/retrace.jar (!META-INF/**) +-outjars proguardgui_out.jar + +-libraryjars /lib/rt.jar + +# In recent JREs, some public Swing classes depend on package visible classes, +# so don't skip these package visible classes while parsing the library jar. + +-dontskipnonpubliclibraryclasses + +# If we wanted to reuse the previously obfuscated proguard_out.jar, we could +# perform incremental obfuscation based on its mapping file, and only keep the +# additional GUI files instead of all files. + +#-applymapping proguard.map +#-injars ../lib/proguardgui.jar +#-outjars proguardgui_out.jar +#-libraryjars ../lib/proguard.jar(!proguard/ant/**,!proguard/wtk/**) +#-libraryjars ../lib/retrace.jar +#-libraryjars /lib/rt.jar + + +# Allow methods with the same signature, except for the return type, +# to get the same obfuscation name. + +-overloadaggressively + +# Put all obfuscated classes into the nameless root package. + +-repackageclasses '' + +# Adapt the names of resource files, based on the corresponding obfuscated +# class names. Notably, in this case, the GUI resource properties file will +# have to be renamed. + +-adaptresourcefilenames **.properties,**.gif,**.jpg + +# The entry point: ProGuardGUI and its main method. + +-keep public class proguard.gui.ProGuardGUI { + public static void main(java.lang.String[]); +} diff --git a/examples/retrace.pro b/examples/retrace.pro new file mode 100644 index 0000000..39f5a95 --- /dev/null +++ b/examples/retrace.pro @@ -0,0 +1,43 @@ +# +# This ProGuard configuration file illustrates how to process the ReTrace tool. +# Configuration files for typical applications will be very similar. +# Usage: +# java -jar proguard.jar @retrace.pro +# + +# Specify the input jars, output jars, and library jars. +# The input jars will be merged in a single output jar. +# We'll filter out the Ant and WTK classes. + +-injars ../lib/retrace.jar +-injars ../lib/proguard.jar(!META-INF/MANIFEST.MF, + !proguard/ant/**,!proguard/wtk/**) +-outjars retrace_out.jar + +-libraryjars /lib/rt.jar + +# If we wanted to reuse the previously obfuscated proguard_out.jar, we could +# perform incremental obfuscation based on its mapping file, and only keep the +# additional ReTrace files instead of all files. + +#-applymapping proguard.map +#-outjars retrace_out.jar(proguard/retrace/**) + +# Allow methods with the same signature, except for the return type, +# to get the same obfuscation name. + +-overloadaggressively + +# Put all obfuscated classes into the nameless root package. + +-repackageclasses '' + +# Allow classes and class members to be made public. + +-allowaccessmodification + +# The entry point: ReTrace and its main method. + +-keep public class proguard.retrace.ReTrace { + public static void main(java.lang.String[]); +} diff --git a/examples/servlets.pro b/examples/servlets.pro new file mode 100644 index 0000000..fdc36b0 --- /dev/null +++ b/examples/servlets.pro @@ -0,0 +1,61 @@ +# +# This ProGuard configuration file illustrates how to process servlets. +# Usage: +# java -jar proguard.jar @servlets.pro +# + +# Specify the input jars, output jars, and library jars. + +-injars in.jar +-outjars out.jar + +-libraryjars /lib/rt.jar +-libraryjars /usr/local/java/servlet/servlet.jar + +# Preserve all public servlets. + +-keep public class * implements javax.servlet.Servlet + +# Print out a list of what we're preserving. + +-printseeds + +# Preserve all annotations. + +-keepattributes *Annotation* + +# Preserve all native method names and the names of their classes. + +-keepclasseswithmembernames class * { + native ; +} + +# Preserve the special static methods that are required in all enumeration +# classes. + +-keepclassmembers class * extends java.lang.Enum { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Explicitly preserve all serialization members. The Serializable interface +# is only a marker interface, so it wouldn't save them. +# You can comment this out if your library doesn't use serialization. +# If your code contains serializable classes that have to be backward +# compatible, please refer to the manual. + +-keepclassmembers class * implements java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); +} + +# Your application may contain more items that need to be preserved; +# typically classes that are dynamically created using Class.forName: + +# -keep public class mypackage.MyClass +# -keep public interface mypackage.MyInterface +# -keep public class * implements mypackage.MyInterface diff --git a/lib/proguard.jar b/lib/proguard.jar new file mode 100644 index 0000000000000000000000000000000000000000..3a9aebcfc67326159522492d53b201aa1ea0d422 GIT binary patch literal 664512 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 z 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%0Dth;Q@)ypO3cUHn>S@NrYyXLBvr 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¬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 kSgm=dD8DE*SWv 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 z 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 literal 0 HcmV?d00001 diff --git a/lib/proguardgui.jar b/lib/proguardgui.jar new file mode 100644 index 0000000000000000000000000000000000000000..58668561db9f5753798b1cc55e3732eb6bd36026 GIT binary patch literal 137516 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

    4xdI1zo*P=(TP*aYFFA_2juxB`exW?56rx-i+Zb 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%0Am- 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

  • +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 z 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

    =*BQvSh`qebx8NKbUXbC$Rj- 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 i7u0ml@d3?b%m_g>n3W9_*nQij` literal 0 HcmV?d00001 diff --git a/lib/retrace.jar b/lib/retrace.jar new file mode 100644 index 0000000000000000000000000000000000000000..8e42e5a3bbfd615d3e159e3d89f6a2ec51172a65 GIT binary patch literal 6888 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 VH!B-RCmRDB!x2UX20lp;4*)tSPHO-F literal 0 HcmV?d00001 diff --git a/src/proguard/ArgumentWordReader.java b/src/proguard/ArgumentWordReader.java new file mode 100644 index 0000000..89f3824 --- /dev/null +++ b/src/proguard/ArgumentWordReader.java @@ -0,0 +1,110 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.*; + + +/** + * A WordReader that returns words from an argument list. + * Single arguments are split into individual words if necessary. + * + * @author Eric Lafortune + */ +public class ArgumentWordReader extends WordReader +{ + private final String[] arguments; + private int index = 0; + + +// /** +// * Creates a new ArgumentWordReader for the given arguments. +// */ +// public ArgumentWordReader(String[] arguments) +// { +// this(arguments, null); +// } +// +// + /** + * Creates a new ArgumentWordReader for the given arguments, with the + * given base directory. + */ + public ArgumentWordReader(String[] arguments, File baseDir) + { + super(baseDir); + + this.arguments = arguments; + } + + + // Implementations for WordReader. + + protected String nextLine() throws IOException + { + return index < arguments.length ? + arguments[index++] : + null; + } + + + protected String lineLocationDescription() + { + return "argument number " + index; + } + + + /** + * Test application that prints out the individual words of + * the argument list. + */ + public static void main(String[] args) { + + try + { + WordReader reader = new ArgumentWordReader(args, null); + + try + { + while (true) + { + String word = reader.nextWord(); + if (word == null) + System.exit(-1); + + System.err.println("["+word+"]"); + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + finally + { + reader.close(); + } + } + catch (IOException ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/ClassPath.java b/src/proguard/ClassPath.java new file mode 100644 index 0000000..f4eeaad --- /dev/null +++ b/src/proguard/ClassPath.java @@ -0,0 +1,94 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.util.*; + + +/** + * This class represents a class path, as a list of ClassPathEntry objects. + * + * @author Eric Lafortune + */ +public class ClassPath +{ + private final List classPathEntries = new ArrayList(); + + + /** + * Returns whether the class path contains any output entries. + */ + public boolean hasOutput() + { + for (int index = 0; index < classPathEntries.size(); index++) + { + if (((ClassPathEntry)classPathEntries.get(index)).isOutput()) + { + return true; + } + } + + return false; + } + + + // Delegates to List. + + public void clear() + { + classPathEntries.clear(); + } + + public void add(int index, ClassPathEntry classPathEntry) + { + classPathEntries.add(index, classPathEntry); + } + + public boolean add(ClassPathEntry classPathEntry) + { + return classPathEntries.add(classPathEntry); + } + + public boolean addAll(ClassPath classPath) + { + return classPathEntries.addAll(classPath.classPathEntries); + } + + public ClassPathEntry get(int index) + { + return (ClassPathEntry)classPathEntries.get(index); + } + + public ClassPathEntry remove(int index) + { + return (ClassPathEntry)classPathEntries.remove(index); + } + + public boolean isEmpty() + { + return classPathEntries.isEmpty(); + } + + public int size() + { + return classPathEntries.size(); + } +} diff --git a/src/proguard/ClassPathEntry.java b/src/proguard/ClassPathEntry.java new file mode 100644 index 0000000..28483be --- /dev/null +++ b/src/proguard/ClassPathEntry.java @@ -0,0 +1,149 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.*; +import java.util.List; + + +/** + * This class represents an entry from a class path: a jar, a war, a zip, an + * ear, or a directory, with a name and a flag to indicates whether the entry is + * an input entry or an output entry. Optional filters can be specified for the + * names of the contained resource/classes, jars, wars, ears, and zips. + * + * @author Eric Lafortune + */ +public class ClassPathEntry +{ + private File file; + private boolean output; + private List filter; + private List jarFilter; + private List warFilter; + private List earFilter; + private List zipFilter; + + + /** + * Creates a new ClassPathEntry with the given name and type. + */ + public ClassPathEntry(File file, boolean isOutput) + { + this.file = file; + this.output = isOutput; + } + + + /** + * Returns the path name of the entry. + */ + public String getName() + { + try + { + return file.getCanonicalPath(); + } + catch (IOException ex) + { + return file.getPath(); + } + } + + + public File getFile() + { + return file; + } + + + public void setFile(File file) + { + this.file = file; + } + + + public boolean isOutput() + { + return output; + } + + + public void setOutput(boolean output) + { + this.output = output; + } + + + public List getFilter() + { + return filter; + } + + public void setFilter(List filter) + { + this.filter = filter == null || filter.size() == 0 ? null : filter; + } + + + public List getJarFilter() + { + return jarFilter; + } + + public void setJarFilter(List filter) + { + this.jarFilter = filter == null || filter.size() == 0 ? null : filter; + } + + + public List getWarFilter() + { + return warFilter; + } + + public void setWarFilter(List filter) + { + this.warFilter = filter == null || filter.size() == 0 ? null : filter; + } + + + public List getEarFilter() + { + return earFilter; + } + + public void setEarFilter(List filter) + { + this.earFilter = filter == null || filter.size() == 0 ? null : filter; + } + + + public List getZipFilter() + { + return zipFilter; + } + + public void setZipFilter(List filter) + { + this.zipFilter = filter == null || filter.size() == 0 ? null : filter; + } +} diff --git a/src/proguard/ClassSpecification.java b/src/proguard/ClassSpecification.java new file mode 100644 index 0000000..a84e0c8 --- /dev/null +++ b/src/proguard/ClassSpecification.java @@ -0,0 +1,259 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.util.*; + +/** + * This class stores a specification of classes and possibly class members. + * The specification is template-based: the class names and class member names + * and descriptors can contain wildcards. Classes can be specified explicitly, + * or as extensions or implementations in the class hierarchy. + * + * @author Eric Lafortune + */ +public class ClassSpecification implements Cloneable +{ + public final String comments; + public int requiredSetAccessFlags; + public int requiredUnsetAccessFlags; + public final String annotationType; + public String className; + public final String extendsAnnotationType; + public final String extendsClassName; + + public List fieldSpecifications; + public List methodSpecifications; + + + /** + * Creates a new ClassSpecification for all possible classes, without + * comments or class members. + */ + public ClassSpecification() + { + this(null, + 0, + 0, + null, + null, + null, + null); + } + + + /** + * Creates a new ClassSpecification that is a copy of the given specification. + */ + public ClassSpecification(ClassSpecification classSpecification) + { + this(classSpecification.comments, + classSpecification.requiredSetAccessFlags, + classSpecification.requiredUnsetAccessFlags, + classSpecification.annotationType, + classSpecification.className, + classSpecification.extendsAnnotationType, + classSpecification.extendsClassName, + classSpecification.fieldSpecifications, + classSpecification.methodSpecifications); + } + + + /** + * Creates a new ClassSpecification for the specified class(es), without + * class members. + * + * @param comments provides optional comments on this + * specification. + * @param requiredSetAccessFlags the class access flags that must be set + * in order for the class to apply. + * @param requiredUnsetAccessFlags the class access flags that must be + * unset in order for the class to apply. + * @param annotationType the name of the class that must be an + * annotation of the class in order for it + * to apply. The name may be null to + * specify that no annotation is required. + * @param className the class name. The name may be null to + * specify any class, or it may contain + * "**", "*", or "?" wildcards. + * @param extendsAnnotationType the name of the class of that must be + * an annotation of the class that the + * class must extend or implement in order + * to apply. The name may be null to + * specify that no annotation is required. + * @param extendsClassName the name of the class that the class + * must extend or implement in order to + * apply. The name may be null to specify + * any class. + */ + public ClassSpecification(String comments, + int requiredSetAccessFlags, + int requiredUnsetAccessFlags, + String annotationType, + String className, + String extendsAnnotationType, + String extendsClassName) + { + this(comments, + requiredSetAccessFlags, + requiredUnsetAccessFlags, + annotationType, + className, + extendsAnnotationType, + extendsClassName, + null, + null); + } + + + /** + * Creates a new ClassSpecification for the specified classes and class + * members. + * + * @param comments provides optional comments on this + * specification. + * @param requiredSetAccessFlags the class access flags that must be set + * in order for the class to apply. + * @param requiredUnsetAccessFlags the class access flags that must be + * unset in order for the class to apply. + * @param annotationType the name of the class that must be an + * annotation of the class in order for it + * to apply. The name may be null to + * specify that no annotation is required. + * @param className the class name. The name may be null to + * specify any class, or it may contain + * "**", "*", or "?" wildcards. + * @param extendsAnnotationType the name of the class of that must be + * an annotation of the class that the + * class must extend or implement in order + * to apply. The name may be null to + * specify that no annotation is required. + * @param extendsClassName the name of the class that the class + * must extend or implement in order to + * apply. The name may be null to specify + * any class. + * @param fieldSpecifications the field specifications. + * @param methodSpecifications the method specifications. + */ + public ClassSpecification(String comments, + int requiredSetAccessFlags, + int requiredUnsetAccessFlags, + String annotationType, + String className, + String extendsAnnotationType, + String extendsClassName, + List fieldSpecifications, + List methodSpecifications) + { + this.comments = comments; + this.requiredSetAccessFlags = requiredSetAccessFlags; + this.requiredUnsetAccessFlags = requiredUnsetAccessFlags; + this.annotationType = annotationType; + this.className = className; + this.extendsAnnotationType = extendsAnnotationType; + this.extendsClassName = extendsClassName; + this.fieldSpecifications = fieldSpecifications; + this.methodSpecifications = methodSpecifications; + } + + + /** + * Specifies to keep the specified field(s) of this option's class(es). + * + * @param fieldSpecification the field specification. + */ + public void addField(MemberSpecification fieldSpecification) + { + if (fieldSpecifications == null) + { + fieldSpecifications = new ArrayList(); + } + + fieldSpecifications.add(fieldSpecification); + } + + + /** + * Specifies to keep the specified method(s) of this option's class(es). + * + * @param methodSpecification the method specification. + */ + public void addMethod(MemberSpecification methodSpecification) + { + if (methodSpecifications == null) + { + methodSpecifications = new ArrayList(); + } + + methodSpecifications.add(methodSpecification); + } + + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + ClassSpecification other = (ClassSpecification)object; + return +// (this.comments == null ? other.comments == null : this.comments.equals(other.comments) ) && + (this.requiredSetAccessFlags == other.requiredSetAccessFlags ) && + (this.requiredUnsetAccessFlags == other.requiredUnsetAccessFlags ) && + (this.annotationType == null ? other.annotationType == null : this.annotationType.equals(other.annotationType) ) && + (this.className == null ? other.className == null : this.className.equals(other.className) ) && + (this.extendsAnnotationType == null ? other.extendsAnnotationType == null : this.extendsAnnotationType.equals(other.extendsAnnotationType)) && + (this.extendsClassName == null ? other.extendsClassName == null : this.extendsClassName.equals(other.extendsClassName) ) && + (this.fieldSpecifications == null ? other.fieldSpecifications == null : this.fieldSpecifications.equals(other.fieldSpecifications) ) && + (this.methodSpecifications == null ? other.methodSpecifications == null : this.methodSpecifications.equals(other.methodSpecifications) ); + } + + public int hashCode() + { + return +// (comments == null ? 0 : comments.hashCode() ) ^ + (requiredSetAccessFlags ) ^ + (requiredUnsetAccessFlags ) ^ + (annotationType == null ? 0 : annotationType.hashCode() ) ^ + (className == null ? 0 : className.hashCode() ) ^ + (extendsAnnotationType == null ? 0 : extendsAnnotationType.hashCode()) ^ + (extendsClassName == null ? 0 : extendsClassName.hashCode() ) ^ + (fieldSpecifications == null ? 0 : fieldSpecifications.hashCode() ) ^ + (methodSpecifications == null ? 0 : methodSpecifications.hashCode() ); + } + + public Object clone() + { + try + { + return super.clone(); + } + catch (CloneNotSupportedException e) + { + return null; + } + } +} diff --git a/src/proguard/ClassSpecificationVisitorFactory.java b/src/proguard/ClassSpecificationVisitorFactory.java new file mode 100644 index 0000000..c99ab2c --- /dev/null +++ b/src/proguard/ClassSpecificationVisitorFactory.java @@ -0,0 +1,502 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.AllAttributeVisitor; +import proguard.classfile.visitor.*; + +import java.util.List; + +/** + * This factory creates visitors to efficiently travel to specified classes and + * class members. + * + * @author Eric Lafortune + */ +public class ClassSpecificationVisitorFactory +{ + /** + * Constructs a ClassPoolVisitor to efficiently travel to the specified + * classes and class members. + * + * @param keepClassSpecifications the list of KeepClassSpecification + * instances, defining of the classes and + * class members to visit. + * @param classVisitor the ClassVisitor to be applied to matching + * classes. + * @param memberVisitor the MemberVisitor to be applied to matching + * class members. + */ + public static ClassPoolVisitor createClassPoolVisitor(List keepClassSpecifications, + ClassVisitor classVisitor, + MemberVisitor memberVisitor, + boolean shrinking, + boolean optimizing, + boolean obfuscating) + { + MultiClassPoolVisitor multiClassPoolVisitor = new MultiClassPoolVisitor(); + + if (keepClassSpecifications != null) + { + for (int index = 0; index < keepClassSpecifications.size(); index++) + { + KeepClassSpecification keepClassSpecification = + (KeepClassSpecification)keepClassSpecifications.get(index); + + if ((shrinking && !keepClassSpecification.allowShrinking) || + (optimizing && !keepClassSpecification.allowOptimization) || + (obfuscating && !keepClassSpecification.allowObfuscation)) + { + multiClassPoolVisitor.addClassPoolVisitor( + createClassPoolVisitor(keepClassSpecification, + classVisitor, + memberVisitor)); + } + } + } + + return multiClassPoolVisitor; + } + + + /** + * Constructs a ClassPoolVisitor to efficiently travel to the specified + * classes and class members. + * + * @param classSpecifications the list of ClassSpecification instances, + * defining of the classes and class members to + * visit. + * @param classVisitor the ClassVisitor to be applied to matching + * classes. + * @param memberVisitor the MemberVisitor to be applied to matching + * class members. + */ + public static ClassPoolVisitor createClassPoolVisitor(List classSpecifications, + ClassVisitor classVisitor, + MemberVisitor memberVisitor) + { + MultiClassPoolVisitor multiClassPoolVisitor = new MultiClassPoolVisitor(); + + if (classSpecifications != null) + { + for (int index = 0; index < classSpecifications.size(); index++) + { + ClassSpecification classSpecification = + (ClassSpecification)classSpecifications.get(index); + + multiClassPoolVisitor.addClassPoolVisitor( + createClassPoolVisitor(classSpecification, + classVisitor, + memberVisitor)); + } + } + + return multiClassPoolVisitor; + } + + + /** + * Constructs a ClassPoolVisitor to efficiently travel to the specified + * classes and class members. + * + * @param keepClassSpecification the specifications of the class(es) and class + * members to visit. + * @param classVisitor the ClassVisitor to be applied to matching + * classes. + * @param memberVisitor the MemberVisitor to be applied to matching + * class members. + */ + private static ClassPoolVisitor createClassPoolVisitor(KeepClassSpecification keepClassSpecification, + ClassVisitor classVisitor, + MemberVisitor memberVisitor) + { + // Don't visit the classes if not specified. + if (!keepClassSpecification.markClasses && + !keepClassSpecification.markConditionally) + { + classVisitor = null; + } + + // If specified, let the marker visit the class and its class + // members conditionally. + if (keepClassSpecification.markConditionally) + { + // Combine both visitors. + ClassVisitor composedClassVisitor = + createCombinedClassVisitor(keepClassSpecification, + classVisitor, + memberVisitor); + + // Replace the class visitor. + classVisitor = + createClassMemberTester(keepClassSpecification, + composedClassVisitor); + + // Discard the member visitor, because it has already been included. + memberVisitor = null; + } + + return createClassPoolVisitor((ClassSpecification)keepClassSpecification, + classVisitor, + memberVisitor); + } + + + /** + * Constructs a ClassPoolVisitor to efficiently travel to the specified + * classes and class members. + * + * @param classSpecification the specifications of the class(es) and class + * members to visit. + * @param classVisitor the ClassVisitor to be applied to matching + * classes. + * @param memberVisitor the MemberVisitor to be applied to matching + * class members. + */ + private static ClassPoolVisitor createClassPoolVisitor(ClassSpecification classSpecification, + ClassVisitor classVisitor, + MemberVisitor memberVisitor) + { + // Combine both visitors. + ClassVisitor composedClassVisitor = + createCombinedClassVisitor(classSpecification, + classVisitor, + memberVisitor); + + // By default, start visiting from the named class name, if specified. + String className = classSpecification.className; + + // Although we may have to start from the extended class. + String extendsAnnotationType = classSpecification.extendsAnnotationType; + String extendsClassName = classSpecification.extendsClassName; + + // If wildcarded, only visit classes with matching names. + if (className != null && + (extendsAnnotationType != null || + extendsClassName != null || + containsWildCards(className))) + { + composedClassVisitor = + new ClassNameFilter(className, composedClassVisitor); + + // We'll have to visit all classes now. + className = null; + } + + // If specified, only visit classes with the right annotation. + String annotationType = classSpecification.annotationType; + + if (annotationType != null) + { + composedClassVisitor = + new AllAttributeVisitor( + new AllAnnotationVisitor( + new AnnotationTypeFilter(annotationType, + new AnnotatedClassVisitor(composedClassVisitor)))); + } + + // If specified, only visit classes with the right access flags. + if (classSpecification.requiredSetAccessFlags != 0 || + classSpecification.requiredUnsetAccessFlags != 0) + { + composedClassVisitor = + new ClassAccessFilter(classSpecification.requiredSetAccessFlags, + classSpecification.requiredUnsetAccessFlags, + composedClassVisitor); + } + + // If it's specified, start visiting from the extended class. + if (extendsAnnotationType != null || + extendsClassName != null) + { + // Start visiting from the extended class. + composedClassVisitor = + new ClassHierarchyTraveler(false, false, false, true, + composedClassVisitor); + + // If specified, only visit extended classes with the right annotation. + if (extendsAnnotationType != null) + { + composedClassVisitor = + new AllAttributeVisitor( + new AllAnnotationVisitor( + new AnnotationTypeFilter(extendsAnnotationType, + new AnnotatedClassVisitor(composedClassVisitor)))); + } + + // If specified, only visit extended classes with matching names. + if (extendsClassName != null) + { + // If wildcarded, only visit extended classes with matching names. + if (containsWildCards(extendsClassName)) + { + composedClassVisitor = + new ClassNameFilter(extendsClassName, + composedClassVisitor); + } + else + { + // Start visiting from the named extended class. + className = extendsClassName; + } + } + } + + // If specified, visit a single named class, otherwise visit all classes. + return className != null ? + (ClassPoolVisitor)new NamedClassVisitor(composedClassVisitor, className) : + (ClassPoolVisitor)new AllClassVisitor(composedClassVisitor); + } + + + /** + * Constructs a ClassVisitor to efficiently travel to the specified + * classes and class members. + * + * @param classSpecification the specifications of the class(es) and class + * members to visit. + * @param classVisitor the ClassVisitor to be applied to matching + * classes. + * @param memberVisitor the MemberVisitor to be applied to matching + * class members. + */ + private static ClassVisitor createCombinedClassVisitor(ClassSpecification classSpecification, + ClassVisitor classVisitor, + MemberVisitor memberVisitor) + { + // Don't visit any members if there aren't any member specifications. + if (classSpecification.fieldSpecifications == null && + classSpecification.methodSpecifications == null) + { + memberVisitor = null; + } + + // The class visitor for classes and their members. + MultiClassVisitor multiClassVisitor = new MultiClassVisitor(); + + // If specified, let the class visitor visit the class itself. + if (classVisitor != null) + { + // This class visitor may be the only one. + if (memberVisitor == null) + { + return classVisitor; + } + + multiClassVisitor.addClassVisitor(classVisitor); + } + + // If specified, let the member info visitor visit the class members. + if (memberVisitor != null) + { + ClassVisitor memberClassVisitor = + createClassVisitor(classSpecification, memberVisitor); + + // This class visitor may be the only one. + if (classVisitor == null) + { + return memberClassVisitor; + } + + multiClassVisitor.addClassVisitor(memberClassVisitor); + } + + return multiClassVisitor; + } + + + /** + * Constructs a ClassVisitor to efficiently travel to the specified class + * members. + * + * @param classSpecification the specifications of the class members to visit. + * @param memberVisitor the MemberVisitor to be applied to matching + * class members. + */ + private static ClassVisitor createClassVisitor(ClassSpecification classSpecification, + MemberVisitor memberVisitor) + { + MultiClassVisitor multiClassVisitor = new MultiClassVisitor(); + + addMemberVisitors(classSpecification.fieldSpecifications, true, multiClassVisitor, memberVisitor); + addMemberVisitors(classSpecification.methodSpecifications, false, multiClassVisitor, memberVisitor); + + // Mark the class member in this class and in super classes. + return new ClassHierarchyTraveler(true, true, false, false, + multiClassVisitor); + } + + + /** + * Adds elements to the given MultiClassVisitor, to apply the given + * MemberVisitor to all class members that match the given List + * of options (of the given type). + */ + private static void addMemberVisitors(List memberSpecifications, + boolean isField, + MultiClassVisitor multiClassVisitor, + MemberVisitor memberVisitor) + { + if (memberSpecifications != null) + { + for (int index = 0; index < memberSpecifications.size(); index++) + { + MemberSpecification memberSpecification = + (MemberSpecification)memberSpecifications.get(index); + + multiClassVisitor.addClassVisitor( + createClassVisitor(memberSpecification, + isField, + memberVisitor)); + } + } + } + + + /** + * Constructs a ClassVisitor that conditionally applies the given + * ClassVisitor to all classes that contain the given class members. + */ + private static ClassVisitor createClassMemberTester(ClassSpecification classSpecification, + ClassVisitor classVisitor) + { + // Create a linked list of conditional visitors, for fields and for + // methods. + return createClassMemberTester(classSpecification.fieldSpecifications, + true, + createClassMemberTester(classSpecification.methodSpecifications, + false, + classVisitor)); + } + + + /** + * Constructs a ClassVisitor that conditionally applies the given + * ClassVisitor to all classes that contain the given List of class + * members (of the given type). + */ + private static ClassVisitor createClassMemberTester(List memberSpecifications, + boolean isField, + ClassVisitor classVisitor) + { + // Create a linked list of conditional visitors. + if (memberSpecifications != null) + { + for (int index = 0; index < memberSpecifications.size(); index++) + { + MemberSpecification memberSpecification = + (MemberSpecification)memberSpecifications.get(index); + + classVisitor = + createClassVisitor(memberSpecification, + isField, + new MemberToClassVisitor(classVisitor)); + } + } + + return classVisitor; + } + + + /** + * Creates a new ClassVisitor to efficiently travel to the specified class + * members. + * + * @param memberSpecification the specification of the class member(s) to + * visit. + * @param memberVisitor the MemberVisitor to be applied to matching + * class member(s). + */ + private static ClassVisitor createClassVisitor(MemberSpecification memberSpecification, + boolean isField, + MemberVisitor memberVisitor) + { + String name = memberSpecification.name; + String descriptor = memberSpecification.descriptor; + + // If name or descriptor are not fully specified, only visit matching + // class members. + boolean fullySpecified = + name != null && + descriptor != null && + !containsWildCards(name) && + !containsWildCards(descriptor); + + if (!fullySpecified) + { + if (descriptor != null) + { + memberVisitor = + new MemberDescriptorFilter(descriptor, memberVisitor); + } + + if (name != null) + { + memberVisitor = + new MemberNameFilter(name, memberVisitor); + } + } + + // If specified, only visit class members with the right annotation. + if (memberSpecification.annotationType != null) + { + memberVisitor = + new AllAttributeVisitor( + new AllAnnotationVisitor( + new AnnotationTypeFilter(memberSpecification.annotationType, + new AnnotationToMemberVisitor(memberVisitor)))); + } + + // If any access flags are specified, only visit matching class members. + if (memberSpecification.requiredSetAccessFlags != 0 || + memberSpecification.requiredUnsetAccessFlags != 0) + { + memberVisitor = + new MemberAccessFilter(memberSpecification.requiredSetAccessFlags, + memberSpecification.requiredUnsetAccessFlags, + memberVisitor); + } + + // Depending on what's specified, visit a single named class member, + // or all class members, filtering the matching ones. + return isField ? + fullySpecified ? + (ClassVisitor)new NamedFieldVisitor(name, descriptor, memberVisitor) : + (ClassVisitor)new AllFieldVisitor(memberVisitor) : + fullySpecified ? + (ClassVisitor)new NamedMethodVisitor(name, descriptor, memberVisitor) : + (ClassVisitor)new AllMethodVisitor(memberVisitor); + } + + + // Small utility methods. + + private static boolean containsWildCards(String string) + { + return string != null && + (string.indexOf('*') >= 0 || + string.indexOf('?') >= 0 || + string.indexOf('%') >= 0 || + string.indexOf(',') >= 0 || + string.indexOf("///") >= 0); + } +} diff --git a/src/proguard/Configuration.java b/src/proguard/Configuration.java new file mode 100644 index 0000000..d513e2c --- /dev/null +++ b/src/proguard/Configuration.java @@ -0,0 +1,321 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.File; +import java.util.List; + +/** + * The ProGuard configuration. + * + * @see ProGuard + * + * @author Eric Lafortune + */ +public class Configuration +{ + /////////////////////////////////////////////////////////////////////////// + // Input and output options. + /////////////////////////////////////////////////////////////////////////// + + /** + * A list of input and output entries (jars, wars, ears, zips, and directories). + */ + public ClassPath programJars; + + /** + * A list of library entries (jars, wars, ears, zips, and directories). + */ + public ClassPath libraryJars; + + /** + * Specifies whether to skip non-public library classes while reading + * library jars. + */ + public boolean skipNonPublicLibraryClasses = true; + + /** + * Specifies whether to skip non-public library class members while reading + * library classes. + */ + public boolean skipNonPublicLibraryClassMembers = true; + + /** + * A list of Strings specifying directories to be kept in + * the output directories or the output jars. A null list + * means no directories. An empty list means all directories. The directory + * names may contain "**", "*", or "?" wildcards, and they may be preceded + * by the "!" negator. + */ + public List keepDirectories; + + /** + * Specifies the version number of the output classes, or 0 if the version + * number can be left unchanged. + */ + public int targetClassVersion; + + /** + * Specifies the last modification time of this configuration. This time + * is necessary to check whether the input has to be processed. Setting it + * to Long.MAX_VALUE forces processing, even if the modification times + * of the output appear more recent than the modification times of the + * input. + */ + public long lastModified = 0L; + + /////////////////////////////////////////////////////////////////////////// + // Keep options. + /////////////////////////////////////////////////////////////////////////// + + /** + * A list of {@link KeepClassSpecification} instances, whose class names and + * class member names are to be kept from shrinking, optimization, and/or + * obfuscation. + */ + public List keep; + + /** + * An optional output file for listing the kept seeds. + * An empty file name means the standard output. + */ + public File printSeeds; + + /////////////////////////////////////////////////////////////////////////// + // Shrinking options. + /////////////////////////////////////////////////////////////////////////// + + /** + * Specifies whether the code should be shrunk. + */ + public boolean shrink = true; + + /** + * An optional output file for listing the unused classes and class + * members. An empty file name means the standard output. + */ + public File printUsage; + + /** + * A list of {@link ClassSpecification} instances, for which an explanation + * is to be printed, why they are kept in the shrinking step. + */ + public List whyAreYouKeeping; + + /////////////////////////////////////////////////////////////////////////// + // Optimization options. + /////////////////////////////////////////////////////////////////////////// + + /** + * Specifies whether the code should be optimized. + */ + public boolean optimize = true; + + /** + * A list of Strings specifying the optimizations to be + * performed. A null list means all optimizations. The + * optimization names may contain "*" or "?" wildcards, and they may + * be preceded by the "!" negator. + */ + public List optimizations; + + /** + * Specifies the number of optimization passes. + */ + public int optimizationPasses = 1; + + /** + * A list of {@link ClassSpecification} instances, whose methods are + * assumed to have no side effects. + */ + public List assumeNoSideEffects; + + /** + * Specifies whether the access of class members can be modified. + */ + public boolean allowAccessModification = false; + + /** + * Specifies whether interfaces may be merged aggressively. + */ + public boolean mergeInterfacesAggressively = false; + + /////////////////////////////////////////////////////////////////////////// + // Obfuscation options. + /////////////////////////////////////////////////////////////////////////// + + /** + * Specifies whether the code should be obfuscated. + */ + public boolean obfuscate = true; + + /** + * An optional output file for listing the obfuscation mapping. + * An empty file name means the standard output. + */ + public File printMapping; + + /** + * An optional input file for reading an obfuscation mapping. + */ + public File applyMapping; + + /** + * An optional name of a file containing obfuscated class member names. + */ + public File obfuscationDictionary; + + /** + * An optional name of a file containing obfuscated class names. + */ + public File classObfuscationDictionary; + + /** + * An optional name of a file containing obfuscated package names. + */ + public File packageObfuscationDictionary; + + /** + * Specifies whether to apply aggressive name overloading on class members. + */ + public boolean overloadAggressively = false; + + /** + * Specifies whether to generate globally unique class member names. + */ + public boolean useUniqueClassMemberNames = false; + + /** + * Specifies whether obfuscated packages and classes can get mixed-case names. + */ + public boolean useMixedCaseClassNames = true; + + /** + * A list of Strings specifying package names to be kept. + * A null list means no names. An empty list means all + * names. The package names may contain "**", "*", or "?" wildcards, and + * they may be preceded by the "!" negator. + */ + public List keepPackageNames; + + /** + * An optional base package if the obfuscated package hierarchy is to be + * flattened, null otherwise. + */ + public String flattenPackageHierarchy; + + /** + * An optional base package if the obfuscated classes are to be repackaged + * into a single package, null otherwise. + */ + public String repackageClasses; + + /** + * A list of Strings specifying optional attributes to be kept. + * A null list means no attributes. An empty list means all + * attributes. The attribute names may contain "*" or "?" wildcards, and + * they may be preceded by the "!" negator. + */ + public List keepAttributes; + + /** + * An optional replacement for all SourceFile attributes. + */ + public String newSourceFileAttribute; + + /** + * A list of Strings specifying a filter for clases whose + * string constants are to be adapted, based on corresponding obfuscated + * class names. + */ + public List adaptClassStrings; + + /** + * A list of Strings specifying a filter for files whose + * names are to be adapted, based on corresponding obfuscated class names. + */ + public List adaptResourceFileNames; + + /** + * A list of Strings specifying a filter for files whose + * contents are to be adapted, based on obfuscated class names. + */ + public List adaptResourceFileContents; + + /////////////////////////////////////////////////////////////////////////// + // Preverification options. + /////////////////////////////////////////////////////////////////////////// + + /** + * Specifies whether the code should be preverified. + */ + public boolean preverify = true; + + /** + * Specifies whether the code should be preverified for Java Micro Edition + * (creating StackMap attributes) instead of for Java Standard Edition + * (creating StackMapTable attributes). + */ + public boolean microEdition = false; + + /////////////////////////////////////////////////////////////////////////// + // General options. + /////////////////////////////////////////////////////////////////////////// + + /** + * Specifies whether to print verbose messages. + */ + public boolean verbose = false; + + /** + * A list of Strings specifying a filter for the classes for + * which not to print notes, if there are noteworthy potential problems. + * A null list means all classes. The class names may contain + * "**", "*", or "?" wildcards, and they may be preceded by the "!" negator. + */ + public List note = null; + + /** + * A list of Strings specifying a filter for the classes for + * which not to print warnings, if there are any problems. + * A null list means all classes. The class names may contain + * "**", "*", or "?" wildcards, and they may be preceded by the "!" negator. + */ + public List warn = null; + + /** + * Specifies whether to ignore any warnings. + */ + public boolean ignoreWarnings = false; + + /** + * An optional output file for printing out the configuration that ProGuard + * is using (with included files and replaced variables). + * An empty file name means the standard output. + */ + public File printConfiguration; + + /** + * An optional output file for printing out the processed code in a more + * or less readable form. An empty file name means the standard output. + */ + public File dump; +} diff --git a/src/proguard/ConfigurationConstants.java b/src/proguard/ConfigurationConstants.java new file mode 100644 index 0000000..694e006 --- /dev/null +++ b/src/proguard/ConfigurationConstants.java @@ -0,0 +1,121 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +/** + * This class provides constants for parsing and writing ProGuard configurations. + * + * @author Eric Lafortune + */ +class ConfigurationConstants +{ + public static final String OPTION_PREFIX = "-"; + public static final String AT_DIRECTIVE = "@"; + public static final String INCLUDE_DIRECTIVE = "-include"; + public static final String BASE_DIRECTORY_DIRECTIVE = "-basedirectory"; + + public static final String INJARS_OPTION = "-injars"; + public static final String OUTJARS_OPTION = "-outjars"; + public static final String LIBRARYJARS_OPTION = "-libraryjars"; + public static final String RESOURCEJARS_OPTION = "-resourcejars"; + + public static final String KEEP_OPTION = "-keep"; + public static final String KEEP_CLASS_MEMBERS_OPTION = "-keepclassmembers"; + public static final String KEEP_CLASSES_WITH_MEMBERS_OPTION = "-keepclasseswithmembers"; + public static final String KEEP_NAMES_OPTION = "-keepnames"; + public static final String KEEP_CLASS_MEMBER_NAMES_OPTION = "-keepclassmembernames"; + public static final String KEEP_CLASSES_WITH_MEMBER_NAMES_OPTION = "-keepclasseswithmembernames"; + public static final String ALLOW_SHRINKING_SUBOPTION = "allowshrinking"; + public static final String ALLOW_OPTIMIZATION_SUBOPTION = "allowoptimization"; + public static final String ALLOW_OBFUSCATION_SUBOPTION = "allowobfuscation"; + public static final String PRINT_SEEDS_OPTION = "-printseeds"; + + public static final String DONT_SHRINK_OPTION = "-dontshrink"; + public static final String PRINT_USAGE_OPTION = "-printusage"; + public static final String WHY_ARE_YOU_KEEPING_OPTION = "-whyareyoukeeping"; + + public static final String DONT_OPTIMIZE_OPTION = "-dontoptimize"; + public static final String OPTIMIZATIONS = "-optimizations"; + public static final String OPTIMIZATION_PASSES = "-optimizationpasses"; + public static final String ASSUME_NO_SIDE_EFFECTS_OPTION = "-assumenosideeffects"; + public static final String ALLOW_ACCESS_MODIFICATION_OPTION = "-allowaccessmodification"; + public static final String MERGE_INTERFACES_AGGRESSIVELY_OPTION = "-mergeinterfacesaggressively"; + + public static final String DONT_OBFUSCATE_OPTION = "-dontobfuscate"; + public static final String PRINT_MAPPING_OPTION = "-printmapping"; + public static final String APPLY_MAPPING_OPTION = "-applymapping"; + public static final String OBFUSCATION_DICTIONARY_OPTION = "-obfuscationdictionary"; + public static final String CLASS_OBFUSCATION_DICTIONARY_OPTION = "-classobfuscationdictionary"; + public static final String PACKAGE_OBFUSCATION_DICTIONARY_OPTION = "-packageobfuscationdictionary"; + public static final String OVERLOAD_AGGRESSIVELY_OPTION = "-overloadaggressively"; + public static final String USE_UNIQUE_CLASS_MEMBER_NAMES_OPTION = "-useuniqueclassmembernames"; + public static final String DONT_USE_MIXED_CASE_CLASS_NAMES_OPTION = "-dontusemixedcaseclassnames"; + public static final String KEEP_PACKAGE_NAMES_OPTION = "-keeppackagenames"; + public static final String FLATTEN_PACKAGE_HIERARCHY_OPTION = "-flattenpackagehierarchy"; + public static final String REPACKAGE_CLASSES_OPTION = "-repackageclasses"; + public static final String DEFAULT_PACKAGE_OPTION = "-defaultpackage"; + public static final String KEEP_ATTRIBUTES_OPTION = "-keepattributes"; + public static final String RENAME_SOURCE_FILE_ATTRIBUTE_OPTION = "-renamesourcefileattribute"; + public static final String ADAPT_CLASS_STRINGS_OPTION = "-adaptclassstrings"; + public static final String ADAPT_RESOURCE_FILE_NAMES_OPTION = "-adaptresourcefilenames"; + public static final String ADAPT_RESOURCE_FILE_CONTENTS_OPTION = "-adaptresourcefilecontents"; + + public static final String DONT_PREVERIFY_OPTION = "-dontpreverify"; + public static final String MICRO_EDITION_OPTION = "-microedition"; + + public static final String VERBOSE_OPTION = "-verbose"; + public static final String DONT_NOTE_OPTION = "-dontnote"; + public static final String DONT_WARN_OPTION = "-dontwarn"; + public static final String IGNORE_WARNINGS_OPTION = "-ignorewarnings"; + public static final String PRINT_CONFIGURATION_OPTION = "-printconfiguration"; + public static final String DUMP_OPTION = "-dump"; + public static final String DONT_SKIP_NON_PUBLIC_LIBRARY_CLASSES_OPTION = "-dontskipnonpubliclibraryclasses"; + public static final String DONT_SKIP_NON_PUBLIC_LIBRARY_CLASS_MEMBERS_OPTION = "-dontskipnonpubliclibraryclassmembers"; + public static final String TARGET_OPTION = "-target"; + public static final String KEEP_DIRECTORIES_OPTION = "-keepdirectories"; + public static final String FORCE_PROCESSING_OPTION = "-forceprocessing"; + + public static final String ANY_ATTRIBUTE_KEYWORD = "*"; + public static final String ATTRIBUTE_SEPARATOR_KEYWORD = ","; + + public static final String JAR_SEPARATOR_KEYWORD = System.getProperty("path.separator"); + + public static final char OPEN_SYSTEM_PROPERTY = '<'; + public static final char CLOSE_SYSTEM_PROPERTY = '>'; + + public static final String ANNOTATION_KEYWORD = "@"; + public static final String NEGATOR_KEYWORD = "!"; + public static final String CLASS_KEYWORD = "class"; + public static final String ANY_CLASS_KEYWORD = "*"; + public static final String ANY_TYPE_KEYWORD = "***"; + public static final String IMPLEMENTS_KEYWORD = "implements"; + public static final String EXTENDS_KEYWORD = "extends"; + public static final String OPEN_KEYWORD = "{"; + public static final String ANY_CLASS_MEMBER_KEYWORD = "*"; + public static final String ANY_FIELD_KEYWORD = ""; + public static final String ANY_METHOD_KEYWORD = ""; + public static final String OPEN_ARGUMENTS_KEYWORD = "("; + public static final String ARGUMENT_SEPARATOR_KEYWORD = ","; + public static final String ANY_ARGUMENTS_KEYWORD = "..."; + public static final String CLOSE_ARGUMENTS_KEYWORD = ")"; + public static final String SEPARATOR_KEYWORD = ";"; + public static final String CLOSE_KEYWORD = "}"; +} diff --git a/src/proguard/ConfigurationParser.java b/src/proguard/ConfigurationParser.java new file mode 100644 index 0000000..e01809e --- /dev/null +++ b/src/proguard/ConfigurationParser.java @@ -0,0 +1,1257 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; +import proguard.util.ListUtil; + +import java.io.*; +import java.net.URL; +import java.util.*; + + +/** + * This class parses ProGuard configurations. Configurations can be read from an + * array of arguments or from a configuration file or URL. + * + * @author Eric Lafortune + */ +public class ConfigurationParser +{ + private WordReader reader; + private String nextWord; + private String lastComments; + + + /** + * Creates a new ConfigurationParser for the given String arguments. + */ + public ConfigurationParser(String[] args) throws IOException + { + this(args, null); + } + + + /** + * Creates a new ConfigurationParser for the given String arguments, + * with the given base directory. + */ + public ConfigurationParser(String[] args, + File baseDir) throws IOException + { + reader = new ArgumentWordReader(args, baseDir); + + readNextWord(); + } + + + /** + * Creates a new ConfigurationParser for the given file. + */ + public ConfigurationParser(File file) throws IOException + { + reader = new FileWordReader(file); + + readNextWord(); + } + + + /** + * Creates a new ConfigurationParser for the given URL. + */ + public ConfigurationParser(URL url) throws IOException + { + reader = new FileWordReader(url); + + readNextWord(); + } + + + /** + * Parses and returns the configuration. + * @param configuration the configuration that is updated as a side-effect. + * @throws ParseException if the any of the configuration settings contains + * a syntax error. + * @throws IOException if an IO error occurs while reading a configuration. + */ + public void parse(Configuration configuration) + throws ParseException, IOException + { + while (nextWord != null) + { + lastComments = reader.lastComments(); + + // First include directives. + if (ConfigurationConstants.AT_DIRECTIVE .startsWith(nextWord) || + ConfigurationConstants.INCLUDE_DIRECTIVE .startsWith(nextWord)) configuration.lastModified = parseIncludeArgument(configuration.lastModified); + else if (ConfigurationConstants.BASE_DIRECTORY_DIRECTIVE .startsWith(nextWord)) parseBaseDirectoryArgument(); + + // Then configuration options with or without arguments. + else if (ConfigurationConstants.INJARS_OPTION .startsWith(nextWord)) configuration.programJars = parseClassPathArgument(configuration.programJars, false); + else if (ConfigurationConstants.OUTJARS_OPTION .startsWith(nextWord)) configuration.programJars = parseClassPathArgument(configuration.programJars, true); + else if (ConfigurationConstants.LIBRARYJARS_OPTION .startsWith(nextWord)) configuration.libraryJars = parseClassPathArgument(configuration.libraryJars, false); + else if (ConfigurationConstants.RESOURCEJARS_OPTION .startsWith(nextWord)) throw new ParseException("The '-resourcejars' option is no longer supported. Please use the '-injars' option for all input"); + else if (ConfigurationConstants.DONT_SKIP_NON_PUBLIC_LIBRARY_CLASSES_OPTION .startsWith(nextWord)) configuration.skipNonPublicLibraryClasses = parseNoArgument(false); + else if (ConfigurationConstants.DONT_SKIP_NON_PUBLIC_LIBRARY_CLASS_MEMBERS_OPTION.startsWith(nextWord)) configuration.skipNonPublicLibraryClassMembers = parseNoArgument(false); + else if (ConfigurationConstants.TARGET_OPTION .startsWith(nextWord)) configuration.targetClassVersion = parseClassVersion(); + else if (ConfigurationConstants.FORCE_PROCESSING_OPTION .startsWith(nextWord)) configuration.lastModified = parseNoArgument(Long.MAX_VALUE); + + else if (ConfigurationConstants.KEEP_OPTION .startsWith(nextWord)) configuration.keep = parseKeepClassSpecificationArguments(configuration.keep, true, false, false); + else if (ConfigurationConstants.KEEP_CLASS_MEMBERS_OPTION .startsWith(nextWord)) configuration.keep = parseKeepClassSpecificationArguments(configuration.keep, false, false, false); + else if (ConfigurationConstants.KEEP_CLASSES_WITH_MEMBERS_OPTION .startsWith(nextWord)) configuration.keep = parseKeepClassSpecificationArguments(configuration.keep, false, true, false); + else if (ConfigurationConstants.KEEP_NAMES_OPTION .startsWith(nextWord)) configuration.keep = parseKeepClassSpecificationArguments(configuration.keep, true, false, true); + else if (ConfigurationConstants.KEEP_CLASS_MEMBER_NAMES_OPTION .startsWith(nextWord)) configuration.keep = parseKeepClassSpecificationArguments(configuration.keep, false, false, true); + else if (ConfigurationConstants.KEEP_CLASSES_WITH_MEMBER_NAMES_OPTION .startsWith(nextWord)) configuration.keep = parseKeepClassSpecificationArguments(configuration.keep, false, true, true); + else if (ConfigurationConstants.PRINT_SEEDS_OPTION .startsWith(nextWord)) configuration.printSeeds = parseOptionalFile(); + + // After '-keep'. + else if (ConfigurationConstants.KEEP_DIRECTORIES_OPTION .startsWith(nextWord)) configuration.keepDirectories = parseCommaSeparatedList("directory name", true, true, false, false, true, false, false, configuration.keepDirectories); + + else if (ConfigurationConstants.DONT_SHRINK_OPTION .startsWith(nextWord)) configuration.shrink = parseNoArgument(false); + else if (ConfigurationConstants.PRINT_USAGE_OPTION .startsWith(nextWord)) configuration.printUsage = parseOptionalFile(); + else if (ConfigurationConstants.WHY_ARE_YOU_KEEPING_OPTION .startsWith(nextWord)) configuration.whyAreYouKeeping = parseClassSpecificationArguments(configuration.whyAreYouKeeping); + + else if (ConfigurationConstants.DONT_OPTIMIZE_OPTION .startsWith(nextWord)) configuration.optimize = parseNoArgument(false); + else if (ConfigurationConstants.OPTIMIZATION_PASSES .startsWith(nextWord)) configuration.optimizationPasses = parseIntegerArgument(); + else if (ConfigurationConstants.OPTIMIZATIONS .startsWith(nextWord)) configuration.optimizations = parseCommaSeparatedList("optimization name", true, false, false, false, false, false, false, configuration.optimizations); + else if (ConfigurationConstants.ASSUME_NO_SIDE_EFFECTS_OPTION .startsWith(nextWord)) configuration.assumeNoSideEffects = parseClassSpecificationArguments(configuration.assumeNoSideEffects); + else if (ConfigurationConstants.ALLOW_ACCESS_MODIFICATION_OPTION .startsWith(nextWord)) configuration.allowAccessModification = parseNoArgument(true); + else if (ConfigurationConstants.MERGE_INTERFACES_AGGRESSIVELY_OPTION .startsWith(nextWord)) configuration.mergeInterfacesAggressively = parseNoArgument(true); + + else if (ConfigurationConstants.DONT_OBFUSCATE_OPTION .startsWith(nextWord)) configuration.obfuscate = parseNoArgument(false); + else if (ConfigurationConstants.PRINT_MAPPING_OPTION .startsWith(nextWord)) configuration.printMapping = parseOptionalFile(); + else if (ConfigurationConstants.APPLY_MAPPING_OPTION .startsWith(nextWord)) configuration.applyMapping = parseFile(); + else if (ConfigurationConstants.OBFUSCATION_DICTIONARY_OPTION .startsWith(nextWord)) configuration.obfuscationDictionary = parseFile(); + else if (ConfigurationConstants.CLASS_OBFUSCATION_DICTIONARY_OPTION .startsWith(nextWord)) configuration.classObfuscationDictionary = parseFile(); + else if (ConfigurationConstants.PACKAGE_OBFUSCATION_DICTIONARY_OPTION .startsWith(nextWord)) configuration.packageObfuscationDictionary = parseFile(); + else if (ConfigurationConstants.OVERLOAD_AGGRESSIVELY_OPTION .startsWith(nextWord)) configuration.overloadAggressively = parseNoArgument(true); + else if (ConfigurationConstants.USE_UNIQUE_CLASS_MEMBER_NAMES_OPTION .startsWith(nextWord)) configuration.useUniqueClassMemberNames = parseNoArgument(true); + else if (ConfigurationConstants.DONT_USE_MIXED_CASE_CLASS_NAMES_OPTION .startsWith(nextWord)) configuration.useMixedCaseClassNames = parseNoArgument(false); + else if (ConfigurationConstants.KEEP_PACKAGE_NAMES_OPTION .startsWith(nextWord)) configuration.keepPackageNames = parseCommaSeparatedList("package name", true, true, false, true, false, true, false, configuration.keepPackageNames); + else if (ConfigurationConstants.FLATTEN_PACKAGE_HIERARCHY_OPTION .startsWith(nextWord)) configuration.flattenPackageHierarchy = ClassUtil.internalClassName(parseOptionalArgument()); + else if (ConfigurationConstants.REPACKAGE_CLASSES_OPTION .startsWith(nextWord)) configuration.repackageClasses = ClassUtil.internalClassName(parseOptionalArgument()); + else if (ConfigurationConstants.DEFAULT_PACKAGE_OPTION .startsWith(nextWord)) configuration.repackageClasses = ClassUtil.internalClassName(parseOptionalArgument()); + else if (ConfigurationConstants.KEEP_ATTRIBUTES_OPTION .startsWith(nextWord)) configuration.keepAttributes = parseCommaSeparatedList("attribute name", true, true, false, true, false, false, false, configuration.keepAttributes); + else if (ConfigurationConstants.RENAME_SOURCE_FILE_ATTRIBUTE_OPTION .startsWith(nextWord)) configuration.newSourceFileAttribute = parseOptionalArgument(); + else if (ConfigurationConstants.ADAPT_CLASS_STRINGS_OPTION .startsWith(nextWord)) configuration.adaptClassStrings = parseCommaSeparatedList("class name", true, true, false, true, false, true, false, configuration.adaptClassStrings); + else if (ConfigurationConstants.ADAPT_RESOURCE_FILE_NAMES_OPTION .startsWith(nextWord)) configuration.adaptResourceFileNames = parseCommaSeparatedList("resource file name", true, true, false, false, false, false, false, configuration.adaptResourceFileNames); + else if (ConfigurationConstants.ADAPT_RESOURCE_FILE_CONTENTS_OPTION .startsWith(nextWord)) configuration.adaptResourceFileContents = parseCommaSeparatedList("resource file name", true, true, false, false, false, false, false, configuration.adaptResourceFileContents); + + else if (ConfigurationConstants.DONT_PREVERIFY_OPTION .startsWith(nextWord)) configuration.preverify = parseNoArgument(false); + else if (ConfigurationConstants.MICRO_EDITION_OPTION .startsWith(nextWord)) configuration.microEdition = parseNoArgument(true); + + else if (ConfigurationConstants.VERBOSE_OPTION .startsWith(nextWord)) configuration.verbose = parseNoArgument(true); + else if (ConfigurationConstants.DONT_NOTE_OPTION .startsWith(nextWord)) configuration.note = parseCommaSeparatedList("class name", true, true, false, true, false, true, false, configuration.note); + else if (ConfigurationConstants.DONT_WARN_OPTION .startsWith(nextWord)) configuration.warn = parseCommaSeparatedList("class name", true, true, false, true, false, true, false, configuration.warn); + else if (ConfigurationConstants.IGNORE_WARNINGS_OPTION .startsWith(nextWord)) configuration.ignoreWarnings = parseNoArgument(true); + else if (ConfigurationConstants.PRINT_CONFIGURATION_OPTION .startsWith(nextWord)) configuration.printConfiguration = parseOptionalFile(); + else if (ConfigurationConstants.DUMP_OPTION .startsWith(nextWord)) configuration.dump = parseOptionalFile(); + else + { + throw new ParseException("Unknown option " + reader.locationDescription()); + } + } + } + + + + /** + * Closes the configuration. + * @throws IOException if an IO error occurs while closing the configuration. + */ + public void close() throws IOException + { + if (reader != null) + { + reader.close(); + } + } + + + private long parseIncludeArgument(long lastModified) throws ParseException, IOException + { + // Read the configuation file name. + readNextWord("configuration file name"); + + File file = file(nextWord); + reader.includeWordReader(new FileWordReader(file)); + + readNextWord(); + + return Math.max(lastModified, file.lastModified()); + } + + + private void parseBaseDirectoryArgument() throws ParseException, IOException + { + // Read the base directory name. + readNextWord("base directory name"); + + reader.setBaseDir(file(nextWord)); + + readNextWord(); + } + + + private ClassPath parseClassPathArgument(ClassPath classPath, + boolean isOutput) + throws ParseException, IOException + { + // Create a new List if necessary. + if (classPath == null) + { + classPath = new ClassPath(); + } + + while (true) + { + // Read the next jar name. + readNextWord("jar or directory name"); + + // Create a new class path entry. + ClassPathEntry entry = new ClassPathEntry(file(nextWord), isOutput); + + // Read the opening parenthesis or the separator, if any. + readNextWord(); + + // Read the optional filters. + if (!configurationEnd() && + ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD.equals(nextWord)) + { + // Read all filters in an array. + List[] filters = new List[5]; + + int counter = 0; + do + { + // Read the filter. + filters[counter++] = + parseCommaSeparatedList("filter", true, false, true, false, true, false, false, null); + } + while (counter < filters.length && + ConfigurationConstants.SEPARATOR_KEYWORD.equals(nextWord)); + + // Make sure there is a closing parenthesis. + if (!ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD.equals(nextWord)) + { + throw new ParseException("Expecting separating '" + ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD + + "' or '" + ConfigurationConstants.SEPARATOR_KEYWORD + + "', or closing '" + ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD + + "' before " + reader.locationDescription()); + } + + // Set all filters from the array on the entry. + entry.setFilter(filters[--counter]); + if (counter > 0) + { + entry.setJarFilter(filters[--counter]); + if (counter > 0) + { + entry.setWarFilter(filters[--counter]); + if (counter > 0) + { + entry.setEarFilter(filters[--counter]); + if (counter > 0) + { + entry.setZipFilter(filters[--counter]); + } + } + } + } + + // Read the separator, if any. + readNextWord(); + } + + // Add the entry to the list. + classPath.add(entry); + + if (configurationEnd()) + { + return classPath; + } + + if (!nextWord.equals(ConfigurationConstants.JAR_SEPARATOR_KEYWORD)) + { + throw new ParseException("Expecting class path separator '" + ConfigurationConstants.JAR_SEPARATOR_KEYWORD + + "' before " + reader.locationDescription()); + } + } + } + + + private int parseClassVersion() + throws ParseException, IOException + { + // Read the obligatory target. + readNextWord("java version"); + + int classVersion = ClassUtil.internalClassVersion(nextWord); + if (classVersion == 0) + { + throw new ParseException("Unsupported java version " + reader.locationDescription()); + } + + readNextWord(); + + return classVersion; + } + + + private int parseIntegerArgument() + throws ParseException, IOException + { + try + { + // Read the obligatory integer. + readNextWord("integer"); + + int integer = Integer.parseInt(nextWord); + + readNextWord(); + + return integer; + } + catch (NumberFormatException e) + { + throw new ParseException("Expecting integer argument instead of '" + nextWord + + "' before " + reader.locationDescription()); + } + } + + + private File parseFile() + throws ParseException, IOException + { + // Read the obligatory file name. + readNextWord("file name"); + + // Make sure the file is properly resolved. + File file = file(nextWord); + + readNextWord(); + + return file; + } + + + private File parseOptionalFile() + throws ParseException, IOException + { + // Read the optional file name. + readNextWord(); + + // Didn't the user specify a file name? + if (configurationEnd()) + { + return new File(""); + } + + // Make sure the file is properly resolved. + File file = file(nextWord); + + readNextWord(); + + return file; + } + + + private String parseOptionalArgument() throws IOException + { + // Read the optional argument. + readNextWord(); + + // Didn't the user specify an argument? + if (configurationEnd()) + { + return ""; + } + + String fileName = nextWord; + + readNextWord(); + + return fileName; + } + + + private boolean parseNoArgument(boolean value) throws IOException + { + readNextWord(); + + return value; + } + + + private long parseNoArgument(long value) throws IOException + { + readNextWord(); + + return value; + } + + + private List parseKeepClassSpecificationArguments(List keepClassSpecifications, + boolean markClasses, + boolean markConditionally, + boolean allowShrinking) + throws ParseException, IOException + { + // Create a new List if necessary. + if (keepClassSpecifications == null) + { + keepClassSpecifications = new ArrayList(); + } + + //boolean allowShrinking = false; + boolean allowOptimization = false; + boolean allowObfuscation = false; + + // Read the keep modifiers. + while (true) + { + readNextWord("keyword '" + ConfigurationConstants.CLASS_KEYWORD + + "', '" + ClassConstants.EXTERNAL_ACC_INTERFACE + + "', or '" + ClassConstants.EXTERNAL_ACC_ENUM + "'", true); + + if (!ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD.equals(nextWord)) + { + // Not a comma. Stop parsing the keep modifiers. + break; + } + + readNextWord("keyword '" + ConfigurationConstants.ALLOW_SHRINKING_SUBOPTION + + "', '" + ConfigurationConstants.ALLOW_OPTIMIZATION_SUBOPTION + + "', or '" + ConfigurationConstants.ALLOW_OBFUSCATION_SUBOPTION + "'"); + + if (ConfigurationConstants.ALLOW_SHRINKING_SUBOPTION .startsWith(nextWord)) + { + allowShrinking = true; + } + else if (ConfigurationConstants.ALLOW_OPTIMIZATION_SUBOPTION.startsWith(nextWord)) + { + allowOptimization = true; + } + else if (ConfigurationConstants.ALLOW_OBFUSCATION_SUBOPTION .startsWith(nextWord)) + { + allowObfuscation = true; + } + else + { + throw new ParseException("Expecting keyword '" + ConfigurationConstants.ALLOW_SHRINKING_SUBOPTION + + "', '" + ConfigurationConstants.ALLOW_OPTIMIZATION_SUBOPTION + + "', or '" + ConfigurationConstants.ALLOW_OBFUSCATION_SUBOPTION + + "' before " + reader.locationDescription()); + } + } + + // Read the class configuration. + ClassSpecification classSpecification = + parseClassSpecificationArguments(); + + // Create and add the keep configuration. + keepClassSpecifications.add(new KeepClassSpecification(markClasses, + markConditionally, + allowShrinking, + allowOptimization, + allowObfuscation, + classSpecification)); + return keepClassSpecifications; + } + + + private List parseClassSpecificationArguments(List classSpecifications) + throws ParseException, IOException + { + // Create a new List if necessary. + if (classSpecifications == null) + { + classSpecifications = new ArrayList(); + } + + // Read and add the class configuration. + readNextWord("keyword '" + ConfigurationConstants.CLASS_KEYWORD + + "', '" + ClassConstants.EXTERNAL_ACC_INTERFACE + + "', or '" + ClassConstants.EXTERNAL_ACC_ENUM + "'", true); + + classSpecifications.add(parseClassSpecificationArguments()); + + return classSpecifications; + } + + + private ClassSpecification parseClassSpecificationArguments() + throws ParseException, IOException + { + // Clear the annotation type. + String annotationType = null; + + // Clear the class access modifiers. + int requiredSetClassAccessFlags = 0; + int requiredUnsetClassAccessFlags = 0; + + // Parse the class annotations and access modifiers until the class keyword. + while (!ConfigurationConstants.CLASS_KEYWORD.equals(nextWord)) + { + // Parse the annotation type, if any. +// if (ConfigurationConstants.ANNOTATION_KEYWORD.equals(nextWord)) +// { +// annotationType = +// ClassUtil.internalType( +// ListUtil.commaSeparatedString( +// parseCommaSeparatedList("annotation type", +// true, false, false, true, false, null))); +// +// continue; +// } + + // Strip the negating sign, if any. + String strippedWord = nextWord.startsWith(ConfigurationConstants.NEGATOR_KEYWORD) ? + nextWord.substring(1) : + nextWord; + + // Parse the class access modifiers. + // TODO: Distinguish annotation from annotation modifier. + int accessFlag = + strippedWord.equals(ClassConstants.EXTERNAL_ACC_PUBLIC) ? ClassConstants.INTERNAL_ACC_PUBLIC : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_FINAL) ? ClassConstants.INTERNAL_ACC_FINAL : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_INTERFACE) ? ClassConstants.INTERNAL_ACC_INTERFACE : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_ABSTRACT) ? ClassConstants.INTERNAL_ACC_ABSTRACT : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_ANNOTATION) ? ClassConstants.INTERNAL_ACC_ANNOTATTION : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_ENUM) ? ClassConstants.INTERNAL_ACC_ENUM : + unknownAccessFlag(); + + // Is it an annotation modifier? + if (accessFlag == ClassConstants.INTERNAL_ACC_ANNOTATTION) + { + // Is the next word actually an annotation type? + readNextWord("annotation type or keyword '" + ClassConstants.EXTERNAL_ACC_INTERFACE + "'", false); + + if (!nextWord.equals(ClassConstants.EXTERNAL_ACC_INTERFACE) && + !nextWord.equals(ClassConstants.EXTERNAL_ACC_ENUM) && + !nextWord.equals(ConfigurationConstants.CLASS_KEYWORD)) + { + // Parse the annotation type. + annotationType = + ListUtil.commaSeparatedString( + parseCommaSeparatedList("annotation type", + false, false, false, true, false, false, true, null)); + + continue; + } + } + + if (strippedWord.equals(nextWord)) + { + requiredSetClassAccessFlags |= accessFlag; + } + else + { + requiredUnsetClassAccessFlags |= accessFlag; + } + + + if ((requiredSetClassAccessFlags & + requiredUnsetClassAccessFlags) != 0) + { + throw new ParseException("Conflicting class access modifiers for '" + strippedWord + + "' before " + reader.locationDescription()); + } + + if (strippedWord.equals(ClassConstants.EXTERNAL_ACC_INTERFACE) || + strippedWord.equals(ClassConstants.EXTERNAL_ACC_ENUM) || + strippedWord.equals(ConfigurationConstants.CLASS_KEYWORD)) + { + // The interface or enum keyword. Stop parsing the class flags. + break; + } + + readNextWord("keyword '" + ConfigurationConstants.CLASS_KEYWORD + + "', '" + ClassConstants.EXTERNAL_ACC_INTERFACE + + "', or '" + ClassConstants.EXTERNAL_ACC_ENUM + "'", true); + } + + // Parse the class name part. + String externalClassName = + ListUtil.commaSeparatedString( + parseCommaSeparatedList("class name or interface name", + true, false, false, true, false, false, false, null)); + + // For backward compatibility, allow a single "*" wildcard to match any + // class. + String className = ConfigurationConstants.ANY_CLASS_KEYWORD.equals(externalClassName) ? + null : + ClassUtil.internalClassName(externalClassName); + + // Clear the annotation type and the class name of the extends part. + String extendsAnnotationType = null; + String extendsClassName = null; + + if (!configurationEnd()) + { + // Parse 'implements ...' or 'extends ...' part, if any. + if (ConfigurationConstants.IMPLEMENTS_KEYWORD.equals(nextWord) || + ConfigurationConstants.EXTENDS_KEYWORD.equals(nextWord)) + { + readNextWord("class name or interface name", true); + + // Parse the annotation type, if any. + if (ConfigurationConstants.ANNOTATION_KEYWORD.equals(nextWord)) + { + extendsAnnotationType = + ListUtil.commaSeparatedString( + parseCommaSeparatedList("annotation type", + true, false, false, true, false, false, true, null)); + } + + String externalExtendsClassName = + ListUtil.commaSeparatedString( + parseCommaSeparatedList("class name or interface name", + false, false, false, true, false, false, false, null)); + + extendsClassName = ConfigurationConstants.ANY_CLASS_KEYWORD.equals(externalExtendsClassName) ? + null : + ClassUtil.internalClassName(externalExtendsClassName); + } + } + + // Create the basic class specification. + ClassSpecification classSpecification = + new ClassSpecification(lastComments, + requiredSetClassAccessFlags, + requiredUnsetClassAccessFlags, + annotationType, + className, + extendsAnnotationType, + extendsClassName); + + + // Now add any class members to this class specification. + if (!configurationEnd()) + { + // Check the class member opening part. + if (!ConfigurationConstants.OPEN_KEYWORD.equals(nextWord)) + { + throw new ParseException("Expecting opening '" + ConfigurationConstants.OPEN_KEYWORD + + "' at " + reader.locationDescription()); + } + + // Parse all class members. + while (true) + { + readNextWord("class member description" + + " or closing '" + ConfigurationConstants.CLOSE_KEYWORD + "'", true); + + if (nextWord.equals(ConfigurationConstants.CLOSE_KEYWORD)) + { + // The closing brace. Stop parsing the class members. + readNextWord(); + + break; + } + + parseMemberSpecificationArguments(externalClassName, + classSpecification); + } + } + + return classSpecification; + } + + + private void parseMemberSpecificationArguments(String externalClassName, + ClassSpecification classSpecification) + throws ParseException, IOException + { + // Clear the annotation name. + String annotationType = null; + + // Parse the class member access modifiers, if any. + int requiredSetMemberAccessFlags = 0; + int requiredUnsetMemberAccessFlags = 0; + + while (!configurationEnd(true)) + { + // Parse the annotation type, if any. + if (ConfigurationConstants.ANNOTATION_KEYWORD.equals(nextWord)) + { + annotationType = + ListUtil.commaSeparatedString( + parseCommaSeparatedList("annotation type", + true, false, false, true, false, false, true, null)); + + continue; + } + + String strippedWord = nextWord.startsWith("!") ? + nextWord.substring(1) : + nextWord; + + // Parse the class member access modifiers. + int accessFlag = + strippedWord.equals(ClassConstants.EXTERNAL_ACC_PUBLIC) ? ClassConstants.INTERNAL_ACC_PUBLIC : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_PRIVATE) ? ClassConstants.INTERNAL_ACC_PRIVATE : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_PROTECTED) ? ClassConstants.INTERNAL_ACC_PROTECTED : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_STATIC) ? ClassConstants.INTERNAL_ACC_STATIC : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_FINAL) ? ClassConstants.INTERNAL_ACC_FINAL : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_SYNCHRONIZED) ? ClassConstants.INTERNAL_ACC_SYNCHRONIZED : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_VOLATILE) ? ClassConstants.INTERNAL_ACC_VOLATILE : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_TRANSIENT) ? ClassConstants.INTERNAL_ACC_TRANSIENT : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_NATIVE) ? ClassConstants.INTERNAL_ACC_NATIVE : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_ABSTRACT) ? ClassConstants.INTERNAL_ACC_ABSTRACT : + strippedWord.equals(ClassConstants.EXTERNAL_ACC_STRICT) ? ClassConstants.INTERNAL_ACC_STRICT : + 0; + if (accessFlag == 0) + { + // Not a class member access modifier. Stop parsing them. + break; + } + + if (strippedWord.equals(nextWord)) + { + requiredSetMemberAccessFlags |= accessFlag; + } + else + { + requiredUnsetMemberAccessFlags |= accessFlag; + } + + // Make sure the user doesn't try to set and unset the same + // access flags simultaneously. + if ((requiredSetMemberAccessFlags & + requiredUnsetMemberAccessFlags) != 0) + { + throw new ParseException("Conflicting class member access modifiers for " + + reader.locationDescription()); + } + + readNextWord("class member description"); + } + + // Parse the class member type and name part. + + // Did we get a special wildcard? + if (ConfigurationConstants.ANY_CLASS_MEMBER_KEYWORD.equals(nextWord) || + ConfigurationConstants.ANY_FIELD_KEYWORD .equals(nextWord) || + ConfigurationConstants.ANY_METHOD_KEYWORD .equals(nextWord)) + { + // Act according to the type of wildcard.. + if (ConfigurationConstants.ANY_CLASS_MEMBER_KEYWORD.equals(nextWord)) + { + checkFieldAccessFlags(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags); + checkMethodAccessFlags(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags); + + classSpecification.addField( + new MemberSpecification(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags, + annotationType, + null, + null)); + classSpecification.addMethod( + new MemberSpecification(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags, + annotationType, + null, + null)); + } + else if (ConfigurationConstants.ANY_FIELD_KEYWORD.equals(nextWord)) + { + checkFieldAccessFlags(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags); + + classSpecification.addField( + new MemberSpecification(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags, + annotationType, + null, + null)); + } + else if (ConfigurationConstants.ANY_METHOD_KEYWORD.equals(nextWord)) + { + checkMethodAccessFlags(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags); + + classSpecification.addMethod( + new MemberSpecification(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags, + annotationType, + null, + null)); + } + + // We still have to read the closing separator. + readNextWord("separator '" + ConfigurationConstants.SEPARATOR_KEYWORD + "'"); + + if (!ConfigurationConstants.SEPARATOR_KEYWORD.equals(nextWord)) + { + throw new ParseException("Expecting separator '" + ConfigurationConstants.SEPARATOR_KEYWORD + + "' before " + reader.locationDescription()); + } + } + else + { + // Make sure we have a proper type. + checkJavaIdentifier("java type"); + String type = nextWord; + + readNextWord("class member name"); + String name = nextWord; + + // Did we get just one word before the opening parenthesis? + if (ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD.equals(name)) + { + // This must be a constructor then. + // Make sure the type is a proper constructor name. + if (!(type.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) || + type.equals(externalClassName) || + type.equals(ClassUtil.externalShortClassName(externalClassName)))) + { + throw new ParseException("Expecting type and name " + + "instead of just '" + type + + "' before " + reader.locationDescription()); + } + + // Assign the fixed constructor type and name. + type = ClassConstants.EXTERNAL_TYPE_VOID; + name = ClassConstants.INTERNAL_METHOD_NAME_INIT; + } + else + { + // It's not a constructor. + // Make sure we have a proper name. + checkJavaIdentifier("class member name"); + + // Read the opening parenthesis or the separating + // semi-colon. + readNextWord("opening '" + ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD + + "' or separator '" + ConfigurationConstants.SEPARATOR_KEYWORD + "'"); + } + + // Are we looking at a field, a method, or something else? + if (ConfigurationConstants.SEPARATOR_KEYWORD.equals(nextWord)) + { + // It's a field. + checkFieldAccessFlags(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags); + + // We already have a field descriptor. + String descriptor = ClassUtil.internalType(type); + + // Add the field. + classSpecification.addField( + new MemberSpecification(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags, + annotationType, + name, + descriptor)); + } + else if (ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD.equals(nextWord)) + { + // It's a method. + checkMethodAccessFlags(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags); + + // Parse the method arguments. + String descriptor = + ClassUtil.internalMethodDescriptor(type, + parseCommaSeparatedList("argument", true, true, true, true, false, false, false, null)); + + if (!ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD.equals(nextWord)) + { + throw new ParseException("Expecting separating '" + ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD + + "' or closing '" + ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD + + "' before " + reader.locationDescription()); + } + + // Read the separator after the closing parenthesis. + readNextWord("separator '" + ConfigurationConstants.SEPARATOR_KEYWORD + "'"); + + if (!ConfigurationConstants.SEPARATOR_KEYWORD.equals(nextWord)) + { + throw new ParseException("Expecting separator '" + ConfigurationConstants.SEPARATOR_KEYWORD + + "' before " + reader.locationDescription()); + } + + // Add the method. + classSpecification.addMethod( + new MemberSpecification(requiredSetMemberAccessFlags, + requiredUnsetMemberAccessFlags, + annotationType, + name, + descriptor)); + } + else + { + // It doesn't look like a field or a method. + throw new ParseException("Expecting opening '" + ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD + + "' or separator '" + ConfigurationConstants.SEPARATOR_KEYWORD + + "' before " + reader.locationDescription()); + } + } + } + + + /** + * Reads a comma-separated list of java identifiers or of file names. If an + * empty list is allowed, the reading will end after a closing parenthesis + * or semi-colon. + */ + private List parseCommaSeparatedList(String expectedDescription, + boolean readFirstWord, + boolean allowEmptyList, + boolean expectClosingParenthesis, + boolean checkJavaIdentifiers, + boolean replaceSystemProperties, + boolean replaceExternalClassNames, + boolean replaceExternalTypes, + List list) + throws ParseException, IOException + { + if (list == null) + { + list = new ArrayList(); + } + + if (readFirstWord) + { + if (expectClosingParenthesis || !allowEmptyList) + { + // Read the first list entry. + readNextWord(expectedDescription); + } + else + { + // Read the first list entry, if there is any. + readNextWord(); + + // Check if the list is empty. + if (configurationEnd() || + nextWord.equals(ConfigurationConstants.ANY_ATTRIBUTE_KEYWORD)) + { + return list; + } + } + } + + while (true) + { + if (expectClosingParenthesis && + list.size() == 0 && + (ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD.equals(nextWord) || + ConfigurationConstants.SEPARATOR_KEYWORD.equals(nextWord))) + { + break; + } + + if (checkJavaIdentifiers) + { + checkJavaIdentifier("java type"); + } + + if (replaceSystemProperties) + { + nextWord = replaceSystemProperties(nextWord); + } + + if (replaceExternalClassNames) + { + nextWord = ClassUtil.internalClassName(nextWord); + } + + if (replaceExternalTypes) + { + nextWord = ClassUtil.internalType(nextWord); + } + + list.add(nextWord); + + if (expectClosingParenthesis) + { + // Read a comma (or a closing parenthesis, or a different word). + readNextWord("separating '" + ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD + + "' or closing '" + ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD + + "'"); + } + else + { + // Read a comma (or a different word). + readNextWord(); + } + + if (!ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD.equals(nextWord)) + { + break; + } + + // Read the next list entry. + readNextWord(expectedDescription); + } + + return list; + } + + + /** + * Throws a ParseException for an unexpected keyword. + */ + private int unknownAccessFlag() throws ParseException + { + throw new ParseException("Unexpected keyword " + reader.locationDescription()); + } + + + /** + * Creates a properly resolved File, based on the given word. + */ + private File file(String word) throws ParseException + { + String fileName = replaceSystemProperties(word); + File file = new File(fileName); + + // Try to get an absolute file. + if (!file.isAbsolute()) + { + file = new File(reader.getBaseDir(), fileName); + } + + // Try to get a canonical representation. + try + { + file = file.getCanonicalFile(); + } + catch (IOException ex) + { + // Just keep the original representation. + } + + return file; + } + + + /** + * Replaces any system properties in the given word by their values + * (e.g. the substring "" is replaced by its value). + */ + private String replaceSystemProperties(String word) throws ParseException + { + int fromIndex = 0; + while (true) + { + fromIndex = word.indexOf(ConfigurationConstants.OPEN_SYSTEM_PROPERTY, fromIndex); + if (fromIndex < 0) + { + break; + } + + int toIndex = word.indexOf(ConfigurationConstants.CLOSE_SYSTEM_PROPERTY, fromIndex+1); + if (toIndex < 0) + { + throw new ParseException("Expecting closing '" + ConfigurationConstants.CLOSE_SYSTEM_PROPERTY + + "' after opening '" + ConfigurationConstants.OPEN_SYSTEM_PROPERTY + + "' in " + reader.locationDescription()); + } + + String propertyName = word.substring(fromIndex+1, toIndex); + String propertyValue = System.getProperty(propertyName); + if (propertyValue == null) + { + throw new ParseException("Value of system property '" + propertyName + + "' is undefined in " + reader.locationDescription()); + } + + word = word.substring(0, fromIndex) + + propertyValue + + word.substring(toIndex+1); + } + + return word; + } + + + /** + * Reads the next word of the configuration in the 'nextWord' field, + * throwing an exception if there is no next word. + */ + private void readNextWord(String expectedDescription) + throws ParseException, IOException + { + readNextWord(expectedDescription, false); + } + + + /** + * Reads the next word of the configuration in the 'nextWord' field, + * throwing an exception if there is no next word. + */ + private void readNextWord(String expectedDescription, + boolean expectingAtCharacter) + throws ParseException, IOException + { + readNextWord(); + if (configurationEnd(expectingAtCharacter)) + { + throw new ParseException("Expecting " + expectedDescription + + " before " + reader.locationDescription()); + } + } + + + /** + * Reads the next word of the configuration in the 'nextWord' field. + */ + private void readNextWord() throws IOException + { + nextWord = reader.nextWord(); + } + + + /** + * Returns whether the end of the configuration has been reached. + */ + private boolean configurationEnd() + { + return configurationEnd(false); + } + + + /** + * Returns whether the end of the configuration has been reached. + */ + private boolean configurationEnd(boolean expectingAtCharacter) + { + return nextWord == null || + nextWord.startsWith(ConfigurationConstants.OPTION_PREFIX) || + (!expectingAtCharacter && + nextWord.equals(ConfigurationConstants.AT_DIRECTIVE)); + } + + + /** + * Checks whether the given word is a valid Java identifier and throws + * a ParseException if it isn't. Wildcard characters are accepted. + */ + private void checkJavaIdentifier(String expectedDescription) + throws ParseException + { + if (!isJavaIdentifier(nextWord)) + { + throw new ParseException("Expecting " + expectedDescription + + " before " + reader.locationDescription()); + } + } + + + /** + * Returns whether the given word is a valid Java identifier. + * Wildcard characters are accepted. + */ + private boolean isJavaIdentifier(String aWord) + { + for (int index = 0; index < aWord.length(); index++) + { + char c = aWord.charAt(index); + if (!(Character.isJavaIdentifierPart(c) || + c == '.' || + c == '[' || + c == ']' || + c == '<' || + c == '>' || + c == '-' || + c == '!' || + c == '*' || + c == '?' || + c == '%')) + { + return false; + } + } + + return true; + } + + + /** + * Checks whether the given access flags are valid field access flags, + * throwing a ParseException if they aren't. + */ + private void checkFieldAccessFlags(int requiredSetMemberAccessFlags, + int requiredUnsetMemberAccessFlags) + throws ParseException + { + if (((requiredSetMemberAccessFlags | + requiredUnsetMemberAccessFlags) & + ~ClassConstants.VALID_INTERNAL_ACC_FIELD) != 0) + { + throw new ParseException("Invalid method access modifier for field before " + + reader.locationDescription()); + } + } + + + /** + * Checks whether the given access flags are valid method access flags, + * throwing a ParseException if they aren't. + */ + private void checkMethodAccessFlags(int requiredSetMemberAccessFlags, + int requiredUnsetMemberAccessFlags) + throws ParseException + { + if (((requiredSetMemberAccessFlags | + requiredUnsetMemberAccessFlags) & + ~ClassConstants.VALID_INTERNAL_ACC_METHOD) != 0) + { + throw new ParseException("Invalid field access modifier for method before " + + reader.locationDescription()); + } + } + + + /** + * A main method for testing configuration parsing. + */ + public static void main(String[] args) + { + try + { + ConfigurationParser parser = new ConfigurationParser(args); + + try + { + parser.parse(new Configuration()); + } + catch (ParseException ex) + { + ex.printStackTrace(); + } + finally + { + parser.close(); + } + } + catch (IOException ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/ConfigurationWriter.java b/src/proguard/ConfigurationWriter.java new file mode 100644 index 0000000..5d112d6 --- /dev/null +++ b/src/proguard/ConfigurationWriter.java @@ -0,0 +1,643 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; +import proguard.util.ListUtil; + +import java.io.*; +import java.util.List; + + +/** + * This class writes ProGuard configurations to a file. + * + * @author Eric Lafortune + */ +public class ConfigurationWriter +{ + private static final String[] KEEP_OPTIONS = new String[] + { + ConfigurationConstants.KEEP_OPTION, + ConfigurationConstants.KEEP_CLASS_MEMBERS_OPTION, + ConfigurationConstants.KEEP_CLASSES_WITH_MEMBERS_OPTION + }; + + + private final PrintWriter writer; + private File baseDir; + + + /** + * Creates a new ConfigurationWriter for the given file name. + */ + public ConfigurationWriter(File configurationFile) throws IOException + { + this(new PrintWriter(new FileWriter(configurationFile))); + + baseDir = configurationFile.getParentFile(); + } + + + /** + * Creates a new ConfigurationWriter for the given OutputStream. + */ + public ConfigurationWriter(OutputStream outputStream) throws IOException + { + this(new PrintWriter(outputStream)); + } + + + /** + * Creates a new ConfigurationWriter for the given PrintWriter. + */ + public ConfigurationWriter(PrintWriter writer) throws IOException + { + this.writer = writer; + } + + + /** + * Closes this ConfigurationWriter. + */ + public void close() throws IOException + { + writer.close(); + } + + + /** + * Writes the given configuration. + * @param configuration the configuration that is to be written out. + * @throws IOException if an IO error occurs while writing the configuration. + */ + public void write(Configuration configuration) throws IOException + { + // Write the program class path (input and output entries). + writeJarOptions(ConfigurationConstants.INJARS_OPTION, + ConfigurationConstants.OUTJARS_OPTION, + configuration.programJars); + writer.println(); + + // Write the library class path (output entries only). + writeJarOptions(ConfigurationConstants.LIBRARYJARS_OPTION, + ConfigurationConstants.LIBRARYJARS_OPTION, + configuration.libraryJars); + writer.println(); + + // Write the other options. + writeOption(ConfigurationConstants.DONT_SKIP_NON_PUBLIC_LIBRARY_CLASSES_OPTION, !configuration.skipNonPublicLibraryClasses); + writeOption(ConfigurationConstants.DONT_SKIP_NON_PUBLIC_LIBRARY_CLASS_MEMBERS_OPTION, !configuration.skipNonPublicLibraryClassMembers); + writeOption(ConfigurationConstants.KEEP_DIRECTORIES_OPTION, configuration.keepDirectories); + writeOption(ConfigurationConstants.TARGET_OPTION, ClassUtil.externalClassVersion(configuration.targetClassVersion)); + writeOption(ConfigurationConstants.FORCE_PROCESSING_OPTION, configuration.lastModified == Long.MAX_VALUE); + + writeOption(ConfigurationConstants.DONT_SHRINK_OPTION, !configuration.shrink); + writeOption(ConfigurationConstants.PRINT_USAGE_OPTION, configuration.printUsage); + + writeOption(ConfigurationConstants.DONT_OPTIMIZE_OPTION, !configuration.optimize); + writeOption(ConfigurationConstants.OPTIMIZATIONS, configuration.optimize ? ListUtil.commaSeparatedString(configuration.optimizations) : null); + writeOption(ConfigurationConstants.OPTIMIZATION_PASSES, configuration.optimizationPasses); + writeOption(ConfigurationConstants.ALLOW_ACCESS_MODIFICATION_OPTION, configuration.allowAccessModification); + writeOption(ConfigurationConstants.MERGE_INTERFACES_AGGRESSIVELY_OPTION, configuration.mergeInterfacesAggressively); + + writeOption(ConfigurationConstants.DONT_OBFUSCATE_OPTION, !configuration.obfuscate); + writeOption(ConfigurationConstants.PRINT_MAPPING_OPTION, configuration.printMapping); + writeOption(ConfigurationConstants.APPLY_MAPPING_OPTION, configuration.applyMapping); + writeOption(ConfigurationConstants.OBFUSCATION_DICTIONARY_OPTION, configuration.obfuscationDictionary); + writeOption(ConfigurationConstants.CLASS_OBFUSCATION_DICTIONARY_OPTION, configuration.classObfuscationDictionary); + writeOption(ConfigurationConstants.PACKAGE_OBFUSCATION_DICTIONARY_OPTION, configuration.packageObfuscationDictionary); + writeOption(ConfigurationConstants.OVERLOAD_AGGRESSIVELY_OPTION, configuration.overloadAggressively); + writeOption(ConfigurationConstants.USE_UNIQUE_CLASS_MEMBER_NAMES_OPTION, configuration.useUniqueClassMemberNames); + writeOption(ConfigurationConstants.DONT_USE_MIXED_CASE_CLASS_NAMES_OPTION, !configuration.useMixedCaseClassNames); + writeOption(ConfigurationConstants.KEEP_PACKAGE_NAMES_OPTION, configuration.keepPackageNames, true); + writeOption(ConfigurationConstants.FLATTEN_PACKAGE_HIERARCHY_OPTION, configuration.flattenPackageHierarchy, true); + writeOption(ConfigurationConstants.REPACKAGE_CLASSES_OPTION, configuration.repackageClasses, true); + writeOption(ConfigurationConstants.KEEP_ATTRIBUTES_OPTION, configuration.keepAttributes); + writeOption(ConfigurationConstants.RENAME_SOURCE_FILE_ATTRIBUTE_OPTION, configuration.newSourceFileAttribute); + writeOption(ConfigurationConstants.ADAPT_CLASS_STRINGS_OPTION, configuration.adaptClassStrings, true); + writeOption(ConfigurationConstants.ADAPT_RESOURCE_FILE_NAMES_OPTION, configuration.adaptResourceFileNames); + writeOption(ConfigurationConstants.ADAPT_RESOURCE_FILE_CONTENTS_OPTION, configuration.adaptResourceFileContents); + + writeOption(ConfigurationConstants.DONT_PREVERIFY_OPTION, !configuration.preverify); + writeOption(ConfigurationConstants.MICRO_EDITION_OPTION, configuration.microEdition); + + writeOption(ConfigurationConstants.VERBOSE_OPTION, configuration.verbose); + writeOption(ConfigurationConstants.DONT_NOTE_OPTION, configuration.note, true); + writeOption(ConfigurationConstants.DONT_WARN_OPTION, configuration.warn, true); + writeOption(ConfigurationConstants.IGNORE_WARNINGS_OPTION, configuration.ignoreWarnings); + writeOption(ConfigurationConstants.PRINT_CONFIGURATION_OPTION, configuration.printConfiguration); + writeOption(ConfigurationConstants.DUMP_OPTION, configuration.dump); + + writeOption(ConfigurationConstants.PRINT_SEEDS_OPTION, configuration.printSeeds); + writer.println(); + + // Write the "why are you keeping" options. + writeOptions(ConfigurationConstants.WHY_ARE_YOU_KEEPING_OPTION, configuration.whyAreYouKeeping); + + // Write the keep options. + writeOptions(KEEP_OPTIONS, configuration.keep); + + // Write the "no side effect methods" options. + writeOptions(ConfigurationConstants.ASSUME_NO_SIDE_EFFECTS_OPTION, configuration.assumeNoSideEffects); + + if (writer.checkError()) + { + throw new IOException("Can't write configuration"); + } + } + + + private void writeJarOptions(String inputEntryOptionName, + String outputEntryOptionName, + ClassPath classPath) + { + if (classPath != null) + { + for (int index = 0; index < classPath.size(); index++) + { + ClassPathEntry entry = classPath.get(index); + String optionName = entry.isOutput() ? + outputEntryOptionName : + inputEntryOptionName; + + writer.print(optionName); + writer.print(' '); + writer.print(relativeFileName(entry.getFile())); + + // Append the filters, if any. + boolean filtered = false; + + filtered = writeFilter(filtered, entry.getZipFilter()); + filtered = writeFilter(filtered, entry.getEarFilter()); + filtered = writeFilter(filtered, entry.getWarFilter()); + filtered = writeFilter(filtered, entry.getJarFilter()); + filtered = writeFilter(filtered, entry.getFilter()); + + if (filtered) + { + writer.print(ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD); + } + + writer.println(); + } + } + } + + + private boolean writeFilter(boolean filtered, List filter) + { + if (filtered) + { + writer.print(ConfigurationConstants.SEPARATOR_KEYWORD); + } + + if (filter != null) + { + if (!filtered) + { + writer.print(ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD); + } + + for (int index = 0; index < filter.size(); index++) + { + if (index > 0) + { + writer.print(ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD); + } + + writer.print(quotedString((String)filter.get(index))); + } + + filtered = true; + } + + return filtered; + } + + + private void writeOption(String optionName, boolean flag) + { + if (flag) + { + writer.println(optionName); + } + } + + + private void writeOption(String optionName, int argument) + { + if (argument != 1) + { + writer.print(optionName); + writer.print(' '); + writer.println(argument); + } + } + + + private void writeOption(String optionName, List arguments) + { + writeOption(optionName, arguments, false); + } + + + private void writeOption(String optionName, + List arguments, + boolean replaceInternalClassNames) + { + if (arguments != null) + { + if (arguments.isEmpty()) + { + writer.println(optionName); + } + else + { + String argumentString = ListUtil.commaSeparatedString(arguments); + + if (replaceInternalClassNames) + { + argumentString = ClassUtil.externalClassName(argumentString); + } + + writer.print(optionName); + writer.print(' '); + writer.println(quotedString(argumentString)); + } + } + } + + + private void writeOption(String optionName, String arguments) + { + writeOption(optionName, arguments, false); + } + + + private void writeOption(String optionName, + String arguments, + boolean replaceInternalClassNames) + { + if (arguments != null) + { + if (replaceInternalClassNames) + { + arguments = ClassUtil.externalClassName(arguments); + } + + writer.print(optionName); + writer.print(' '); + writer.println(quotedString(arguments)); + } + } + + + private void writeOption(String optionName, File file) + { + if (file != null) + { + if (file.getPath().length() > 0) + { + writer.print(optionName); + writer.print(' '); + writer.println(relativeFileName(file)); + } + else + { + writer.println(optionName); + } + } + } + + + private void writeOptions(String[] optionNames, + List keepClassSpecifications) + { + if (keepClassSpecifications != null) + { + for (int index = 0; index < keepClassSpecifications.size(); index++) + { + writeOption(optionNames, (KeepClassSpecification)keepClassSpecifications.get(index)); + } + } + } + + + private void writeOption(String[] optionNames, + KeepClassSpecification keepClassSpecification) + { + // Compose the option name. + String optionName = optionNames[keepClassSpecification.markConditionally ? 2 : + keepClassSpecification.markClasses ? 0 : + 1]; + + if (keepClassSpecification.allowShrinking) + { + optionName += ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD + + ConfigurationConstants.ALLOW_SHRINKING_SUBOPTION; + } + + if (keepClassSpecification.allowOptimization) + { + optionName += ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD + + ConfigurationConstants.ALLOW_OPTIMIZATION_SUBOPTION; + } + + if (keepClassSpecification.allowObfuscation) + { + optionName += ConfigurationConstants.ARGUMENT_SEPARATOR_KEYWORD + + ConfigurationConstants.ALLOW_OBFUSCATION_SUBOPTION; + } + + // Write out the option with the proper class specification. + writeOption(optionName, keepClassSpecification); + } + + + private void writeOptions(String optionName, + List classSpecifications) + { + if (classSpecifications != null) + { + for (int index = 0; index < classSpecifications.size(); index++) + { + writeOption(optionName, (ClassSpecification)classSpecifications.get(index)); + } + } + } + + + private void writeOption(String optionName, + ClassSpecification classSpecification) + { + writer.println(); + + // Write out the comments for this option. + writeComments(classSpecification.comments); + + writer.print(optionName); + writer.print(' '); + + // Write out the required annotation, if any. + if (classSpecification.annotationType != null) + { + writer.print(ConfigurationConstants.ANNOTATION_KEYWORD); + writer.print(ClassUtil.externalType(classSpecification.annotationType)); + writer.print(' '); + } + + // Write out the class access flags. + writer.print(ClassUtil.externalClassAccessFlags(classSpecification.requiredUnsetAccessFlags, + ConfigurationConstants.NEGATOR_KEYWORD)); + + writer.print(ClassUtil.externalClassAccessFlags(classSpecification.requiredSetAccessFlags)); + + // Write out the class keyword, if we didn't write the interface + // keyword earlier. + if (((classSpecification.requiredSetAccessFlags | + classSpecification.requiredUnsetAccessFlags) & + (ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ENUM)) == 0) + { + writer.print(ConfigurationConstants.CLASS_KEYWORD); + } + + writer.print(' '); + + // Write out the class name. + writer.print(classSpecification.className != null ? + ClassUtil.externalClassName(classSpecification.className) : + ConfigurationConstants.ANY_CLASS_KEYWORD); + + // Write out the extends template, if any. + if (classSpecification.extendsAnnotationType != null || + classSpecification.extendsClassName != null) + { + writer.print(' '); + writer.print(ConfigurationConstants.EXTENDS_KEYWORD); + writer.print(' '); + + // Write out the required extends annotation, if any. + if (classSpecification.extendsAnnotationType != null) + { + writer.print(ConfigurationConstants.ANNOTATION_KEYWORD); + writer.print(ClassUtil.externalType(classSpecification.extendsAnnotationType)); + writer.print(' '); + } + + // Write out the extended class name. + writer.print(classSpecification.extendsClassName != null ? + ClassUtil.externalClassName(classSpecification.extendsClassName) : + ConfigurationConstants.ANY_CLASS_KEYWORD); + } + + // Write out the keep field and keep method options, if any. + if (classSpecification.fieldSpecifications != null || + classSpecification.methodSpecifications != null) + { + writer.print(' '); + writer.println(ConfigurationConstants.OPEN_KEYWORD); + + writeFieldSpecification( classSpecification.fieldSpecifications); + writeMethodSpecification(classSpecification.methodSpecifications); + + writer.println(ConfigurationConstants.CLOSE_KEYWORD); + } + else + { + writer.println(); + } + } + + + + private void writeComments(String comments) + { + if (comments != null) + { + int index = 0; + while (index < comments.length()) + { + int breakIndex = comments.indexOf('\n', index); + if (breakIndex < 0) + { + breakIndex = comments.length(); + } + + writer.print('#'); + + if (comments.charAt(index) != ' ') + { + writer.print(' '); + } + + writer.println(comments.substring(index, breakIndex)); + + index = breakIndex + 1; + } + } + } + + + private void writeFieldSpecification(List memberSpecifications) + { + if (memberSpecifications != null) + { + for (int index = 0; index < memberSpecifications.size(); index++) + { + MemberSpecification memberSpecification = + (MemberSpecification)memberSpecifications.get(index); + + writer.print(" "); + + // Write out the required annotation, if any. + if (memberSpecification.annotationType != null) + { + writer.print(ConfigurationConstants.ANNOTATION_KEYWORD); + writer.println(ClassUtil.externalType(memberSpecification.annotationType)); + writer.print(" "); + } + + // Write out the field access flags. + writer.print(ClassUtil.externalFieldAccessFlags(memberSpecification.requiredUnsetAccessFlags, + ConfigurationConstants.NEGATOR_KEYWORD)); + + writer.print(ClassUtil.externalFieldAccessFlags(memberSpecification.requiredSetAccessFlags)); + + // Write out the field name and descriptor. + String name = memberSpecification.name; + String descriptor = memberSpecification.descriptor; + + writer.print(descriptor == null ? name == null ? + ConfigurationConstants.ANY_FIELD_KEYWORD : + ConfigurationConstants.ANY_TYPE_KEYWORD + ' ' + name : + ClassUtil.externalFullFieldDescription(0, + name == null ? ConfigurationConstants.ANY_CLASS_MEMBER_KEYWORD : name, + descriptor)); + + writer.println(ConfigurationConstants.SEPARATOR_KEYWORD); + } + } + } + + + private void writeMethodSpecification(List memberSpecifications) + { + if (memberSpecifications != null) + { + for (int index = 0; index < memberSpecifications.size(); index++) + { + MemberSpecification memberSpecification = + (MemberSpecification)memberSpecifications.get(index); + + writer.print(" "); + + // Write out the required annotation, if any. + if (memberSpecification.annotationType != null) + { + writer.print(ConfigurationConstants.ANNOTATION_KEYWORD); + writer.println(ClassUtil.externalType(memberSpecification.annotationType)); + writer.print(" "); + } + + // Write out the method access flags. + writer.print(ClassUtil.externalMethodAccessFlags(memberSpecification.requiredUnsetAccessFlags, + ConfigurationConstants.NEGATOR_KEYWORD)); + + writer.print(ClassUtil.externalMethodAccessFlags(memberSpecification.requiredSetAccessFlags)); + + // Write out the method name and descriptor. + String name = memberSpecification.name; + String descriptor = memberSpecification.descriptor; + + writer.print(descriptor == null ? name == null ? + ConfigurationConstants.ANY_METHOD_KEYWORD : + ConfigurationConstants.ANY_TYPE_KEYWORD + ' ' + name + ConfigurationConstants.OPEN_ARGUMENTS_KEYWORD + ConfigurationConstants.ANY_ARGUMENTS_KEYWORD + ConfigurationConstants.CLOSE_ARGUMENTS_KEYWORD : + ClassUtil.externalFullMethodDescription(ClassConstants.INTERNAL_METHOD_NAME_INIT, + 0, + name == null ? ConfigurationConstants.ANY_CLASS_MEMBER_KEYWORD : name, + descriptor)); + + writer.println(ConfigurationConstants.SEPARATOR_KEYWORD); + } + } + } + + + /** + * Returns a relative file name of the given file, if possible. + * The file name is also quoted, if necessary. + */ + private String relativeFileName(File file) + { + String fileName = file.getAbsolutePath(); + + // See if we can convert the file name into a relative file name. + if (baseDir != null) + { + String baseDirName = baseDir.getAbsolutePath() + File.separator; + if (fileName.startsWith(baseDirName)) + { + fileName = fileName.substring(baseDirName.length()); + } + } + + return quotedString(fileName); + } + + + /** + * Returns a quoted version of the given string, if necessary. + */ + private String quotedString(String string) + { + return string.length() == 0 || + string.indexOf(' ') >= 0 || + string.indexOf('@') >= 0 || + string.indexOf('{') >= 0 || + string.indexOf('}') >= 0 || + string.indexOf('(') >= 0 || + string.indexOf(')') >= 0 || + string.indexOf(':') >= 0 || + string.indexOf(';') >= 0 || + string.indexOf(',') >= 0 ? ("'" + string + "'") : + ( string ); + } + + + /** + * A main method for testing configuration writing. + */ + public static void main(String[] args) { + try + { + ConfigurationWriter writer = new ConfigurationWriter(new File(args[0])); + + writer.write(new Configuration()); + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/DataEntryReaderFactory.java b/src/proguard/DataEntryReaderFactory.java new file mode 100644 index 0000000..a9724b5 --- /dev/null +++ b/src/proguard/DataEntryReaderFactory.java @@ -0,0 +1,155 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.io.*; +import proguard.util.*; + +import java.util.List; + + +/** + * This class can create DataEntryReader instances based on class path entries. + * The readers will unwrap the input data entries from any jars, wars, ears, + * and zips, before passing them to a given reader. + * + * @author Eric Lafortune + */ +public class DataEntryReaderFactory +{ + /** + * Creates a DataEntryReader that can read the given class path entry. + * + * @param messagePrefix a prefix for messages that are printed out. + * @param classPathEntry the input class path entry. + * @param reader a data entry reader to which the reading of actual + * classes and resource files can be delegated. + * @return a DataEntryReader for reading the given class path entry. + */ + public static DataEntryReader createDataEntryReader(String messagePrefix, + ClassPathEntry classPathEntry, + DataEntryReader reader) + { + String entryName = classPathEntry.getName(); + boolean isJar = endsWithIgnoreCase(entryName, ".jar"); + boolean isWar = endsWithIgnoreCase(entryName, ".war"); + boolean isEar = endsWithIgnoreCase(entryName, ".ear"); + boolean isZip = endsWithIgnoreCase(entryName, ".zip"); + + List filter = classPathEntry.getFilter(); + List jarFilter = classPathEntry.getJarFilter(); + List warFilter = classPathEntry.getWarFilter(); + List earFilter = classPathEntry.getEarFilter(); + List zipFilter = classPathEntry.getZipFilter(); + + System.out.println(messagePrefix + + (isJar ? "jar" : + isWar ? "war" : + isEar ? "ear" : + isZip ? "zip" : + "directory") + + " [" + classPathEntry.getName() + "]" + + (filter != null || + jarFilter != null || + warFilter != null || + earFilter != null || + zipFilter != null ? " (filtered)" : "")); + + // Add a filter, if specified. + if (filter != null) + { + reader = new FilteredDataEntryReader( + new DataEntryNameFilter( + new ListParser(new FileNameParser()).parse(filter)), + reader); + } + + // Unzip any jars, if necessary. + reader = wrapInJarReader(reader, isJar, jarFilter, ".jar"); + if (!isJar) + { + // Unzip any wars, if necessary. + reader = wrapInJarReader(reader, isWar, warFilter, ".war"); + if (!isWar) + { + // Unzip any ears, if necessary. + reader = wrapInJarReader(reader, isEar, earFilter, ".ear"); + if (!isEar) + { + // Unzip any zips, if necessary. + reader = wrapInJarReader(reader, isZip, zipFilter, ".zip"); + } + } + } + + return reader; + } + + + /** + * Wraps the given DataEntryReader in a JarReader, filtering it if necessary. + */ + private static DataEntryReader wrapInJarReader(DataEntryReader reader, + boolean isJar, + List jarFilter, + String jarExtension) + { + // Unzip any jars, if necessary. + DataEntryReader jarReader = new JarReader(reader); + + if (isJar) + { + // Always unzip. + return jarReader; + } + else + { + // Add a filter, if specified. + if (jarFilter != null) + { + jarReader = new FilteredDataEntryReader( + new DataEntryNameFilter( + new ListParser(new FileNameParser()).parse(jarFilter)), + jarReader); + } + + // Only unzip the right type of jars. + return new FilteredDataEntryReader( + new DataEntryNameFilter( + new ExtensionMatcher(jarExtension)), + jarReader, + reader); + } + } + + + /** + * Returns whether the given string ends with the given suffix, ignoring its + * case. + */ + private static boolean endsWithIgnoreCase(String string, String suffix) + { + int stringLength = string.length(); + int suffixLength = suffix.length(); + + return string.regionMatches(true, stringLength - suffixLength, suffix, 0, suffixLength); + } +} diff --git a/src/proguard/DataEntryWriterFactory.java b/src/proguard/DataEntryWriterFactory.java new file mode 100644 index 0000000..9fbc6d0 --- /dev/null +++ b/src/proguard/DataEntryWriterFactory.java @@ -0,0 +1,164 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.io.*; +import proguard.util.*; + +import java.util.List; + +/** + * This class can create DataEntryWriter instances based on class paths. The + * writers will wrap the output in the proper jars, wars, ears, and zips. + * + * @author Eric Lafortune + */ +public class DataEntryWriterFactory +{ + /** + * Creates a DataEntryWriter that can write to the given class path entries. + * + * @param classPath the output class path. + * @param fromIndex the start index in the class path. + * @param toIndex the end index in the class path. + * @return a DataEntryWriter for writing to the given class path entries. + */ + public static DataEntryWriter createDataEntryWriter(ClassPath classPath, + int fromIndex, + int toIndex) + { + DataEntryWriter writer = null; + + // Create a chain of writers, one for each class path entry. + for (int index = toIndex - 1; index >= fromIndex; index--) + { + ClassPathEntry entry = classPath.get(index); + writer = createClassPathEntryWriter(entry, writer); + } + + return writer; + } + + + /** + * Creates a DataEntryWriter that can write to the given class path entry, + * or delegate to another DataEntryWriter if its filters don't match. + */ + private static DataEntryWriter createClassPathEntryWriter(ClassPathEntry classPathEntry, + DataEntryWriter alternativeWriter) + { + String entryName = classPathEntry.getName(); + boolean isJar = endsWithIgnoreCase(entryName, ".jar"); + boolean isWar = endsWithIgnoreCase(entryName, ".war"); + boolean isEar = endsWithIgnoreCase(entryName, ".ear"); + boolean isZip = endsWithIgnoreCase(entryName, ".zip"); + + List filter = classPathEntry.getFilter(); + List jarFilter = classPathEntry.getJarFilter(); + List warFilter = classPathEntry.getWarFilter(); + List earFilter = classPathEntry.getEarFilter(); + List zipFilter = classPathEntry.getZipFilter(); + + System.out.println("Preparing output " + + (isJar ? "jar" : + isWar ? "war" : + isEar ? "ear" : + isZip ? "zip" : + "directory") + + " [" + entryName + "]" + + (filter != null || + jarFilter != null || + warFilter != null || + earFilter != null || + zipFilter != null ? " (filtered)" : "")); + + DataEntryWriter writer = new DirectoryWriter(classPathEntry.getFile(), + isJar || + isWar || + isEar || + isZip); + + // Set up the filtered jar writers. + writer = wrapInJarWriter(writer, isZip, zipFilter, ".zip", isJar || isWar || isEar); + writer = wrapInJarWriter(writer, isEar, earFilter, ".ear", isJar || isWar); + writer = wrapInJarWriter(writer, isWar, warFilter, ".war", isJar); + writer = wrapInJarWriter(writer, isJar, jarFilter, ".jar", false); + + // Add a filter, if specified. + writer = filter != null? + new FilteredDataEntryWriter( + new DataEntryNameFilter( + new ListParser(new FileNameParser()).parse(filter)), + writer) : + writer; + + // Let the writer cascade, if specified. + return alternativeWriter != null ? + new CascadingDataEntryWriter(writer, alternativeWriter) : + writer; + } + + + /** + * Wraps the given DataEntryWriter in a JarWriter, filtering if necessary. + */ + private static DataEntryWriter wrapInJarWriter(DataEntryWriter writer, + boolean isJar, + List jarFilter, + String jarExtension, + boolean dontWrap) + { + // Zip up jars, if necessary. + DataEntryWriter jarWriter = dontWrap ? + (DataEntryWriter)new ParentDataEntryWriter(writer) : + (DataEntryWriter)new JarWriter(writer); + + // Add a filter, if specified. + DataEntryWriter filteredJarWriter = jarFilter != null? + new FilteredDataEntryWriter( + new DataEntryParentFilter( + new DataEntryNameFilter( + new ListParser(new FileNameParser()).parse(jarFilter))), + jarWriter) : + jarWriter; + + // Only zip up jars, unless the output is a jar file itself. + return new FilteredDataEntryWriter( + new DataEntryParentFilter( + new DataEntryNameFilter( + new ExtensionMatcher(jarExtension))), + filteredJarWriter, + isJar ? jarWriter : writer); + } + + + /** + * Returns whether the given string ends with the given suffix, ignoring its + * case. + */ + private static boolean endsWithIgnoreCase(String string, String suffix) + { + int stringLength = string.length(); + int suffixLength = suffix.length(); + + return string.regionMatches(true, stringLength - suffixLength, suffix, 0, suffixLength); + } +} diff --git a/src/proguard/DescriptorKeepChecker.java b/src/proguard/DescriptorKeepChecker.java new file mode 100644 index 0000000..1dfaf1a --- /dev/null +++ b/src/proguard/DescriptorKeepChecker.java @@ -0,0 +1,163 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.optimize.KeepMarker; + +import java.util.List; + + +/** + * This class checks whether classes referenced by class members that are + * marked to be kept are marked to be kept too. + * + * @author Eric Lafortune + */ +public class DescriptorKeepChecker +extends SimplifiedVisitor +implements MemberVisitor, + ClassVisitor +{ + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + private final WarningPrinter notePrinter; + + // Some fields acting as parameters for the class visitor. + private Clazz referencingClass; + private Member referencingMember; + private boolean isField; + + + /** + * Creates a new DescriptorKeepChecker. + */ + public DescriptorKeepChecker(ClassPool programClassPool, + ClassPool libraryClassPool, + WarningPrinter notePrinter) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + this.notePrinter = notePrinter; + } + + + /** + * Checks the classes mentioned in the given keep specifications, printing + * notes if necessary. Returns the number of notes printed. + */ + public void checkClassSpecifications(List keepSpecifications) + { + // Clean up any old visitor info. + programClassPool.classesAccept(new ClassCleaner()); + libraryClassPool.classesAccept(new ClassCleaner()); + + // Create a visitor for marking the seeds. + KeepMarker keepMarker = new KeepMarker(); + ClassPoolVisitor classPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(keepSpecifications, + keepMarker, + keepMarker, + false, + true, + true); + // Mark the seeds. + programClassPool.accept(classPoolvisitor); + libraryClassPool.accept(classPoolvisitor); + + // Print out notes about argument types that are not being kept. + programClassPool.classesAccept(new AllMemberVisitor(this)); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (KeepMarker.isKept(programField)) + { + referencingClass = programClass; + referencingMember = programField; + isField = true; + + // Don't check the type, because it is not required for introspection. + //programField.referencedClassesAccept(this); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (KeepMarker.isKept(programMethod)) + { + referencingClass = programClass; + referencingMember = programMethod; + isField = false; + + // Don't check the return type, because it is not required for + // introspection (e.g. the return type of the special Enum methods). + //programMethod.referencedClassesAccept(this); + + Clazz[] referencedClasses = programMethod.referencedClasses; + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length-1; index++) + { + if (referencedClasses[index] != null) + { + referencedClasses[index].accept(this); + } + } + } + } + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (!KeepMarker.isKept(programClass)) + { + notePrinter.print(referencingClass.getName(), + programClass.getName(), + "Note: the configuration keeps the entry point '" + + ClassUtil.externalClassName(referencingClass.getName()) + + " { " + + (isField ? + ClassUtil.externalFullFieldDescription(0, + referencingMember.getName(referencingClass), + referencingMember.getDescriptor(referencingClass)) : + ClassUtil.externalFullMethodDescription(referencingClass.getName(), + 0, + referencingMember.getName(referencingClass), + referencingMember.getDescriptor(referencingClass))) + + "; }', but not the descriptor class '" + + ClassUtil.externalClassName(programClass.getName()) + + "'"); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) {} +} diff --git a/src/proguard/DuplicateClassPrinter.java b/src/proguard/DuplicateClassPrinter.java new file mode 100644 index 0000000..21b6aa0 --- /dev/null +++ b/src/proguard/DuplicateClassPrinter.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor writes out notes about the class files that it visits + * being duplicates. + * + * @author Eric Lafortune + */ +public class DuplicateClassPrinter implements ClassVisitor +{ + private final WarningPrinter notePrinter; + + + /** + * Creates a new DuplicateClassVisitor. + */ + public DuplicateClassPrinter(WarningPrinter notePrinter) + { + this.notePrinter = notePrinter; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + notePrinter.print(programClass.getName(), + "Note: duplicate definition of program class [" + + ClassUtil.externalClassName(programClass.getName()) + "]"); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + notePrinter.print(libraryClass.getName(), + "Note: duplicate definition of library class [" + + ClassUtil.externalClassName(libraryClass.getName()) + "]"); + } +} diff --git a/src/proguard/FileWordReader.java b/src/proguard/FileWordReader.java new file mode 100644 index 0000000..fb9fa50 --- /dev/null +++ b/src/proguard/FileWordReader.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.*; +import java.net.URL; + + +/** + * A WordReader that returns words from a file or a URL. + * + * @author Eric Lafortune + */ +public class FileWordReader extends WordReader +{ + private final String name; + private LineNumberReader reader; + + + /** + * Creates a new FileWordReader for the given file. + */ + public FileWordReader(File file) throws IOException + { + super(file.getParentFile()); + + this.name = file.getPath(); + this.reader = new LineNumberReader( + new BufferedReader( + new FileReader(file))); + } + + + /** + * Creates a new FileWordReader for the given URL. + */ + public FileWordReader(URL url) throws IOException + { + super(null); + + this.name = url.toString(); + this.reader = new LineNumberReader( + new BufferedReader( + new InputStreamReader(url.openStream()))); + } + + + // Implementations for WordReader. + + protected String nextLine() throws IOException + { + return reader.readLine(); + } + + + protected String lineLocationDescription() + { + return "line " + reader.getLineNumber() + " of file '" + name + "'"; + } + + + public void close() throws IOException + { + super.close(); + + if (reader != null) + { + reader.close(); + } + } +} diff --git a/src/proguard/FullyQualifiedClassNameChecker.java b/src/proguard/FullyQualifiedClassNameChecker.java new file mode 100644 index 0000000..06949b5 --- /dev/null +++ b/src/proguard/FullyQualifiedClassNameChecker.java @@ -0,0 +1,190 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +import java.util.List; + +/** + * This class checks if the user has forgotten to fully qualify any classes + * in the configuration. + * + * @author Eric Lafortune + */ +public class FullyQualifiedClassNameChecker +extends SimplifiedVisitor +implements ClassVisitor +{ + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + private final WarningPrinter notePrinter; + + + /** + * Creates a new DescriptorKeepChecker. + */ + public FullyQualifiedClassNameChecker(ClassPool programClassPool, + ClassPool libraryClassPool, + WarningPrinter notePrinter) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + this.notePrinter = notePrinter; + } + + + /** + * Checks the classes mentioned in the given class specifications, printing + * notes if necessary. Returns the number of notes printed. + */ + public void checkClassSpecifications(List classSpecifications) + { + if (classSpecifications != null) + { + for (int index = 0; index < classSpecifications.size(); index++) + { + ClassSpecification classSpecification = + (ClassSpecification)classSpecifications.get(index); + + checkType(classSpecification.annotationType); + checkClassName(classSpecification.className); + checkType(classSpecification.extendsAnnotationType); + checkClassName(classSpecification.extendsClassName); + + checkMemberSpecifications(classSpecification.fieldSpecifications, true); + checkMemberSpecifications(classSpecification.methodSpecifications, false); + } + } + } + + + /** + * Checks the classes mentioned in the given class member specifications, + * printing notes if necessary. + */ + private void checkMemberSpecifications(List memberSpecifications, boolean isField) + { + if (memberSpecifications != null) + { + for (int index = 0; index < memberSpecifications.size(); index++) + { + MemberSpecification memberSpecification = + (MemberSpecification)memberSpecifications.get(index); + + checkType(memberSpecification.annotationType); + + if (isField) + { + checkType(memberSpecification.descriptor); + } + else + { + checkDescriptor(memberSpecification.descriptor); + } + } + } + } + + + /** + * Checks the classes mentioned in the given class member descriptor, + * printing notes if necessary. + */ + private void checkDescriptor(String descriptor) + { + if (descriptor != null) + { + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + checkType(internalTypeEnumeration.returnType()); + + while (internalTypeEnumeration.hasMoreTypes()) + { + checkType(internalTypeEnumeration.nextType()); + } + } + } + + + /** + * Checks the class mentioned in the given type (if any), + * printing notes if necessary. + */ + private void checkType(String type) + { + if (type != null) + { + checkClassName(ClassUtil.internalClassNameFromType(type)); + } + } + + + /** + * Checks the specified class (if any), + * printing notes if necessary. + */ + private void checkClassName(String className) + { + if (className != null && + !containsWildCards(className) && + programClassPool.getClass(className) == null && + libraryClassPool.getClass(className) == null && + notePrinter.accepts(className)) + { + notePrinter.print(className, + "Note: the configuration refers to the unknown class '" + + ClassUtil.externalClassName(className) + "'"); + + String fullyQualifiedClassName = + "**" + ClassConstants.INTERNAL_PACKAGE_SEPARATOR + + className.substring(className.lastIndexOf(ClassConstants.INTERNAL_PACKAGE_SEPARATOR)+1); + + ClassNameFilter classNameFilter = + new ClassNameFilter(fullyQualifiedClassName, this); + + programClassPool.classesAccept(classNameFilter); + libraryClassPool.classesAccept(classNameFilter); + } + } + + + private static boolean containsWildCards(String string) + { + return string != null && + (string.indexOf('*') >= 0 || + string.indexOf('?') >= 0 || + string.indexOf(',') >= 0 || + string.indexOf("///") >= 0); + } + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + System.out.println(" Maybe you meant the fully qualified name '" + + ClassUtil.externalClassName(clazz.getName()) + "'?"); + } +} diff --git a/src/proguard/GPL.java b/src/proguard/GPL.java new file mode 100644 index 0000000..272a837 --- /dev/null +++ b/src/proguard/GPL.java @@ -0,0 +1,191 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.*; +import java.util.*; + +/** + * This class checks and prints out information about the GPL. + * + * @author Eric Lafortune + */ +public class GPL +{ + /** + * Prints out a note about the GPL if ProGuard is linked against unknown + * code. + */ + public static void check() + { + ByteArrayOutputStream out = new ByteArrayOutputStream(); + new Exception().printStackTrace(new PrintStream(out)); + LineNumberReader reader = new LineNumberReader( + new InputStreamReader( + new ByteArrayInputStream(out.toByteArray()))); + + Set unknownPackageNames = unknownPackageNames(reader); + + if (unknownPackageNames.size() > 0) + { + String uniquePackageNames = uniquePackageNames(unknownPackageNames); + + System.out.println("ProGuard is released under the GNU General Public License. The authors of all"); + System.out.println("programs or plugins that link to it ("+uniquePackageNames+"...) therefore"); + System.out.println("must ensure that these programs carry the GNU General Public License as well."); + } + } + + + /** + * Returns a set of package names from the given stack trace. + */ + private static Set unknownPackageNames(LineNumberReader reader) + { + Set packageNames = new HashSet(); + + try + { + while (true) + { + String line = reader.readLine(); + if (line == null) + { + break; + } + + line = line.trim(); + if (line.startsWith("at ")) + { + line = line.substring(2).trim(); + line = trimSuffix(line, '('); + line = trimSuffix(line, '.'); + line = trimSuffix(line, '.'); + + if (line.length() > 0 && !isKnown(line)) + { + packageNames.add(line); + } + } + } + } + catch (IOException ex) + { + // We'll just stop looking for more names. + } + + return packageNames; + } + + + /** + * Returns a comma-separated list of package names from the set, excluding + * any subpackages of packages in the set. + */ + private static String uniquePackageNames(Set packageNames) + { + StringBuffer buffer = new StringBuffer(); + + Iterator iterator = packageNames.iterator(); + while (iterator.hasNext()) + { + String packageName = (String)iterator.next(); + if (!containsPrefix(packageNames, packageName)) + { + buffer.append(packageName).append(", "); + } + } + + return buffer.toString(); + } + + + /** + * Returns a given string without the suffix, as defined by the given + * separator. + */ + private static String trimSuffix(String string, char separator) + { + int index = string.lastIndexOf(separator); + return index < 0 ? "" : string.substring(0, index); + } + + + /** + * Returns whether the given set contains a prefix of the given name. + */ + private static boolean containsPrefix(Set set, String name) + { + int index = 0; + + while (!set.contains(name.substring(0, index))) + { + index = name.indexOf('.', index + 1); + if (index < 0) + { + return false; + } + } + + return true; + } + + + /** + * Returns whether the given package name has been granted an exception + * against the GPL linking clause, by the copyright holder of ProGuard. + * This method is not legally binding, but of course the actual license is. + * Please contact the copyright holder if you would like an exception for + * your code as well. + */ + private static boolean isKnown(String packageName) + { + return packageName.startsWith("java") || + packageName.startsWith("sun.reflect") || + packageName.startsWith("proguard") || + packageName.startsWith("org.apache.tools.ant") || + packageName.startsWith("org.apache.tools.maven") || + packageName.startsWith("org.eclipse") || + packageName.startsWith("org.netbeans") || + packageName.startsWith("com.sun.kvem") || + packageName.startsWith("net.certiv.proguarddt") || + packageName.startsWith("eclipseme") || + packageName.startsWith("jg.j2me") || + packageName.startsWith("jg.common") || + packageName.startsWith("jg.buildengine"); + } + + + public static void main(String[] args) + { + LineNumberReader reader = new LineNumberReader( + new InputStreamReader(System.in)); + + Set unknownPackageNames = unknownPackageNames(reader); + + if (unknownPackageNames.size() > 0) + { + String uniquePackageNames = uniquePackageNames(unknownPackageNames); + + System.out.println(uniquePackageNames); + } + } +} diff --git a/src/proguard/Initializer.java b/src/proguard/Initializer.java new file mode 100644 index 0000000..41cf971 --- /dev/null +++ b/src/proguard/Initializer.java @@ -0,0 +1,411 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassPool; +import proguard.classfile.attribute.visitor.AllAttributeVisitor; +import proguard.classfile.constant.visitor.*; +import proguard.classfile.instruction.visitor.AllInstructionVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.util.*; + +import java.io.IOException; +import java.util.*; + +/** + * This class initializes class pools. + * + * @author Eric Lafortune + */ +public class Initializer +{ + private final Configuration configuration; + + + /** + * Creates a new Initializer to initialize classes according to the given + * configuration. + */ + public Initializer(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Initializes the classes in the given program class pool and library class + * pool, performs some basic checks, and shrinks the library class pool. + */ + public void execute(ClassPool programClassPool, + ClassPool libraryClassPool) throws IOException + { + int originalLibraryClassPoolSize = libraryClassPool.size(); + + // Construct a reduced library class pool with only those library + // classes whose hierarchies are referenced by the program classes. + // We can't do this if we later have to come up with the obfuscated + // class member names that are globally unique. + ClassPool reducedLibraryClassPool = configuration.useUniqueClassMemberNames ? + null : new ClassPool(); + + WarningPrinter classReferenceWarningPrinter = new WarningPrinter(System.err, configuration.warn); + WarningPrinter dependencyWarningPrinter = new WarningPrinter(System.err, configuration.warn); + + // Initialize the superclass hierarchies for program classes. + programClassPool.classesAccept( + new ClassSuperHierarchyInitializer(programClassPool, + libraryClassPool, + classReferenceWarningPrinter, + null)); + + // Initialize the superclass hierarchy of all library classes, without + // warnings. + libraryClassPool.classesAccept( + new ClassSuperHierarchyInitializer(programClassPool, + libraryClassPool, + null, + dependencyWarningPrinter)); + + // Initialize the class references of program class members and + // attributes. Note that all superclass hierarchies have to be + // initialized for this purpose. + WarningPrinter memberReferenceWarningPrinter = new WarningPrinter(System.err, configuration.warn); + + programClassPool.classesAccept( + new ClassReferenceInitializer(programClassPool, + libraryClassPool, + classReferenceWarningPrinter, + memberReferenceWarningPrinter, + null)); + + if (reducedLibraryClassPool != null) + { + // Collect the library classes that are directly referenced by + // program classes, without introspection. + programClassPool.classesAccept( + new ReferencedClassVisitor( + new LibraryClassFilter( + new ClassPoolFiller(reducedLibraryClassPool)))); + + // Reinitialize the superclass hierarchies of referenced library + // classes, this time with warnings. + reducedLibraryClassPool.classesAccept( + new ClassSuperHierarchyInitializer(programClassPool, + libraryClassPool, + classReferenceWarningPrinter, + null)); + } + + // Initialize the Class.forName references. + WarningPrinter dynamicClassReferenceNotePrinter = new WarningPrinter(System.out, configuration.note); + WarningPrinter classForNameNotePrinter = new WarningPrinter(System.out, configuration.note); + + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new AllInstructionVisitor( + new DynamicClassReferenceInitializer(programClassPool, + libraryClassPool, + dynamicClassReferenceNotePrinter, + null, + classForNameNotePrinter, + createClassNoteExceptionMatcher(configuration.keep)))))); + + // Initialize the Class.get[Declared]{Field,Method} references. + WarningPrinter getMemberNotePrinter = new WarningPrinter(System.out, configuration.note); + + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new AllInstructionVisitor( + new DynamicMemberReferenceInitializer(programClassPool, + libraryClassPool, + getMemberNotePrinter, + createClassMemberNoteExceptionMatcher(configuration.keep, true), + createClassMemberNoteExceptionMatcher(configuration.keep, false)))))); + + // Initialize other string constant references, if requested. + if (configuration.adaptClassStrings != null) + { + programClassPool.classesAccept( + new ClassNameFilter(configuration.adaptClassStrings, + new AllConstantVisitor( + new StringReferenceInitializer(programClassPool, + libraryClassPool)))); + } + + // Print various notes, if specified. + WarningPrinter fullyQualifiedClassNameNotePrinter = new WarningPrinter(System.out, configuration.note); + WarningPrinter descriptorKeepNotePrinter = new WarningPrinter(System.out, configuration.note); + + new FullyQualifiedClassNameChecker(programClassPool, + libraryClassPool, + fullyQualifiedClassNameNotePrinter).checkClassSpecifications(configuration.keep); + + new DescriptorKeepChecker(programClassPool, + libraryClassPool, + descriptorKeepNotePrinter).checkClassSpecifications(configuration.keep); + + // Initialize the class references of library class members. + if (reducedLibraryClassPool != null) + { + // Collect the library classes that are referenced by program + // classes, directly or indirectly, with or without introspection. + programClassPool.classesAccept( + new ReferencedClassVisitor( + new LibraryClassFilter( + new ClassHierarchyTraveler(true, true, true, false, + new LibraryClassFilter( + new ClassPoolFiller(reducedLibraryClassPool)))))); + + // Initialize the class references of referenced library + // classes, without warnings. + reducedLibraryClassPool.classesAccept( + new ClassReferenceInitializer(programClassPool, + libraryClassPool, + null, + null, + dependencyWarningPrinter)); + + // Reset the library class pool. + libraryClassPool.clear(); + + // Copy the library classes that are referenced directly by program + // classes and the library classes that are referenced by referenced + // library classes. + reducedLibraryClassPool.classesAccept( + new MultiClassVisitor(new ClassVisitor[] + { + new ClassHierarchyTraveler(true, true, true, false, + new LibraryClassFilter( + new ClassPoolFiller(libraryClassPool))), + + new ReferencedClassVisitor( + new LibraryClassFilter( + new ClassHierarchyTraveler(true, true, true, false, + new LibraryClassFilter( + new ClassPoolFiller(libraryClassPool))))) + })); + } + else + { + // Initialize the class references of all library class members. + libraryClassPool.classesAccept( + new ClassReferenceInitializer(programClassPool, + libraryClassPool, + null, + null, + dependencyWarningPrinter)); + } + + // Initialize the subclass hierarchies. + programClassPool.classesAccept(new ClassSubHierarchyInitializer()); + libraryClassPool.classesAccept(new ClassSubHierarchyInitializer()); + + // Share strings between the classes, to reduce heap memory usage. + programClassPool.classesAccept(new StringSharer()); + libraryClassPool.classesAccept(new StringSharer()); + + // Print out a summary of the notes, if necessary. + int fullyQualifiedNoteCount = fullyQualifiedClassNameNotePrinter.getWarningCount(); + if (fullyQualifiedNoteCount > 0) + { + System.out.println("Note: there were " + fullyQualifiedNoteCount + + " references to unknown classes."); + System.out.println(" You should check your configuration for typos."); + } + + int descriptorNoteCount = descriptorKeepNotePrinter.getWarningCount(); + if (descriptorNoteCount > 0) + { + System.out.println("Note: there were " + descriptorNoteCount + + " unkept descriptor classes in kept class members."); + System.out.println(" You should consider explicitly keeping the mentioned classes"); + System.out.println(" (using '-keep')."); + } + + int dynamicClassReferenceNoteCount = dynamicClassReferenceNotePrinter.getWarningCount(); + if (dynamicClassReferenceNoteCount > 0) + { + System.out.println("Note: there were " + dynamicClassReferenceNoteCount + + " unresolved dynamic references to classes or interfaces."); + System.err.println(" You should check if you need to specify additional program jars."); + } + + int classForNameNoteCount = classForNameNotePrinter.getWarningCount(); + if (classForNameNoteCount > 0) + { + System.out.println("Note: there were " + classForNameNoteCount + + " class casts of dynamically created class instances."); + System.out.println(" You might consider explicitly keeping the mentioned classes and/or"); + System.out.println(" their implementations (using '-keep')."); + } + + int getmemberNoteCount = getMemberNotePrinter.getWarningCount(); + if (getmemberNoteCount > 0) + { + System.out.println("Note: there were " + getmemberNoteCount + + " accesses to class members by means of introspection."); + System.out.println(" You should consider explicitly keeping the mentioned class members"); + System.out.println(" (using '-keep' or '-keepclassmembers')."); + } + + // Print out a summary of the warnings, if necessary. + int classReferenceWarningCount = classReferenceWarningPrinter.getWarningCount(); + if (classReferenceWarningCount > 0) + { + System.err.println("Warning: there were " + classReferenceWarningCount + + " unresolved references to classes or interfaces."); + System.err.println(" You may need to specify additional library jars (using '-libraryjars'),"); + System.err.println(" or perhaps the '-dontskipnonpubliclibraryclasses' option."); + } + + int dependencyWarningCount = dependencyWarningPrinter.getWarningCount(); + if (dependencyWarningCount > 0) + { + System.err.println("Warning: there were " + dependencyWarningCount + + " instances of library classes depending on program classes."); + System.err.println(" You must avoid such dependencies, since the program classes will"); + System.err.println(" be processed, while the library classes will remain unchanged."); + } + + int memberReferenceWarningCount = memberReferenceWarningPrinter.getWarningCount(); + if (memberReferenceWarningCount > 0) + { + System.err.println("Warning: there were " + memberReferenceWarningCount + + " unresolved references to program class members."); + System.err.println(" Your input classes appear to be inconsistent."); + System.err.println(" You may need to recompile them and try again."); + System.err.println(" Alternatively, you may have to specify the options "); + System.err.println(" '-dontskipnonpubliclibraryclasses' and/or"); + System.err.println(" '-dontskipnonpubliclibraryclassmembers'."); + } + + if ((classReferenceWarningCount > 0 || + dependencyWarningCount > 0 || + memberReferenceWarningCount > 0) && + !configuration.ignoreWarnings) + { + throw new IOException("Please correct the above warnings first."); + } + + if ((configuration.note == null || + !configuration.note.isEmpty()) && + (configuration.warn != null && + configuration.warn.isEmpty() || + configuration.ignoreWarnings)) + { + System.out.println("Note: You're ignoring all warnings!"); + } + + // Discard unused library classes. + if (configuration.verbose) + { + System.out.println("Ignoring unused library classes..."); + System.out.println(" Original number of library classes: " + originalLibraryClassPoolSize); + System.out.println(" Final number of library classes: " + libraryClassPool.size()); + } + } + + + /** + * Extracts a list of exceptions of classes for which not to print notes, + * from the keep configuration. + */ + private StringMatcher createClassNoteExceptionMatcher(List noteExceptions) + { + if (noteExceptions != null) + { + List noteExceptionNames = new ArrayList(noteExceptions.size()); + for (int index = 0; index < noteExceptions.size(); index++) + { + KeepClassSpecification keepClassSpecification = (KeepClassSpecification)noteExceptions.get(index); + if (keepClassSpecification.markClasses) + { + // If the class itself is being kept, it's ok. + String className = keepClassSpecification.className; + if (className != null) + { + noteExceptionNames.add(className); + } + + // If all of its extensions are being kept, it's ok too. + String extendsClassName = keepClassSpecification.extendsClassName; + if (extendsClassName != null) + { + noteExceptionNames.add(extendsClassName); + } + } + } + + if (noteExceptionNames.size() > 0) + { + return new ListParser(new ClassNameParser()).parse(noteExceptionNames); + } + } + + return null; + } + + + /** + * Extracts a list of exceptions of field or method names for which not to + * print notes, from the keep configuration. + */ + private StringMatcher createClassMemberNoteExceptionMatcher(List noteExceptions, + boolean isField) + { + if (noteExceptions != null) + { + List noteExceptionNames = new ArrayList(); + for (int index = 0; index < noteExceptions.size(); index++) + { + KeepClassSpecification keepClassSpecification = (KeepClassSpecification)noteExceptions.get(index); + List memberSpecifications = isField ? + keepClassSpecification.fieldSpecifications : + keepClassSpecification.methodSpecifications; + + if (memberSpecifications != null) + { + for (int index2 = 0; index2 < memberSpecifications.size(); index2++) + { + MemberSpecification memberSpecification = + (MemberSpecification)memberSpecifications.get(index2); + + String memberName = memberSpecification.name; + if (memberName != null) + { + noteExceptionNames.add(memberName); + } + } + } + } + + if (noteExceptionNames.size() > 0) + { + return new ListParser(new ClassNameParser()).parse(noteExceptionNames); + } + } + + return null; + } +} diff --git a/src/proguard/InputReader.java b/src/proguard/InputReader.java new file mode 100644 index 0000000..c088324 --- /dev/null +++ b/src/proguard/InputReader.java @@ -0,0 +1,233 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassPool; +import proguard.classfile.util.WarningPrinter; +import proguard.classfile.visitor.*; +import proguard.io.*; + +import java.io.IOException; + +/** + * This class reads the input class files. + * + * @author Eric Lafortune + */ +public class InputReader +{ + private final Configuration configuration; + + + /** + * Creates a new InputReader to read input class files as specified by the + * given configuration. + */ + public InputReader(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Fills the given program class pool and library class pool by reading + * class files, based on the current configuration. + */ + public void execute(ClassPool programClassPool, + ClassPool libraryClassPool) throws IOException + { + // Check if we have at least some input classes. + if (configuration.programJars == null) + { + throw new IOException("The input is empty. You have to specify one or more '-injars' options"); + } + + // Perform some sanity checks on the class paths. + checkInputOutput(configuration.libraryJars, + configuration.programJars); + checkInputOutput(configuration.programJars, + configuration.programJars); + + WarningPrinter warningPrinter = new WarningPrinter(System.err, configuration.warn); + WarningPrinter notePrinter = new WarningPrinter(System.out, configuration.note); + + DuplicateClassPrinter duplicateClassPrinter = new DuplicateClassPrinter(notePrinter); + + // Read the program class files. + // Prepare a data entry reader to filter all classes, + // which are then decoded to classes by a class reader, + // which are then put in the class pool by a class pool filler. + readInput("Reading program ", + configuration.programJars, + new ClassFilter( + new ClassReader(false, + configuration.skipNonPublicLibraryClasses, + configuration.skipNonPublicLibraryClassMembers, + warningPrinter, + new ClassPresenceFilter(programClassPool, duplicateClassPrinter, + new ClassPoolFiller(programClassPool))))); + + // Check if we have at least some input classes. + if (programClassPool.size() == 0) + { + throw new IOException("The input doesn't contain any classes. Did you specify the proper '-injars' options?"); + } + + // Read the library class files, if any. + if (configuration.libraryJars != null) + { + // Prepare a data entry reader to filter all classes, + // which are then decoded to classes by a class reader, + // which are then put in the class pool by a class pool filler. + readInput("Reading library ", + configuration.libraryJars, + new ClassFilter( + new ClassReader(true, + configuration.skipNonPublicLibraryClasses, + configuration.skipNonPublicLibraryClassMembers, + warningPrinter, + new ClassPresenceFilter(programClassPool, duplicateClassPrinter, + new ClassPresenceFilter(libraryClassPool, duplicateClassPrinter, + new ClassPoolFiller(libraryClassPool)))))); + } + + // Print out a summary of the notes, if necessary. + int noteCount = notePrinter.getWarningCount(); + if (noteCount > 0) + { + System.err.println("Note: there were " + noteCount + + " duplicate class definitions."); + } + + // Print out a summary of the warnings, if necessary. + int warningCount = warningPrinter.getWarningCount(); + if (warningCount > 0) + { + System.err.println("Warning: there were " + warningCount + + " classes in incorrectly named files."); + System.err.println(" You should make sure all file names correspond to their class names."); + System.err.println(" The directory hierarchies must correspond to the package hierarchies."); + + if (!configuration.ignoreWarnings) + { + System.err.println(" If you don't mind the mentioned classes not being written out,"); + System.err.println(" you could try your luck using the '-ignorewarnings' option."); + throw new IOException("Please correct the above warnings first."); + } + } + } + + + /** + * Performs some sanity checks on the class paths. + */ + private void checkInputOutput(ClassPath inputClassPath, + ClassPath outputClassPath) + throws IOException + { + if (inputClassPath == null || + outputClassPath == null) + { + return; + } + + for (int index1 = 0; index1 < inputClassPath.size(); index1++) + { + ClassPathEntry entry1 = inputClassPath.get(index1); + if (!entry1.isOutput()) + { + for (int index2 = 0; index2 < outputClassPath.size(); index2++) + { + ClassPathEntry entry2 = outputClassPath.get(index2); + if (entry2.isOutput() && + entry2.getName().equals(entry1.getName())) + { + throw new IOException("Input jars and output jars must be different ["+entry1.getName()+"]"); + } + } + } + } + } + + + /** + * Reads all input entries from the given class path. + */ + private void readInput(String messagePrefix, + ClassPath classPath, + DataEntryReader reader) throws IOException + { + readInput(messagePrefix, + classPath, + 0, + classPath.size(), + reader); + } + + + /** + * Reads all input entries from the given section of the given class path. + */ + public void readInput(String messagePrefix, + ClassPath classPath, + int fromIndex, + int toIndex, + DataEntryReader reader) throws IOException + { + for (int index = fromIndex; index < toIndex; index++) + { + ClassPathEntry entry = classPath.get(index); + if (!entry.isOutput()) + { + readInput(messagePrefix, entry, reader); + } + } + } + + + /** + * Reads the given input class path entry. + */ + private void readInput(String messagePrefix, + ClassPathEntry classPathEntry, + DataEntryReader dataEntryReader) throws IOException + { + try + { + // Create a reader that can unwrap jars, wars, ears, and zips. + DataEntryReader reader = + DataEntryReaderFactory.createDataEntryReader(messagePrefix, + classPathEntry, + dataEntryReader); + + // Create the data entry pump. + DirectoryPump directoryPump = + new DirectoryPump(classPathEntry.getFile()); + + // Pump the data entries into the reader. + directoryPump.pumpDataEntries(reader); + } + catch (IOException ex) + { + throw new IOException("Can't read [" + classPathEntry + "] (" + ex.getMessage() + ")"); + } + } +} diff --git a/src/proguard/KeepClassSpecification.java b/src/proguard/KeepClassSpecification.java new file mode 100644 index 0000000..29c0d3c --- /dev/null +++ b/src/proguard/KeepClassSpecification.java @@ -0,0 +1,137 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +/** + * This class represents a keep option with class specification. + * + * @author Eric Lafortune + */ +public class KeepClassSpecification extends ClassSpecification +{ + public final boolean markClasses; + public final boolean markConditionally; + public final boolean allowShrinking; + public final boolean allowOptimization; + public final boolean allowObfuscation; + + + /** + * Creates a new KeepClassSpecification for all possible classes. + * @param markClasses specifies whether to mark the classes. + * If false, only class members are marked. + * If true, the classes are marked as well. + * @param markConditionally specifies whether to mark the classes and + * class members conditionally. If true, classes + * and class members are marked, on the condition + * that all specified class members are present. + * @param allowShrinking specifies whether shrinking is allowed. + * @param allowOptimization specifies whether optimization is allowed. + * @param allowObfuscation specifies whether obfuscation is allowed. + */ + public KeepClassSpecification(boolean markClasses, + boolean markConditionally, + boolean allowShrinking, + boolean allowOptimization, + boolean allowObfuscation) + { + this.markClasses = markClasses; + this.markConditionally = markConditionally; + this.allowShrinking = allowShrinking; + this.allowOptimization = allowOptimization; + this.allowObfuscation = allowObfuscation; + } + + + /** + * Creates a new KeepClassSpecification. + * @param markClasses specifies whether to mark the classes. + * If false, only class members are marked. + * If true, the classes are marked as well. + * @param markConditionally specifies whether to mark the classes and + * class members conditionally. If true, classes + * and class members are marked, on the condition + * that all specified class members are present. + * @param allowShrinking specifies whether shrinking is allowed. + * @param allowOptimization specifies whether optimization is allowed. + * @param allowObfuscation specifies whether obfuscation is allowed. + * @param classSpecification the specification of classes and class members. + */ + public KeepClassSpecification(boolean markClasses, + boolean markConditionally, + boolean allowShrinking, + boolean allowOptimization, + boolean allowObfuscation, + ClassSpecification classSpecification) + { + super(classSpecification); + + this.markClasses = markClasses; + this.markConditionally = markConditionally; + this.allowShrinking = allowShrinking; + this.allowOptimization = allowOptimization; + this.allowObfuscation = allowObfuscation; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + KeepClassSpecification other = (KeepClassSpecification)object; + return + this.markClasses == other.markClasses && + this.markConditionally == other.markConditionally && + this.allowShrinking == other.allowShrinking && + this.allowOptimization == other.allowOptimization && + this.allowObfuscation == other.allowObfuscation && + super.equals(other); + } + + public int hashCode() + { + return + (markClasses ? 0 : 1) ^ + (markConditionally ? 0 : 2) ^ + (allowShrinking ? 0 : 4) ^ + (allowOptimization ? 0 : 8) ^ + (allowObfuscation ? 0 : 16) ^ + super.hashCode(); + } + + public Object clone() + { +// try +// { + return super.clone(); +// } +// catch (CloneNotSupportedException e) +// { +// return null; +// } + } +} diff --git a/src/proguard/MANIFEST.MF b/src/proguard/MANIFEST.MF new file mode 100644 index 0000000..3bad15e --- /dev/null +++ b/src/proguard/MANIFEST.MF @@ -0,0 +1,2 @@ +Manifest-Version: 1.0 +Main-Class: proguard.ProGuard diff --git a/src/proguard/MemberSpecification.java b/src/proguard/MemberSpecification.java new file mode 100644 index 0000000..1cfa962 --- /dev/null +++ b/src/proguard/MemberSpecification.java @@ -0,0 +1,114 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + + +/** + * This class stores a specification of class members. The specification is + * template-based: the class member names and descriptors can contain wildcards. + * + * @author Eric Lafortune + */ +public class MemberSpecification +{ + public int requiredSetAccessFlags; + public int requiredUnsetAccessFlags; + public final String annotationType; + public final String name; + public final String descriptor; + + + /** + * Creates a new option to keep all possible class members. + */ + public MemberSpecification() + { + this(0, + 0, + null, + null, + null); + } + + + /** + * Creates a new option to keep the specified class member(s). + * + * @param requiredSetAccessFlags the class access flags that must be set + * in order for the class to apply. + * @param requiredUnsetAccessFlags the class access flags that must be unset + * in order for the class to apply. + * @param annotationType the name of the class that must be an + * annotation in order for the class member + * to apply. The name may be null to specify + * that no annotation is required. + * @param name the class member name. The name may be + * null to specify any class member or it + * may contain "*" or "?" wildcards. + * @param descriptor the class member descriptor. The + * descriptor may be null to specify any + * class member or it may contain + * "**", "*", or "?" wildcards. + */ + public MemberSpecification(int requiredSetAccessFlags, + int requiredUnsetAccessFlags, + String annotationType, + String name, + String descriptor) + { + this.requiredSetAccessFlags = requiredSetAccessFlags; + this.requiredUnsetAccessFlags = requiredUnsetAccessFlags; + this.annotationType = annotationType; + this.name = name; + this.descriptor = descriptor; + } + + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + MemberSpecification other = (MemberSpecification)object; + return + (this.requiredSetAccessFlags == other.requiredSetAccessFlags ) && + (this.requiredUnsetAccessFlags == other.requiredUnsetAccessFlags ) && + (this.annotationType == null ? other.annotationType == null : this.annotationType.equals(other.annotationType)) && + (this.name == null ? other.name == null : this.name.equals(other.name) ) && + (this.descriptor == null ? other.descriptor == null : this.descriptor.equals(other.descriptor) ); + } + + public int hashCode() + { + return + (requiredSetAccessFlags ) ^ + (requiredUnsetAccessFlags ) ^ + (annotationType == null ? 0 : annotationType.hashCode()) ^ + (name == null ? 0 : name.hashCode() ) ^ + (descriptor == null ? 0 : descriptor.hashCode() ); + } +} diff --git a/src/proguard/OutputWriter.java b/src/proguard/OutputWriter.java new file mode 100644 index 0000000..10c18fb --- /dev/null +++ b/src/proguard/OutputWriter.java @@ -0,0 +1,256 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassPool; +import proguard.classfile.util.ClassUtil; +import proguard.io.*; + +import java.io.IOException; +import java.util.*; + +/** + * This class writes the output class files. + * + * @author Eric Lafortune + */ +public class OutputWriter +{ + private final Configuration configuration; + + + /** + * Creates a new OutputWriter to write output class files as specified by + * the given configuration. + */ + public OutputWriter(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Writes the given class pool to class files, based on the current + * configuration. + */ + public void execute(ClassPool programClassPool) throws IOException + { + ClassPath programJars = configuration.programJars; + + // Perform a check on the first jar. + ClassPathEntry firstEntry = programJars.get(0); + if (firstEntry.isOutput()) + { + throw new IOException("The output jar [" + firstEntry.getName() + + "] must be specified after an input jar, or it will be empty."); + } + + // Perform some checks on the output jars. + for (int index = 0; index < programJars.size() - 1; index++) + { + ClassPathEntry entry = programJars.get(index); + if (entry.isOutput()) + { + // Check if all but the last output jars have filters. + if (entry.getFilter() == null && + entry.getJarFilter() == null && + entry.getWarFilter() == null && + entry.getEarFilter() == null && + entry.getZipFilter() == null && + programJars.get(index + 1).isOutput()) + { + throw new IOException("The output jar [" + entry.getName() + + "] must have a filter, or all subsequent jars will be empty."); + } + + // Check if the output jar name is different from the input jar names. + for (int inIndex = 0; inIndex < programJars.size(); inIndex++) + { + ClassPathEntry otherEntry = programJars.get(inIndex); + + if (!otherEntry.isOutput() && + entry.getFile().equals(otherEntry.getFile())) + { + throw new IOException("The output jar [" + entry.getName() + + "] must be different from all input jars."); + } + } + } + } + + int firstInputIndex = 0; + int lastInputIndex = 0; + + // Go over all program class path entries. + for (int index = 0; index < programJars.size(); index++) + { + // Is it an input entry? + ClassPathEntry entry = programJars.get(index); + if (!entry.isOutput()) + { + // Remember the index of the last input entry. + lastInputIndex = index; + } + else + { + // Check if this the last output entry in a series. + int nextIndex = index + 1; + if (nextIndex == programJars.size() || + !programJars.get(nextIndex).isOutput()) + { + // Write the processed input entries to the output entries. + writeOutput(programClassPool, + programJars, + firstInputIndex, + lastInputIndex + 1, + nextIndex); + + // Start with the next series of input entries. + firstInputIndex = nextIndex; + } + } + } + } + + + /** + * Transfers the specified input jars to the specified output jars. + */ + private void writeOutput(ClassPool programClassPool, + ClassPath classPath, + int fromInputIndex, + int fromOutputIndex, + int toOutputIndex) + throws IOException + { + try + { + // Construct the writer that can write jars, wars, ears, zips, and + // directories, cascading over the specified output entries. + DataEntryWriter writer = + DataEntryWriterFactory.createDataEntryWriter(classPath, + fromOutputIndex, + toOutputIndex); + + // The writer will be used to write possibly obfuscated class files. + DataEntryReader classRewriter = + new ClassRewriter(programClassPool, writer); + + // The writer will also be used to write resource files. + DataEntryReader resourceCopier = + new DataEntryCopier(writer); + + DataEntryReader resourceRewriter = resourceCopier; + + // Wrap the resource writer with a filter and a data entry rewriter, + // if required. + if (configuration.adaptResourceFileContents != null) + { + resourceRewriter = + new NameFilter(configuration.adaptResourceFileContents, + new NameFilter("META-INF/**", + new ManifestRewriter(programClassPool, writer), + new DataEntryRewriter(programClassPool, writer)), + resourceRewriter); + } + + // Wrap the resource writer with a filter and a data entry renamer, + // if required. + if (configuration.adaptResourceFileNames != null) + { + Map packagePrefixMap = createPackagePrefixMap(programClassPool); + + resourceRewriter = + new NameFilter(configuration.adaptResourceFileNames, + new DataEntryObfuscator(programClassPool, + packagePrefixMap, + resourceRewriter), + resourceRewriter); + } + + DataEntryReader directoryRewriter = null; + + // Wrap the directory writer with a filter and a data entry renamer, + // if required. + if (configuration.keepDirectories != null) + { + Map packagePrefixMap = createPackagePrefixMap(programClassPool); + + directoryRewriter = + new NameFilter(configuration.keepDirectories, + new DataEntryRenamer(packagePrefixMap, + resourceCopier, + resourceCopier)); + } + + // Create the reader that can write class files and copy directories + // and resource files to the main writer. + DataEntryReader reader = + new ClassFilter( classRewriter, + new DirectoryFilter(directoryRewriter, + resourceRewriter)); + + // Go over the specified input entries and write their processed + // versions. + new InputReader(configuration).readInput(" Copying resources from program ", + classPath, + fromInputIndex, + fromOutputIndex, + reader); + + // Close all output entries. + writer.close(); + } + catch (IOException ex) + { + throw new IOException("Can't write [" + classPath.get(fromOutputIndex).getName() + "] (" + ex.getMessage() + ")"); + } + } + + + /** + * Creates a map of old package prefixes to new package prefixes, based on + * the given class pool. + */ + private static Map createPackagePrefixMap(ClassPool classPool) + { + Map PackagePrefixMap = new HashMap(); + + Iterator iterator = classPool.classNames(); + while (iterator.hasNext()) + { + String className = (String)iterator.next(); + String PackagePrefix = ClassUtil.internalPackagePrefix(className); + + String mappedNewPackagePrefix = (String)PackagePrefixMap.get(PackagePrefix); + if (mappedNewPackagePrefix == null || + !mappedNewPackagePrefix.equals(PackagePrefix)) + { + String newClassName = classPool.getClass(className).getName(); + String newPackagePrefix = ClassUtil.internalPackagePrefix(newClassName); + + PackagePrefixMap.put(PackagePrefix, newPackagePrefix); + } + } + + return PackagePrefixMap; + } +} diff --git a/src/proguard/ParseException.java b/src/proguard/ParseException.java new file mode 100644 index 0000000..9294200 --- /dev/null +++ b/src/proguard/ParseException.java @@ -0,0 +1,51 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + + +/** + * This Exception signals that a parse exception of some + * sort has occurred. + * + * @author Eric Lafortune + */ +public class ParseException extends Exception { + + /** + * Constructs a ParseException with null + * as its error detail message. + */ + public ParseException() { + super(); + } + + /** + * Constructs a ParseException with the specified detail + * message. The error message string s can later be + * retrieved by the {@link Throwable#getMessage} + * method of class Throwable. + * + * @param s the detail message. + */ + public ParseException(String s) { + super(s); + } +} diff --git a/src/proguard/ProGuard.java b/src/proguard/ProGuard.java new file mode 100644 index 0000000..8c30e10 --- /dev/null +++ b/src/proguard/ProGuard.java @@ -0,0 +1,519 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassPool; +import proguard.classfile.editor.ClassElementSorter; +import proguard.classfile.visitor.*; +import proguard.obfuscate.Obfuscator; +import proguard.optimize.Optimizer; +import proguard.preverify.*; +import proguard.shrink.Shrinker; + +import java.io.*; + +/** + * Tool for shrinking, optimizing, obfuscating, and preverifying Java classes. + * + * @author Eric Lafortune + */ +public class ProGuard +{ + public static final String VERSION = "ProGuard, version 4.4"; + + private final Configuration configuration; + private ClassPool programClassPool = new ClassPool(); + private final ClassPool libraryClassPool = new ClassPool(); + + + /** + * Creates a new ProGuard object to process jars as specified by the given + * configuration. + */ + public ProGuard(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Performs all subsequent ProGuard operations. + */ + public void execute() throws IOException + { + System.out.println(VERSION); + + GPL.check(); + + if (configuration.printConfiguration != null) + { + printConfiguration(); + } + + if (configuration.programJars != null && + configuration.programJars.hasOutput() && + new UpToDateChecker(configuration).check()) + { + return; + } + + readInput(); + + if (configuration.shrink || + configuration.optimize || + configuration.obfuscate || + configuration.preverify) + { + initialize(); + } + + if (configuration.targetClassVersion != 0) + { + target(); + } + + if (configuration.printSeeds != null) + { + printSeeds(); + } + + if (configuration.shrink) + { + shrink(); + } + + if (configuration.preverify) + { + inlineSubroutines(); + } + + if (configuration.optimize) + { + for (int optimizationPass = 0; + optimizationPass < configuration.optimizationPasses; + optimizationPass++) + { + if (!optimize()) + { + // Stop optimizing if the code doesn't improve any further. + break; + } + + // Shrink again, if we may. + if (configuration.shrink) + { + // Don't print any usage this time around. + configuration.printUsage = null; + configuration.whyAreYouKeeping = null; + + shrink(); + } + } + } + + if (configuration.obfuscate) + { + obfuscate(); + } + + if (configuration.preverify) + { + preverify(); + } + + if (configuration.shrink || + configuration.optimize || + configuration.obfuscate || + configuration.preverify) + { + sortClassElements(); + } + + if (configuration.programJars.hasOutput()) + { + writeOutput(); + } + + if (configuration.dump != null) + { + dump(); + } + } + + + /** + * Prints out the configuration that ProGuard is using. + */ + private void printConfiguration() throws IOException + { + if (configuration.verbose) + { + System.out.println("Printing configuration to [" + fileName(configuration.printConfiguration) + "]..."); + } + + PrintStream ps = createPrintStream(configuration.printConfiguration); + try + { + new ConfigurationWriter(ps).write(configuration); + } + finally + { + closePrintStream(ps); + } + } + + + /** + * Reads the input class files. + */ + private void readInput() throws IOException + { + if (configuration.verbose) + { + System.out.println("Reading input..."); + } + + // Fill the program class pool and the library class pool. + new InputReader(configuration).execute(programClassPool, libraryClassPool); + } + + + /** + * Initializes the cross-references between all classes, performs some + * basic checks, and shrinks the library class pool. + */ + private void initialize() throws IOException + { + if (configuration.verbose) + { + System.out.println("Initializing..."); + } + + new Initializer(configuration).execute(programClassPool, libraryClassPool); + } + + + /** + * Sets that target versions of the program classes. + */ + private void target() throws IOException + { + if (configuration.verbose) + { + System.out.println("Setting target versions..."); + } + + new Targeter(configuration).execute(programClassPool); + } + + + /** + * Prints out classes and class members that are used as seeds in the + * shrinking and obfuscation steps. + */ + private void printSeeds() throws IOException + { + if (configuration.verbose) + { + System.out.println("Printing kept classes, fields, and methods..."); + } + + // Check if we have at least some keep commands. + if (configuration.keep == null) + { + throw new IOException("You have to specify '-keep' options for the shrinking step."); + } + + PrintStream ps = createPrintStream(configuration.printSeeds); + try + { + // Create a visitor for printing out the seeds. We're printing out + // the program elements that are preserved against shrinking, + // optimization, or obfuscation. + SimpleClassPrinter printer = new SimpleClassPrinter(false, ps); + ClassPoolVisitor classPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(configuration.keep, + new ProgramClassFilter(printer), + new ProgramMemberFilter(printer), + true, + true, + true); + + // Print out the seeds. + programClassPool.accept(classPoolvisitor); + libraryClassPool.accept(classPoolvisitor); + } + finally + { + closePrintStream(ps); + } + } + + + /** + * Performs the shrinking step. + */ + private void shrink() throws IOException + { + if (configuration.verbose) + { + System.out.println("Shrinking..."); + + // We'll print out some explanation, if requested. + if (configuration.whyAreYouKeeping != null) + { + System.out.println("Explaining why classes and class members are being kept..."); + } + + // We'll print out the usage, if requested. + if (configuration.printUsage != null) + { + System.out.println("Printing usage to [" + fileName(configuration.printUsage) + "]..."); + } + } + + // Perform the actual shrinking. + programClassPool = + new Shrinker(configuration).execute(programClassPool, libraryClassPool); + } + + + /** + * Performs the subroutine inlining step. + */ + private void inlineSubroutines() + { + if (configuration.verbose) + { + System.out.println("Inlining subroutines..."); + } + + // Perform the actual inlining. + new SubroutineInliner(configuration).execute(programClassPool); + } + + + /** + * Performs the optimization step. + */ + private boolean optimize() throws IOException + { + if (configuration.verbose) + { + System.out.println("Optimizing..."); + } + + // Perform the actual optimization. + return new Optimizer(configuration).execute(programClassPool, libraryClassPool); + } + + + /** + * Performs the obfuscation step. + */ + private void obfuscate() throws IOException + { + if (configuration.verbose) + { + System.out.println("Obfuscating..."); + + // We'll apply a mapping, if requested. + if (configuration.applyMapping != null) + { + System.out.println("Applying mapping [" + fileName(configuration.applyMapping) + "]"); + } + + // We'll print out the mapping, if requested. + if (configuration.printMapping != null) + { + System.out.println("Printing mapping to [" + fileName(configuration.printMapping) + "]..."); + } + } + + // Perform the actual obfuscation. + new Obfuscator(configuration).execute(programClassPool, libraryClassPool); + } + + + /** + * Performs the preverification step. + */ + private void preverify() + { + if (configuration.verbose) + { + System.out.println("Preverifying..."); + } + + // Perform the actual preverification. + new Preverifier(configuration).execute(programClassPool); + } + + + /** + * Sorts the elements of all program classes. + */ + private void sortClassElements() + { + programClassPool.classesAccept(new ClassElementSorter()); + } + + + /** + * Writes the output class files. + */ + private void writeOutput() throws IOException + { + if (configuration.verbose) + { + System.out.println("Writing output..."); + } + + // Write out the program class pool. + new OutputWriter(configuration).execute(programClassPool); + } + + + /** + * Prints out the contents of the program classes. + */ + private void dump() throws IOException + { + if (configuration.verbose) + { + System.out.println("Printing classes to [" + fileName(configuration.dump) + "]..."); + } + + PrintStream ps = createPrintStream(configuration.dump); + try + { + programClassPool.classesAccept(new ClassPrinter(ps)); + } + finally + { + closePrintStream(ps); + } + } + + + /** + * Returns a print stream for the given file, or the standard output if + * the file name is empty. + */ + private PrintStream createPrintStream(File file) + throws FileNotFoundException + { + return isFile(file) ? + new PrintStream(new BufferedOutputStream(new FileOutputStream(file))) : + System.out; + } + + + /** + * Closes the given print stream, or closes it if is the standard output. + * @param printStream + */ + private void closePrintStream(PrintStream printStream) + { + if (printStream == System.out) + { + printStream.flush(); + } + else + { + printStream.close(); + } + } + + + /** + * Returns the absolute file name for the given file, or the standard output + * if the file name is empty. + */ + private String fileName(File file) + { + return isFile(file) ? + file.getAbsolutePath() : + "standard output"; + } + + + /** + * Returns whether the given file is actually a file, or just a placeholder + * for the standard output. + */ + private boolean isFile(File file) + { + return file.getPath().length() > 0; + } + + + /** + * The main method for ProGuard. + */ + public static void main(String[] args) + { + if (args.length == 0) + { + System.out.println(VERSION); + System.out.println("Usage: java proguard.ProGuard [options ...]"); + System.exit(1); + } + + // Create the default options. + Configuration configuration = new Configuration(); + + try + { + // Parse the options specified in the command line arguments. + ConfigurationParser parser = new ConfigurationParser(args); + + try + { + parser.parse(configuration); + } + finally + { + parser.close(); + } + + // Execute ProGuard with these options. + new ProGuard(configuration).execute(); + } + catch (Exception ex) + { + if (configuration.verbose) + { + // Print a verbose stack trace. + ex.printStackTrace(); + } + else + { + // Print just the stack trace message. + System.err.println("Error: "+ex.getMessage()); + } + + System.exit(1); + } + + System.exit(0); + } +} diff --git a/src/proguard/SubclassedClassFilter.java b/src/proguard/SubclassedClassFilter.java new file mode 100644 index 0000000..27cac11 --- /dev/null +++ b/src/proguard/SubclassedClassFilter.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor delegates all its method calls to another ClassVisitor, + * but only for Clazz objects that are being subclassed. + * + * @author Eric Lafortune + */ +final class SubclassedClassFilter +implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + public SubclassedClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (programClass.subClasses != null) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (libraryClass.subClasses != null) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} diff --git a/src/proguard/Targeter.java b/src/proguard/Targeter.java new file mode 100644 index 0000000..5067205 --- /dev/null +++ b/src/proguard/Targeter.java @@ -0,0 +1,88 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import proguard.classfile.ClassPool; +import proguard.classfile.util.ClassUtil; +import proguard.classfile.visitor.ClassVersionSetter; + +import java.io.IOException; +import java.util.*; + +/** + * This class sets the target version on program classes. + * + * @author Eric Lafortune + */ +public class Targeter +{ + private final Configuration configuration; + + + /** + * Creates a new Targeter to set the target version on program classes + * according to the given configuration. + */ + public Targeter(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Sets the target version on classes in the given program class pool. + */ + public void execute(ClassPool programClassPool) throws IOException + { + Set newerClassVersions = configuration.warn != null ? null : new HashSet(); + + programClassPool.classesAccept(new ClassVersionSetter(configuration.targetClassVersion, + newerClassVersions)); + + if (newerClassVersions != null && + newerClassVersions.size() > 0) + { + System.err.print("Warning: some classes have more recent versions ("); + + Iterator iterator = newerClassVersions.iterator(); + while (iterator.hasNext()) + { + Integer classVersion = (Integer)iterator.next(); + System.err.print(ClassUtil.externalClassVersion(classVersion.intValue())); + + if (iterator.hasNext()) + { + System.err.print(","); + } + } + + System.err.println(")"); + System.err.println(" than the target version ("+ClassUtil.externalClassVersion(configuration.targetClassVersion)+")."); + + if (!configuration.ignoreWarnings) + { + System.err.println(" If you are sure this is not a problem,"); + System.err.println(" you could try your luck using the '-ignorewarnings' option."); + throw new IOException("Please correct the above warnings first."); + } + } + } +} diff --git a/src/proguard/UpToDateChecker.java b/src/proguard/UpToDateChecker.java new file mode 100644 index 0000000..9fa5d16 --- /dev/null +++ b/src/proguard/UpToDateChecker.java @@ -0,0 +1,153 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.File; + +/** + * This class checks whether the output is up to date. + * + * @author Eric Lafortune + */ +public class UpToDateChecker +{ + private final Configuration configuration; + + + /** + * Creates a new UpToDateChecker with the given configuration. + */ + public UpToDateChecker(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Returns whether the output is up to date, based on the modification times + * of the input jars, output jars, and library jars (or directories). + */ + public boolean check() + { + long inputLastModified = configuration.lastModified; + long outputLastModified = Long.MAX_VALUE; + + ClassPath programJars = configuration.programJars; + ClassPath libraryJars = configuration.libraryJars; + + // Check the dates of the program jars, if any. + if (programJars != null) + { + for (int index = 0; index < programJars.size(); index++) + { + // Break early, if possible. + if (inputLastModified >= outputLastModified) + { + break; + } + + // Update the input and output modification times. + ClassPathEntry classPathEntry = programJars.get(index); + if (classPathEntry.isOutput()) + { + long lastModified = lastModified(classPathEntry.getFile(), true); + if (outputLastModified > lastModified) + { + outputLastModified = lastModified; + } + } + else + { + long lastModified = lastModified(classPathEntry.getFile(), false); + if (inputLastModified < lastModified) + { + inputLastModified = lastModified; + } + } + } + } + + // Check the dates of the library jars, if any. + if (libraryJars != null) + { + for (int index = 0; index < libraryJars.size(); index++) + { + // Break early, if possible. + if (inputLastModified >= outputLastModified) + { + break; + } + + // Update the input modification time. + ClassPathEntry classPathEntry = libraryJars.get(index); + long lastModified = lastModified(classPathEntry.getFile(), false); + if (inputLastModified < lastModified) + { + inputLastModified = lastModified; + } + } + } + + boolean outputUpToDate = inputLastModified < outputLastModified; + if (outputUpToDate) + { + System.out.println("The output is up to date"); + } + + return outputUpToDate; + } + + + /** + * Returns the minimum or maximum modification time of the given file or + * of the files in the given directory (recursively). + */ + private long lastModified(File file, boolean minimum) + { + // Is it a directory? + if (file.isDirectory()) + { + // Ignore the directory's modification time; just recurse on its files. + File[] files = file.listFiles(); + + // Still, an empty output directory is probably a sign that it is + // not up to date. + long lastModified = files.length != 0 && minimum ? + Long.MAX_VALUE : 0L; + + for (int index = 0; index < files.length; index++) + { + long fileLastModified = lastModified(files[index], minimum); + if ((lastModified < fileLastModified) ^ minimum) + { + lastModified = fileLastModified; + } + } + + return lastModified; + } + else + { + // Return the file's modification time. + return file.lastModified(); + } + } +} diff --git a/src/proguard/WordReader.java b/src/proguard/WordReader.java new file mode 100644 index 0000000..d73505a --- /dev/null +++ b/src/proguard/WordReader.java @@ -0,0 +1,326 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard; + +import java.io.*; + + +/** + * An abstract reader of words, with the possibility to include other readers. + * Words are separated by spaces or broken off at delimiters. Words containing + * spaces or delimiters can be quoted with single or double quotes. + * Comments (everything starting with '#' on a single line) are ignored. + * + * @author Eric Lafortune + * @noinspection TailRecursion + */ +public abstract class WordReader +{ + private static final char COMMENT_CHARACTER = '#'; + + + private File baseDir; + private WordReader includeWordReader; + private String currentLine; + private int currentLineLength; + private int currentIndex; + private String currentWord; + private String currentComments; + + + /** + * Creates a new WordReader with the given base directory. + */ + protected WordReader(File baseDir) + { + this.baseDir = baseDir; + } + + + /** + * Sets the base directory of this reader. + */ + public void setBaseDir(File baseDir) + { + if (includeWordReader != null) + { + includeWordReader.setBaseDir(baseDir); + } + else + { + this.baseDir = baseDir; + } + } + + + /** + * Returns the base directory of this reader, if any. + */ + public File getBaseDir() + { + return includeWordReader != null ? + includeWordReader.getBaseDir() : + baseDir; + } + + + /** + * Specifies to start reading words from the given WordReader. When it is + * exhausted, this WordReader will continue to provide its own words. + * + * @param newIncludeWordReader the WordReader that will start reading words. + */ + public void includeWordReader(WordReader newIncludeWordReader) + { + if (includeWordReader == null) + { + includeWordReader = newIncludeWordReader; + } + else + { + includeWordReader.includeWordReader(newIncludeWordReader); + } + } + + + /** + * Reads a word from this WordReader, or from one of its active included + * WordReader objects. + * + * @return the read word. + */ + public String nextWord() throws IOException + { + currentWord = null; + + // See if we have an included reader to produce a word. + if (includeWordReader != null) + { + // Does the included word reader still produce a word? + currentWord = includeWordReader.nextWord(); + if (currentWord != null) + { + // Return it if so. + return currentWord; + } + + // Otherwise close and ditch the word reader. + includeWordReader.close(); + includeWordReader = null; + } + + // Get a word from this reader. + + // Skip leading whitespace. + while (currentLine != null && + currentIndex < currentLineLength && + Character.isWhitespace(currentLine.charAt(currentIndex))) + { + currentIndex++; + } + + // Make sure we have a non-blank line. + while (currentLine == null || currentIndex == currentLineLength) + { + currentLine = nextLine(); + if (currentLine == null) + { + return null; + } + + // Trim off any comments. + int comments_start = currentLine.indexOf(COMMENT_CHARACTER); + if (comments_start >= 0) + { + currentLineLength = comments_start; + + // Remember the comments. + String comment = currentLine.substring(comments_start + 1); + currentComments = currentComments == null ? + comment : + currentComments + '\n' + comment; + } + else + { + currentLineLength = currentLine.length(); + } + + // Skip leading whitespace. + currentIndex = 0; + while (currentIndex < currentLineLength && + Character.isWhitespace(currentLine.charAt(currentIndex))) + { + currentIndex++; + } + } + + // Find the word starting at the current index. + int startIndex = currentIndex; + int endIndex; + + char startChar = currentLine.charAt(startIndex); + + if (isDelimiter(startChar)) + { + // The next word is a single delimiting character. + endIndex = ++currentIndex; + } + else if (isQuote(startChar)) + { + // The next word is starting with a quote character. + // Skip the opening quote. + startIndex++; + + // The next word is a quoted character string. + // Find the closing quote. + do + { + currentIndex++; + + if (currentIndex == currentLineLength) + { + currentWord = currentLine.substring(startIndex-1, currentIndex); + throw new IOException("Missing closing quote for "+locationDescription()); + } + } + while (currentLine.charAt(currentIndex) != startChar); + + endIndex = currentIndex++; + } + else + { + // The next word is a simple character string. + // Find the end of the line, the first delimiter, or the first + // white space. + while (currentIndex < currentLineLength) + { + char currentCharacter = currentLine.charAt(currentIndex); + if (isDelimiter(currentCharacter) || + Character.isWhitespace(currentCharacter)) + { + break; + } + + currentIndex++; + } + + endIndex = currentIndex; + } + + // Remember and return the parsed word. + currentWord = currentLine.substring(startIndex, endIndex); + + return currentWord; + } + + + /** + * Returns the comments collected before returning the last word. + * Starts collecting new comments. + * + * @return the collected comments, or null if there weren't any. + */ + public String lastComments() throws IOException + { + if (includeWordReader == null) + { + String comments = currentComments; + currentComments = null; + return comments; + } + else + { + return includeWordReader.lastComments(); + } + } + + + /** + * Constructs a readable description of the current position in this + * WordReader and its included WordReader objects. + * + * @return the description. + */ + public String locationDescription() + { + return + (includeWordReader == null ? + (currentWord == null ? + "end of " : + "'" + currentWord + "' in " ) : + (includeWordReader.locationDescription() + ",\n" + + " included from ")) + + lineLocationDescription(); + } + + + /** + * Reads a line from this WordReader, or from one of its active included + * WordReader objects. + * + * @return the read line. + */ + protected abstract String nextLine() throws IOException; + + + /** + * Returns a readable description of the current WordReader position. + * + * @return the description. + */ + protected abstract String lineLocationDescription(); + + + /** + * Closes the FileWordReader. + */ + public void close() throws IOException + { + // Close and ditch the included word reader, if any. + if (includeWordReader != null) + { + includeWordReader.close(); + includeWordReader = null; + } + } + + + // Small utility methods. + + private boolean isDelimiter(char character) + { + return character == '@' || + character == '{' || + character == '}' || + character == '(' || + character == ')' || + character == ',' || + character == ';' || + character == File.pathSeparatorChar; + } + + + private boolean isQuote(char character) + { + return character == '\'' || + character == '"'; + } +} diff --git a/src/proguard/ant/ClassPathElement.java b/src/proguard/ant/ClassPathElement.java new file mode 100644 index 0000000..b5c2df4 --- /dev/null +++ b/src/proguard/ant/ClassPathElement.java @@ -0,0 +1,191 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.*; +import org.apache.tools.ant.types.*; +import proguard.*; +import proguard.util.ListUtil; + +import java.io.File; + +/** + * This FileSet represents a class path entry (or a set of class path entries) + * in Ant. + * + * @author Eric Lafortune + */ +public class ClassPathElement extends Path +{ + private String filter; + private String jarFilter; + private String warFilter; + private String earFilter; + private String zipFilter; + + + /** + * @see Path#Path(Project) + */ + public ClassPathElement(Project project) + { + super(project); + } + + + /** + * Adds the contents of this class path element to the given class path. + * @param classPath the class path to be extended. + * @param output specifies whether this is an output entry or not. + */ + public void appendClassPathEntriesTo(ClassPath classPath, boolean output) + { + File baseDir = getProject().getBaseDir(); + String[] fileNames; + + if (isReference()) + { + // Get the referenced path or file set. + Object referencedObject = getCheckedRef(DataType.class, + DataType.class.getName()); + + if (referencedObject instanceof Path) + { + Path path = (Path)referencedObject; + + // Get the names of the files in the referenced path. + fileNames = path.list(); + } + else if (referencedObject instanceof AbstractFileSet) + { + AbstractFileSet fileSet = (AbstractFileSet)referencedObject; + + // Get the names of the existing input files in the referenced file set. + DirectoryScanner scanner = fileSet.getDirectoryScanner(getProject()); + baseDir = scanner.getBasedir(); + fileNames = scanner.getIncludedFiles(); + } + else + { + throw new BuildException("The refid attribute doesn't point to a element or a element"); + } + } + else + { + // Get the names of the files in this path. + fileNames = list(); + } + + if (output) + { + if (fileNames.length != 1) + { + throw new BuildException("The element must specify exactly one file or directory ["+fileNames.length+"]"); + } + } + //else + //{ + // if (fileNames.length < 1) + // { + // throw new BuildException("The element must specify at least one file or directory"); + // } + //} + + for (int index = 0; index < fileNames.length; index++) + { + // Create a new class path entry, with the proper file name and + // any filters. + String fileName = fileNames[index]; + File file = new File(fileName); + + ClassPathEntry entry = + new ClassPathEntry(file.isAbsolute() ? file : new File(baseDir, fileName), + output); + entry.setFilter(ListUtil.commaSeparatedList(filter)); + entry.setJarFilter(ListUtil.commaSeparatedList(jarFilter)); + entry.setWarFilter(ListUtil.commaSeparatedList(warFilter)); + entry.setEarFilter(ListUtil.commaSeparatedList(earFilter)); + entry.setZipFilter(ListUtil.commaSeparatedList(zipFilter)); + + // Add it to the class path. + classPath.add(entry); + } + } + + + // Ant task attributes. + + /** + * @deprecated Use {@link #setLocation(File)} instead. + */ + public void setFile(File file) + { + setLocation(file); + } + + + /** + * @deprecated Use {@link #setLocation(File)} instead. + */ + public void setDir(File file) + { + setLocation(file); + } + + + /** + * @deprecated Use {@link #setLocation(File)} instead. + */ + public void setName(File file) + { + setLocation(file); + } + + + public void setFilter(String filter) + { + this.filter = filter; + } + + + public void setJarfilter(String jarFilter) + { + this.jarFilter = jarFilter; + } + + + public void setWarfilter(String warFilter) + { + this.warFilter = warFilter; + } + + + public void setEarfilter(String earFilter) + { + this.earFilter = earFilter; + } + + + public void setZipfilter(String zipFilter) + { + this.zipFilter = zipFilter; + } +} diff --git a/src/proguard/ant/ClassSpecificationElement.java b/src/proguard/ant/ClassSpecificationElement.java new file mode 100644 index 0000000..f4ea2ff --- /dev/null +++ b/src/proguard/ant/ClassSpecificationElement.java @@ -0,0 +1,257 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.types.DataType; +import proguard.*; +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; + +import java.util.*; + +/** + * This DataType represents a class specification in Ant. + * + * @author Eric Lafortune + */ +public class ClassSpecificationElement extends DataType +{ + private static final String ANY_CLASS_KEYWORD = "*"; + + private String access; + private String annotation; + private String type; + private String name; + private String extendsAnnotation; + private String extends_; + private List fieldSpecifications = new ArrayList(); + private List methodSpecifications = new ArrayList(); + + + /** + * Adds the contents of this class specification element to the given list. + * @param classSpecifications the class specifications to be extended. + */ + public void appendTo(List classSpecifications) + { + // Get the referenced file set, or else this one. + ClassSpecificationElement classSpecificationElement = isReference() ? + (ClassSpecificationElement)getCheckedRef(this.getClass(), + this.getClass().getName()) : + this; + + ClassSpecification classSpecification = + createClassSpecification(classSpecificationElement); + + // Add it to the list. + classSpecifications.add(classSpecification); + } + + + /** + * Creates a new class specification corresponding to the contents of this + * class specification element. + */ + protected ClassSpecification createClassSpecification(ClassSpecificationElement classSpecificationElement) + { + String access = classSpecificationElement.access; + String annotation = classSpecificationElement.annotation; + String type = classSpecificationElement.type; + String name = classSpecificationElement.name; + String extendsAnnotation = classSpecificationElement.extendsAnnotation; + String extends_ = classSpecificationElement.extends_; + + // For backward compatibility, allow a single "*" wildcard to match + // any class. + if (name != null && + name.equals(ANY_CLASS_KEYWORD)) + { + name = null; + } + + ClassSpecification classSpecification = + new ClassSpecification(null, + requiredAccessFlags(true, access, type), + requiredAccessFlags(false, access, type), + annotation != null ? ClassUtil.internalType(annotation) : null, + name != null ? ClassUtil.internalClassName(name) : null, + extendsAnnotation != null ? ClassUtil.internalType(extendsAnnotation) : null, + extends_ != null ? ClassUtil.internalClassName(extends_) : null); + + for (int index = 0; index < fieldSpecifications.size(); index++) + { + classSpecification.addField((MemberSpecification)fieldSpecifications.get(index)); + } + + for (int index = 0; index < methodSpecifications.size(); index++) + { + classSpecification.addMethod((MemberSpecification)methodSpecifications.get(index)); + } + + return classSpecification; + } + + + // Ant task attributes. + + public void setAccess(String access) + { + this.access = access; + } + + + public void setAnnotation(String annotation) + { + this.annotation = annotation; + } + + + public void setType(String type) + { + this.type = type; + } + + + public void setName(String name) + { + this.name = name; + } + + + public void setExtendsannotation(String extendsAnnotation) + { + this.extendsAnnotation = extendsAnnotation; + } + + + public void setExtends(String extends_) + { + this.extends_ = extends_; + } + + + public void setImplements(String implements_) + { + this.extends_ = implements_; + } + + + // Ant task nested elements. + + public void addConfiguredField(MemberSpecificationElement memberSpecificationElement) + { + if (fieldSpecifications == null) + { + fieldSpecifications = new ArrayList(); + } + + memberSpecificationElement.appendTo(fieldSpecifications, + false, + false); + } + + + public void addConfiguredMethod(MemberSpecificationElement memberSpecificationElement) + { + if (methodSpecifications == null) + { + methodSpecifications = new ArrayList(); + } + + memberSpecificationElement.appendTo(methodSpecifications, + true, + false); + } + + + public void addConfiguredConstructor(MemberSpecificationElement memberSpecificationElement) + { + if (methodSpecifications == null) + { + methodSpecifications = new ArrayList(); + } + + memberSpecificationElement.appendTo(methodSpecifications, + true, + true); + } + + + // Small utility methods. + + private int requiredAccessFlags(boolean set, + String access, + String type) + throws BuildException + { + int accessFlags = 0; + + if (access != null) + { + StringTokenizer tokenizer = new StringTokenizer(access, " ,"); + while (tokenizer.hasMoreTokens()) + { + String token = tokenizer.nextToken(); + + if (token.startsWith("!") ^ set) + { + String strippedToken = token.startsWith("!") ? + token.substring(1) : + token; + + int accessFlag = + strippedToken.equals(ClassConstants.EXTERNAL_ACC_PUBLIC) ? ClassConstants.INTERNAL_ACC_PUBLIC : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_FINAL) ? ClassConstants.INTERNAL_ACC_FINAL : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_ABSTRACT) ? ClassConstants.INTERNAL_ACC_ABSTRACT : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_ANNOTATION) ? ClassConstants.INTERNAL_ACC_ANNOTATTION : + 0; + + if (accessFlag == 0) + { + throw new BuildException("Incorrect class access modifier ["+strippedToken+"]"); + } + + accessFlags |= accessFlag; + } + } + } + + if (type != null && (type.startsWith("!") ^ set)) + { + int accessFlag = + type.equals("class") ? 0 : + type.equals( ClassConstants.EXTERNAL_ACC_INTERFACE) || + type.equals("!" + ClassConstants.EXTERNAL_ACC_INTERFACE) ? ClassConstants.INTERNAL_ACC_INTERFACE : + type.equals( ClassConstants.EXTERNAL_ACC_ENUM) || + type.equals("!" + ClassConstants.EXTERNAL_ACC_ENUM) ? ClassConstants.INTERNAL_ACC_ENUM : + -1; + if (accessFlag == -1) + { + throw new BuildException("Incorrect class type ["+type+"]"); + } + + accessFlags |= accessFlag; + } + + return accessFlags; + } +} diff --git a/src/proguard/ant/ConfigurationElement.java b/src/proguard/ant/ConfigurationElement.java new file mode 100644 index 0000000..76e9418 --- /dev/null +++ b/src/proguard/ant/ConfigurationElement.java @@ -0,0 +1,53 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.types.DataType; +import proguard.Configuration; + +/** + * This DataType represents a reference to a ProGuard configuration in Ant. + * + * @author Eric Lafortune + */ +public class ConfigurationElement extends DataType +{ + /** + * Adds the contents of this configuration task to the given configuration. + * @param configuration the configuration to be extended. + */ + public void appendTo(Configuration configuration) + { + // Get the referenced element. + if (!isReference()) + { + throw new BuildException("Nested element must have a refid attribute"); + } + + ConfigurationTask configurationTask = + (ConfigurationTask)getCheckedRef(ConfigurationTask.class, + ConfigurationTask.class.getName()); + + // Append the referenced configuration entries to the given configuration. + configurationTask.appendTo(configuration); + } +} diff --git a/src/proguard/ant/ConfigurationTask.java b/src/proguard/ant/ConfigurationTask.java new file mode 100644 index 0000000..0d2f04f --- /dev/null +++ b/src/proguard/ant/ConfigurationTask.java @@ -0,0 +1,440 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.*; +import proguard.*; + +import java.io.IOException; +import java.util.*; + +/** + * This Task allows to define a ProGuard configuration from Ant. + * + * @author Eric Lafortune + */ +public class ConfigurationTask extends Task +{ + protected final Configuration configuration = new Configuration(); + + + /** + * Adds the contents of this configuration task to the given configuration. + * @param configuration the configuration to be extended. + */ + public void appendTo(Configuration configuration) + { + // Append all of these configuration entries to the given configuration. + configuration.programJars = extendClassPath(configuration.programJars, + this.configuration.programJars); + + configuration.libraryJars = extendClassPath(configuration.libraryJars, + this.configuration.libraryJars); + + configuration.keep = extendClassSpecifications(configuration.keep, + this.configuration.keep); + + configuration.keepDirectories = extendList(configuration.keepDirectories, + this.configuration.keepDirectories); + + configuration.whyAreYouKeeping = extendClassSpecifications(configuration.whyAreYouKeeping, + this.configuration.whyAreYouKeeping); + + configuration.optimizations = extendClassSpecifications(configuration.optimizations, + this.configuration.optimizations); + + configuration.assumeNoSideEffects = extendClassSpecifications(configuration.assumeNoSideEffects, + this.configuration.assumeNoSideEffects); + + configuration.keepPackageNames = extendList(configuration.keepPackageNames, + this.configuration.keepPackageNames); + + configuration.keepAttributes = extendList(configuration.keepAttributes, + this.configuration.keepAttributes); + + configuration.adaptClassStrings = extendList(configuration.adaptClassStrings, + this.configuration.adaptClassStrings); + + configuration.adaptResourceFileNames = extendList(configuration.adaptResourceFileNames, + this.configuration.adaptResourceFileNames); + + configuration.adaptResourceFileContents = extendList(configuration.adaptResourceFileContents, + this.configuration.adaptResourceFileContents); + + configuration.note = extendList(configuration.note, + this.configuration.note); + + configuration.warn = extendList(configuration.warn, + this.configuration.warn); + } + + + // Ant task nested elements. + + public void addConfiguredInjar(ClassPathElement classPathElement) + { + configuration.programJars = extendClassPath(configuration.programJars, + classPathElement, + false); + } + + + public void addConfiguredOutjar(ClassPathElement classPathElement) + { + configuration.programJars = extendClassPath(configuration.programJars, + classPathElement, + true); + } + + + public void addConfiguredLibraryjar(ClassPathElement classPathElement) + { + configuration.libraryJars = extendClassPath(configuration.libraryJars, + classPathElement, + false); + } + + + public void addConfiguredKeepdirectory(FilterElement filterElement) + { + configuration.keepDirectories = extendFilter(configuration.keepDirectories, + filterElement); + } + + + public void addConfiguredKeepdirectories(FilterElement filterElement) + { + configuration.keepDirectories = extendFilter(configuration.keepDirectories, + filterElement); + } + + + public void addConfiguredKeep(KeepSpecificationElement keepSpecificationElement) + { + configuration.keep = extendKeepSpecifications(configuration.keep, + keepSpecificationElement, + true, + false); + } + + + public void addConfiguredKeepclassmembers(KeepSpecificationElement keepSpecificationElement) + { + configuration.keep = extendKeepSpecifications(configuration.keep, + keepSpecificationElement, + false, + false); + } + + + public void addConfiguredKeepclasseswithmembers(KeepSpecificationElement keepSpecificationElement) + { + configuration.keep = extendKeepSpecifications(configuration.keep, + keepSpecificationElement, + true, + true); + } + + + public void addConfiguredKeepnames(KeepSpecificationElement keepSpecificationElement) + { + // Set the shrinking flag, based on the name (backward compatibility). + keepSpecificationElement.setAllowshrinking(true); + + configuration.keep = extendKeepSpecifications(configuration.keep, + keepSpecificationElement, + true, + false); + } + + + public void addConfiguredKeepclassmembernames(KeepSpecificationElement keepSpecificationElement) + { + // Set the shrinking flag, based on the name (backward compatibility). + keepSpecificationElement.setAllowshrinking(true); + + configuration.keep = extendKeepSpecifications(configuration.keep, + keepSpecificationElement, + false, + false); + } + + + public void addConfiguredKeepclasseswithmembernames(KeepSpecificationElement keepSpecificationElement) + { + // Set the shrinking flag, based on the name (backward compatibility). + keepSpecificationElement.setAllowshrinking(true); + + configuration.keep = extendKeepSpecifications(configuration.keep, + keepSpecificationElement, + true, + true); + } + + + public void addConfiguredWhyareyoukeeping(ClassSpecificationElement classSpecificationElement) + { + configuration.whyAreYouKeeping = extendClassSpecifications(configuration.whyAreYouKeeping, + classSpecificationElement); + } + + + public void addConfiguredAssumenosideeffects(ClassSpecificationElement classSpecificationElement) + { + configuration.assumeNoSideEffects = extendClassSpecifications(configuration.assumeNoSideEffects, + classSpecificationElement); + } + + + public void addConfiguredOptimizations(FilterElement filterElement) + { + addConfiguredOptimization(filterElement); + } + + + public void addConfiguredOptimization(FilterElement filterElement) + { + configuration.optimizations = extendFilter(configuration.optimizations, + filterElement); + } + + + public void addConfiguredKeeppackagename(FilterElement filterElement) + { + configuration.keepPackageNames = extendFilter(configuration.keepPackageNames, + filterElement, + true); + } + + + public void addConfiguredKeeppackagenames(FilterElement filterElement) + { + configuration.keepPackageNames = extendFilter(configuration.keepPackageNames, + filterElement, + true); + } + + + public void addConfiguredKeepattributes(FilterElement filterElement) + { + addConfiguredKeepattribute(filterElement); + } + + + public void addConfiguredKeepattribute(FilterElement filterElement) + { + configuration.keepAttributes = extendFilter(configuration.keepAttributes, + filterElement); + } + + + public void addConfiguredAdaptclassstrings(FilterElement filterElement) + { + configuration.adaptClassStrings = extendFilter(configuration.adaptClassStrings, + filterElement, true); + } + + + public void addConfiguredAdaptresourcefilenames(FilterElement filterElement) + { + configuration.adaptResourceFileNames = extendFilter(configuration.adaptResourceFileNames, + filterElement); + } + + + public void addConfiguredAdaptresourcefilecontents(FilterElement filterElement) + { + configuration.adaptResourceFileContents = extendFilter(configuration.adaptResourceFileContents, + filterElement); + } + + + public void addConfiguredDontnote(FilterElement filterElement) + { + configuration.note = extendFilter(configuration.note, filterElement, true); + } + + + public void addConfiguredDontwarn(FilterElement filterElement) + { + configuration.warn = extendFilter(configuration.warn, filterElement, true); + } + + + public void addConfiguredConfiguration(ConfigurationElement configurationElement) + { + configurationElement.appendTo(configuration); + } + + + // Implementations for Task. + + public void addText(String text) throws BuildException + { + try + { + String arg = getProject().replaceProperties(text); + + ConfigurationParser parser = new ConfigurationParser(new String[] { arg }, + getProject().getBaseDir()); + + try + { + parser.parse(configuration); + } + catch (ParseException ex) + { + throw new BuildException(ex.getMessage()); + } + finally + { + parser.close(); + } + } + catch (IOException ex) + { + throw new BuildException(ex.getMessage()); + } + } + + + // Small utility methods. + + private ClassPath extendClassPath(ClassPath classPath, + ClassPathElement classPathElement, + boolean output) + { + if (classPath == null) + { + classPath = new ClassPath(); + } + + classPathElement.appendClassPathEntriesTo(classPath, + output); + + return classPath; + } + + + private ClassPath extendClassPath(ClassPath classPath, + ClassPath additionalClassPath) + { + if (additionalClassPath != null) + { + if (classPath == null) + { + classPath = new ClassPath(); + } + + classPath.addAll(additionalClassPath); + } + + return classPath; + } + + + private List extendKeepSpecifications(List keepSpecifications, + KeepSpecificationElement keepSpecificationElement, + boolean markClasses, + boolean markClassesConditionally) + { + if (keepSpecifications == null) + { + keepSpecifications = new ArrayList(); + } + + keepSpecificationElement.appendTo(keepSpecifications, + markClasses, + markClassesConditionally); + + return keepSpecifications; + } + + + private List extendClassSpecifications(List classSpecifications, + ClassSpecificationElement classSpecificationElement) + { + if (classSpecifications == null) + { + classSpecifications = new ArrayList(); + } + + classSpecificationElement.appendTo(classSpecifications); + + return classSpecifications; + } + + + private List extendClassSpecifications(List classSpecifications, + List additionalClassSpecifications) + { + if (additionalClassSpecifications != null) + { + if (classSpecifications == null) + { + classSpecifications = new ArrayList(); + } + + classSpecifications.addAll(additionalClassSpecifications); + } + + return classSpecifications; + } + + + private List extendFilter(List filter, + FilterElement filterElement) + { + return extendFilter(filter, filterElement, false); + } + + + private List extendFilter(List filter, + FilterElement filterElement, + boolean internal) + { + if (filter == null) + { + filter = new ArrayList(); + } + + filterElement.appendTo(filter, internal); + + return filter; + } + + + private List extendList(List list, + List additionalList) + { + if (additionalList != null) + { + if (list == null) + { + list = new ArrayList(); + } + + list.addAll(additionalList); + } + + return list; + } +} diff --git a/src/proguard/ant/FilterElement.java b/src/proguard/ant/FilterElement.java new file mode 100644 index 0000000..d792c5d --- /dev/null +++ b/src/proguard/ant/FilterElement.java @@ -0,0 +1,85 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.types.DataType; +import proguard.classfile.util.ClassUtil; +import proguard.util.ListUtil; + +import java.util.List; + +/** + * This DataType represents a name filter in Ant. + * + * @author Eric Lafortune + */ +public class FilterElement extends DataType +{ + private String filter; + + + /** + * Adds the contents of this element to the given name filter. + * @param filter the list of attributes to be extended. + * @param internal specifies whether the filter string should be converted + * to internal types. + */ + public void appendTo(List filter, boolean internal) + { + // Get the referenced element, or else this one. + FilterElement filterElement = isReference() ? + (FilterElement)getCheckedRef(this.getClass(), + this.getClass().getName()) : + this; + + String filterString = filterElement.filter; + + if (filterString == null) + { + // Clear the filter to keep all names. + filter.clear(); + } + else + { + if (internal) + { + filterString = ClassUtil.internalClassName(filterString); + } + + // Append the filter. + filter.addAll(ListUtil.commaSeparatedList(filterString)); + } + } + + + // Ant task attributes. + + public void setName(String name) + { + this.filter = name; + } + + + public void setFilter(String filter) + { + this.filter = filter; + } +} diff --git a/src/proguard/ant/KeepSpecificationElement.java b/src/proguard/ant/KeepSpecificationElement.java new file mode 100644 index 0000000..e36b744 --- /dev/null +++ b/src/proguard/ant/KeepSpecificationElement.java @@ -0,0 +1,87 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import proguard.KeepClassSpecification; + +import java.util.List; + +/** + * This DataType represents a class specification in Ant. + * + * @author Eric Lafortune + */ +public class KeepSpecificationElement extends ClassSpecificationElement +{ + private boolean allowShrinking; + private boolean allowOptimization; + private boolean allowObfuscation; + + + /** + * Adds the contents of this class specification element to the given list. + * @param keepSpecifications the class specifications to be extended. + * @param markClasses specifies whether to mark the classes. + * @param markConditionally specifies whether to mark the classes + * and class members conditionally. + */ + public void appendTo(List keepSpecifications, + boolean markClasses, + boolean markConditionally) + { + // Get the referenced file set, or else this one. + KeepSpecificationElement keepSpecificationElement = isReference() ? + (KeepSpecificationElement)getCheckedRef(this.getClass(), + this.getClass().getName()) : + this; + + KeepClassSpecification keepClassSpecification = + new KeepClassSpecification(markClasses, + markConditionally, + allowShrinking, + allowOptimization, + allowObfuscation, + createClassSpecification(keepSpecificationElement)); + + // Add it to the list. + keepSpecifications.add(keepClassSpecification); + } + + + // Ant task attributes. + + public void setAllowshrinking(boolean allowShrinking) + { + this.allowShrinking = allowShrinking; + } + + + public void setAllowoptimization(boolean allowOptimization) + { + this.allowOptimization = allowOptimization; + } + + + public void setAllowobfuscation(boolean allowObfuscation) + { + this.allowObfuscation = allowObfuscation; + } +} diff --git a/src/proguard/ant/MemberSpecificationElement.java b/src/proguard/ant/MemberSpecificationElement.java new file mode 100644 index 0000000..d4bb4a9 --- /dev/null +++ b/src/proguard/ant/MemberSpecificationElement.java @@ -0,0 +1,215 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.BuildException; +import org.apache.tools.ant.types.DataType; +import proguard.MemberSpecification; +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; +import proguard.util.ListUtil; + +import java.util.*; + +/** + * This DataType represents a class member specification in Ant. + * + * @author Eric Lafortune + */ +public class MemberSpecificationElement extends DataType +{ + private String access; + private String annotation; + private String type; + private String name; + private String parameters; + + + /** + * Adds the contents of this class member specification element to the given + * list. + * @param memberSpecifications the class member specifications to be + * extended. + * @param isMethod specifies whether this specification + * refers to a method. + * @param isConstructor specifies whether this specification + * refers to a constructor. + */ + public void appendTo(List memberSpecifications, + boolean isMethod, + boolean isConstructor) + { + // Get the referenced file set, or else this one. + MemberSpecificationElement memberSpecificationElement = isReference() ? + (MemberSpecificationElement)getCheckedRef(this.getClass(), + this.getClass().getName()) : + this; + + // Create a new class specification. + String access = memberSpecificationElement.access; + String type = memberSpecificationElement.type; + String annotation = memberSpecificationElement.annotation; + String name = memberSpecificationElement.name; + String parameters = memberSpecificationElement.parameters; + + // Perform some basic conversions and checks on the attributes. + if (annotation != null) + { + annotation = ClassUtil.internalType(annotation); + } + + if (isMethod) + { + if (isConstructor) + { + if (type != null) + { + throw new BuildException("Type attribute not allowed in constructor specification ["+type+"]"); + } + + if (parameters != null) + { + type = ClassConstants.EXTERNAL_TYPE_VOID; + } + + name = ClassConstants.INTERNAL_METHOD_NAME_INIT; + } + else if ((type != null) ^ (parameters != null)) + { + throw new BuildException("Type and parameters attributes must always be present in combination in method specification"); + } + } + else + { + if (parameters != null) + { + throw new BuildException("Parameters attribute not allowed in field specification ["+parameters+"]"); + } + } + + List parameterList = ListUtil.commaSeparatedList(parameters); + + String descriptor = + parameters != null ? ClassUtil.internalMethodDescriptor(type, parameterList) : + type != null ? ClassUtil.internalType(type) : + null; + + MemberSpecification memberSpecification = + new MemberSpecification(requiredAccessFlags(true, access), + requiredAccessFlags(false, access), + annotation, + name, + descriptor); + + // Add it to the list. + memberSpecifications.add(memberSpecification); + } + + + // Ant task attributes. + + public void setAccess(String access) + { + this.access = access; + } + + + public void setAnnotation(String annotation) + { + this.annotation = annotation; + } + + + public void setType(String type) + { + this.type = type; + } + + + public void setName(String name) + { + this.name = name; + } + + + public void setParameters(String parameters) + { + this.parameters = parameters; + } + + + /** + * @deprecated Use {@link #setParameters(String)} instead. + */ + public void setParam(String parameters) + { + this.parameters = parameters; + } + + + // Small utility methods. + + private int requiredAccessFlags(boolean set, + String access) + throws BuildException + { + int accessFlags = 0; + + if (access != null) + { + StringTokenizer tokenizer = new StringTokenizer(access, " ,"); + while (tokenizer.hasMoreTokens()) + { + String token = tokenizer.nextToken(); + + if (token.startsWith("!") ^ set) + { + String strippedToken = token.startsWith("!") ? + token.substring(1) : + token; + + int accessFlag = + strippedToken.equals(ClassConstants.EXTERNAL_ACC_PUBLIC) ? ClassConstants.INTERNAL_ACC_PUBLIC : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_PRIVATE) ? ClassConstants.INTERNAL_ACC_PRIVATE : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_PROTECTED) ? ClassConstants.INTERNAL_ACC_PROTECTED : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_STATIC) ? ClassConstants.INTERNAL_ACC_STATIC : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_FINAL) ? ClassConstants.INTERNAL_ACC_FINAL : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_SYNCHRONIZED) ? ClassConstants.INTERNAL_ACC_SYNCHRONIZED : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_VOLATILE) ? ClassConstants.INTERNAL_ACC_VOLATILE : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_TRANSIENT) ? ClassConstants.INTERNAL_ACC_TRANSIENT : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_NATIVE) ? ClassConstants.INTERNAL_ACC_NATIVE : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_ABSTRACT) ? ClassConstants.INTERNAL_ACC_ABSTRACT : + strippedToken.equals(ClassConstants.EXTERNAL_ACC_STRICT) ? ClassConstants.INTERNAL_ACC_STRICT : + 0; + + if (accessFlag == 0) + { + throw new BuildException("Incorrect class member access modifier ["+strippedToken+"]"); + } + + accessFlags |= accessFlag; + } + } + } + + return accessFlags; + } +} diff --git a/src/proguard/ant/ProGuardTask.java b/src/proguard/ant/ProGuardTask.java new file mode 100644 index 0000000..b7fc361 --- /dev/null +++ b/src/proguard/ant/ProGuardTask.java @@ -0,0 +1,320 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.ant; + +import org.apache.tools.ant.BuildException; +import proguard.*; +import proguard.classfile.util.ClassUtil; + +import java.io.*; +import java.util.ArrayList; + +/** + * This Task allows to configure and run ProGuard from Ant. + * + * @author Eric Lafortune + */ +public class ProGuardTask extends ConfigurationTask +{ + // Ant task attributes. + + public void setConfiguration(File configurationFile) throws BuildException + { + try + { + ConfigurationParser parser = new ConfigurationParser(configurationFile); + + try + { + parser.parse(configuration); + } + catch (ParseException ex) + { + throw new BuildException(ex.getMessage()); + } + finally + { + parser.close(); + } + } + catch (IOException ex) + { + throw new BuildException(ex.getMessage()); + } + } + + + /** + * @deprecated Use the nested outjar element instead. + */ + public void setOutjar(String parameters) + { + throw new BuildException("Use the nested element instead of the 'outjar' attribute"); + } + + + public void setSkipnonpubliclibraryclasses(boolean skipNonPublicLibraryClasses) + { + configuration.skipNonPublicLibraryClasses = skipNonPublicLibraryClasses; + } + + + public void setSkipnonpubliclibraryclassmembers(boolean skipNonPublicLibraryClassMembers) + { + configuration.skipNonPublicLibraryClassMembers = skipNonPublicLibraryClassMembers; + } + + + public void setTarget(String target) + { + configuration.targetClassVersion = ClassUtil.internalClassVersion(target); + if (configuration.targetClassVersion == 0) + { + throw new BuildException("Unsupported target '"+target+"'"); + } + } + + + public void setForceprocessing(boolean forceProcessing) + { + configuration.lastModified = forceProcessing ? Long.MAX_VALUE : 0; + } + + + public void setPrintseeds(File printSeeds) + { + configuration.printSeeds = optionalFile(printSeeds); + } + + + public void setShrink(boolean shrink) + { + configuration.shrink = shrink; + } + + + public void setPrintusage(File printUsage) + { + configuration.printUsage = optionalFile(printUsage); + } + + + public void setOptimize(boolean optimize) + { + configuration.optimize = optimize; + } + + + public void setOptimizationpasses(int optimizationPasses) + { + configuration.optimizationPasses = optimizationPasses; + } + + + public void setAllowaccessmodification(boolean allowAccessModification) + { + configuration.allowAccessModification = allowAccessModification; + } + + + public void setMergeinterfacesaggressively(boolean mergeinterfacesaggressively) + { + configuration.mergeInterfacesAggressively = mergeinterfacesaggressively; + } + + + public void setObfuscate(boolean obfuscate) + { + configuration.obfuscate = obfuscate; + } + + + public void setPrintmapping(File printMapping) + { + configuration.printMapping = optionalFile(printMapping); + } + + + public void setApplymapping(File applyMapping) + { + configuration.applyMapping = resolvedFile(applyMapping); + } + + + public void setObfuscationdictionary(File obfuscationDictionary) + { + configuration.obfuscationDictionary = resolvedFile(obfuscationDictionary); + } + + + public void setClassobfuscationdictionary(File classObfuscationDictionary) + { + configuration.classObfuscationDictionary = resolvedFile(classObfuscationDictionary); + } + + + public void setPackageobfuscationdictionary(File packageObfuscationDictionary) + { + configuration.packageObfuscationDictionary = resolvedFile(packageObfuscationDictionary); + } + + + public void setOverloadaggressively(boolean overloadAggressively) + { + configuration.overloadAggressively = overloadAggressively; + } + + + public void setUseuniqueclassmembernames(boolean useUniqueClassMemberNames) + { + configuration.useUniqueClassMemberNames = useUniqueClassMemberNames; + } + + + public void setUsemixedcaseclassnames(boolean useMixedCaseClassNames) + { + configuration.useMixedCaseClassNames = useMixedCaseClassNames; + } + + + public void setFlattenpackagehierarchy(String flattenPackageHierarchy) + { + configuration.flattenPackageHierarchy = ClassUtil.internalClassName(flattenPackageHierarchy); + } + + + public void setRepackageclasses(String repackageClasses) + { + configuration.repackageClasses = ClassUtil.internalClassName(repackageClasses); + } + + /** + * @deprecated Use the repackageclasses attribute instead. + */ + public void setDefaultpackage(String defaultPackage) + { + configuration.repackageClasses = ClassUtil.internalClassName(defaultPackage); + } + + + public void setRenamesourcefileattribute(String newSourceFileAttribute) + { + configuration.newSourceFileAttribute = newSourceFileAttribute; + } + + + public void setPreverify(boolean preverify) + { + configuration.preverify = preverify; + } + + + public void setMicroedition(boolean microEdition) + { + configuration.microEdition = microEdition; + } + + + public void setVerbose(boolean verbose) + { + configuration.verbose = verbose; + } + + + public void setNote(boolean note) + { + configuration.note = note ? null : new ArrayList(); + } + + + public void setWarn(boolean warn) + { + configuration.warn = warn ? null : new ArrayList(); + } + + + public void setIgnorewarnings(boolean ignoreWarnings) + { + configuration.ignoreWarnings = ignoreWarnings; + } + + + public void setPrintconfiguration(File printConfiguration) + { + configuration.printConfiguration = optionalFile(printConfiguration); + } + + + public void setDump(File dump) + { + configuration.dump = optionalFile(dump); + } + + + // Implementations for Task. + + public void execute() throws BuildException + { + try + { + ProGuard proGuard = new ProGuard(configuration); + proGuard.execute(); + } + catch (IOException ex) + { + throw new BuildException(ex.getMessage()); + } + } + + + // Small utility methods. + + /** + * Returns a file that is properly resolved with respect to the project + * directory, or null or empty if its name is actually a + * boolean flag. + */ + private File optionalFile(File file) + { + String fileName = file.getName(); + + return + fileName.equalsIgnoreCase("false") || + fileName.equalsIgnoreCase("no") || + fileName.equalsIgnoreCase("off") ? null : + fileName.equalsIgnoreCase("true") || + fileName.equalsIgnoreCase("yes") || + fileName.equalsIgnoreCase("on") ? new File("") : + resolvedFile(file); + } + + + /** + * Returns a file that is properly resolved with respect to the project + * directory. + */ + private File resolvedFile(File file) + { + return file.isAbsolute() ? file : + new File(getProject().getBaseDir(), + file.getName()); + } +} diff --git a/src/proguard/ant/package.html b/src/proguard/ant/package.html new file mode 100644 index 0000000..75e0466 --- /dev/null +++ b/src/proguard/ant/package.html @@ -0,0 +1,3 @@ + +This package contains the Ant task for ProGuard. + diff --git a/src/proguard/ant/task.properties b/src/proguard/ant/task.properties new file mode 100644 index 0000000..b676db7 --- /dev/null +++ b/src/proguard/ant/task.properties @@ -0,0 +1,2 @@ +proguard = proguard.ant.ProGuardTask +proguardconfiguration = proguard.ant.ConfigurationTask diff --git a/src/proguard/classfile/ClassConstants.java b/src/proguard/classfile/ClassConstants.java new file mode 100644 index 0000000..3b243e0 --- /dev/null +++ b/src/proguard/classfile/ClassConstants.java @@ -0,0 +1,255 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +/** + * Constants used in representing a Java class (*.class). + * + * @author Eric Lafortune + */ +public interface ClassConstants +{ + public static final String CLASS_FILE_EXTENSION = ".class"; + + public static final int MAGIC = 0xCAFEBABE; + + public static final int INTERNAL_CLASS_VERSION_1_0_MAJOR = 45; + public static final int INTERNAL_CLASS_VERSION_1_0_MINOR = 3; + public static final int INTERNAL_CLASS_VERSION_1_2_MAJOR = 46; + public static final int INTERNAL_CLASS_VERSION_1_2_MINOR = 0; + public static final int INTERNAL_CLASS_VERSION_1_3_MAJOR = 47; + public static final int INTERNAL_CLASS_VERSION_1_3_MINOR = 0; + public static final int INTERNAL_CLASS_VERSION_1_4_MAJOR = 48; + public static final int INTERNAL_CLASS_VERSION_1_4_MINOR = 0; + public static final int INTERNAL_CLASS_VERSION_1_5_MAJOR = 49; + public static final int INTERNAL_CLASS_VERSION_1_5_MINOR = 0; + public static final int INTERNAL_CLASS_VERSION_1_6_MAJOR = 50; + public static final int INTERNAL_CLASS_VERSION_1_6_MINOR = 0; + + public static final int INTERNAL_CLASS_VERSION_1_0 = (INTERNAL_CLASS_VERSION_1_0_MAJOR << 16) | INTERNAL_CLASS_VERSION_1_0_MINOR; + public static final int INTERNAL_CLASS_VERSION_1_2 = (INTERNAL_CLASS_VERSION_1_2_MAJOR << 16) | INTERNAL_CLASS_VERSION_1_2_MINOR; + public static final int INTERNAL_CLASS_VERSION_1_3 = (INTERNAL_CLASS_VERSION_1_3_MAJOR << 16) | INTERNAL_CLASS_VERSION_1_3_MINOR; + public static final int INTERNAL_CLASS_VERSION_1_4 = (INTERNAL_CLASS_VERSION_1_4_MAJOR << 16) | INTERNAL_CLASS_VERSION_1_4_MINOR; + public static final int INTERNAL_CLASS_VERSION_1_5 = (INTERNAL_CLASS_VERSION_1_5_MAJOR << 16) | INTERNAL_CLASS_VERSION_1_5_MINOR; + public static final int INTERNAL_CLASS_VERSION_1_6 = (INTERNAL_CLASS_VERSION_1_6_MAJOR << 16) | INTERNAL_CLASS_VERSION_1_6_MINOR; + + public static final String EXTERNAL_CLASS_VERSION_1_0 = "1.0"; + public static final String EXTERNAL_CLASS_VERSION_1_1 = "1.1"; + public static final String EXTERNAL_CLASS_VERSION_1_2 = "1.2"; + public static final String EXTERNAL_CLASS_VERSION_1_3 = "1.3"; + public static final String EXTERNAL_CLASS_VERSION_1_4 = "1.4"; + public static final String EXTERNAL_CLASS_VERSION_1_5 = "1.5"; + public static final String EXTERNAL_CLASS_VERSION_1_6 = "1.6"; + public static final String EXTERNAL_CLASS_VERSION_1_5_ALIAS = "5"; + public static final String EXTERNAL_CLASS_VERSION_1_6_ALIAS = "6"; + + public static final int INTERNAL_ACC_PUBLIC = 0x0001; + public static final int INTERNAL_ACC_PRIVATE = 0x0002; + public static final int INTERNAL_ACC_PROTECTED = 0x0004; + public static final int INTERNAL_ACC_STATIC = 0x0008; + public static final int INTERNAL_ACC_FINAL = 0x0010; + public static final int INTERNAL_ACC_SUPER = 0x0020; + public static final int INTERNAL_ACC_SYNCHRONIZED = 0x0020; + public static final int INTERNAL_ACC_VOLATILE = 0x0040; + public static final int INTERNAL_ACC_TRANSIENT = 0x0080; + public static final int INTERNAL_ACC_BRIDGE = 0x0040; + public static final int INTERNAL_ACC_VARARGS = 0x0080; + public static final int INTERNAL_ACC_NATIVE = 0x0100; + public static final int INTERNAL_ACC_INTERFACE = 0x0200; + public static final int INTERNAL_ACC_ABSTRACT = 0x0400; + public static final int INTERNAL_ACC_STRICT = 0x0800; + public static final int INTERNAL_ACC_SYNTHETIC = 0x1000; + public static final int INTERNAL_ACC_ANNOTATTION = 0x2000; + public static final int INTERNAL_ACC_ENUM = 0x4000; + + public static final int VALID_INTERNAL_ACC_CLASS = INTERNAL_ACC_PUBLIC | + INTERNAL_ACC_FINAL | + INTERNAL_ACC_SUPER | + INTERNAL_ACC_INTERFACE | + INTERNAL_ACC_ABSTRACT | + INTERNAL_ACC_SYNTHETIC | + INTERNAL_ACC_ANNOTATTION | + INTERNAL_ACC_ENUM; + public static final int VALID_INTERNAL_ACC_FIELD = INTERNAL_ACC_PUBLIC | + INTERNAL_ACC_PRIVATE | + INTERNAL_ACC_PROTECTED | + INTERNAL_ACC_STATIC | + INTERNAL_ACC_FINAL | + INTERNAL_ACC_VOLATILE | + INTERNAL_ACC_TRANSIENT | + INTERNAL_ACC_SYNTHETIC | + INTERNAL_ACC_ENUM; + public static final int VALID_INTERNAL_ACC_METHOD = INTERNAL_ACC_PUBLIC | + INTERNAL_ACC_PRIVATE | + INTERNAL_ACC_PROTECTED | + INTERNAL_ACC_STATIC | + INTERNAL_ACC_FINAL | + INTERNAL_ACC_SYNCHRONIZED | + INTERNAL_ACC_BRIDGE | + INTERNAL_ACC_VARARGS | + INTERNAL_ACC_NATIVE | + INTERNAL_ACC_ABSTRACT | + INTERNAL_ACC_STRICT | + INTERNAL_ACC_SYNTHETIC; + + public static final String EXTERNAL_ACC_PUBLIC = "public"; + public static final String EXTERNAL_ACC_PRIVATE = "private"; + public static final String EXTERNAL_ACC_PROTECTED = "protected"; + public static final String EXTERNAL_ACC_STATIC = "static"; + public static final String EXTERNAL_ACC_FINAL = "final"; + public static final String EXTERNAL_ACC_SUPER = "super"; + public static final String EXTERNAL_ACC_SYNCHRONIZED = "synchronized"; + public static final String EXTERNAL_ACC_VOLATILE = "volatile"; + public static final String EXTERNAL_ACC_TRANSIENT = "transient"; + public static final String EXTERNAL_ACC_NATIVE = "native"; + public static final String EXTERNAL_ACC_INTERFACE = "interface"; + public static final String EXTERNAL_ACC_ABSTRACT = "abstract"; + public static final String EXTERNAL_ACC_STRICT = "strictfp"; + public static final String EXTERNAL_ACC_ANNOTATION = "@"; + public static final String EXTERNAL_ACC_ENUM = "enum"; + + public static final int CONSTANT_Utf8 = 1; + public static final int CONSTANT_Integer = 3; + public static final int CONSTANT_Float = 4; + public static final int CONSTANT_Long = 5; + public static final int CONSTANT_Double = 6; + public static final int CONSTANT_Class = 7; + public static final int CONSTANT_String = 8; + public static final int CONSTANT_Fieldref = 9; + public static final int CONSTANT_Methodref = 10; + public static final int CONSTANT_InterfaceMethodref = 11; + public static final int CONSTANT_NameAndType = 12; + + public static final String ATTR_SourceFile = "SourceFile"; + public static final String ATTR_SourceDir = "SourceDir"; + public static final String ATTR_InnerClasses = "InnerClasses"; + public static final String ATTR_EnclosingMethod = "EnclosingMethod"; + public static final String ATTR_Deprecated = "Deprecated"; + public static final String ATTR_Synthetic = "Synthetic"; + public static final String ATTR_Signature = "Signature"; + public static final String ATTR_ConstantValue = "ConstantValue"; + public static final String ATTR_Exceptions = "Exceptions"; + public static final String ATTR_Code = "Code"; + public static final String ATTR_StackMap = "StackMap"; + public static final String ATTR_StackMapTable = "StackMapTable"; + public static final String ATTR_LineNumberTable = "LineNumberTable"; + public static final String ATTR_LocalVariableTable = "LocalVariableTable"; + public static final String ATTR_LocalVariableTypeTable = "LocalVariableTypeTable"; + public static final String ATTR_RuntimeVisibleAnnotations = "RuntimeVisibleAnnotations"; + public static final String ATTR_RuntimeInvisibleAnnotations = "RuntimeInvisibleAnnotations"; + public static final String ATTR_RuntimeVisibleParameterAnnotations = "RuntimeVisibleParameterAnnotations"; + public static final String ATTR_RuntimeInvisibleParameterAnnotations = "RuntimeInvisibleParameterAnnotations"; + public static final String ATTR_AnnotationDefault = "AnnotationDefault"; + + public static final int ELEMENT_VALUE_STRING_CONSTANT = 's'; + public static final int ELEMENT_VALUE_ENUM_CONSTANT = 'e'; + public static final int ELEMENT_VALUE_CLASS = 'c'; + public static final int ELEMENT_VALUE_ANNOTATION = '@'; + public static final int ELEMENT_VALUE_ARRAY = '['; + + public static final char EXTERNAL_PACKAGE_SEPARATOR = '.'; + public static final char EXTERNAL_INNER_CLASS_SEPARATOR = '.'; + public static final char INTERNAL_PACKAGE_SEPARATOR = '/'; + public static final char INTERNAL_INNER_CLASS_SEPARATOR = '$'; + public static final char SPECIAL_CLASS_CHARACTER = '-'; + public static final char SPECIAL_MEMBER_SEPARATOR = '$'; + + public static final char EXTERNAL_METHOD_ARGUMENTS_OPEN = '('; + public static final char EXTERNAL_METHOD_ARGUMENTS_CLOSE = ')'; + public static final char EXTERNAL_METHOD_ARGUMENTS_SEPARATOR = ','; + + public static final char INTERNAL_METHOD_ARGUMENTS_OPEN = '('; + public static final char INTERNAL_METHOD_ARGUMENTS_CLOSE = ')'; + + public static final String INTERNAL_PACKAGE_JAVA_LANG = "java/lang/"; + public static final String INTERNAL_NAME_JAVA_LANG_OBJECT = "java/lang/Object"; + public static final String INTERNAL_TYPE_JAVA_LANG_OBJECT = "Ljava/lang/Object;"; + public static final String INTERNAL_NAME_JAVA_LANG_CLONEABLE = "java/lang/Cloneable"; + public static final String INTERNAL_NAME_JAVA_LANG_THROWABLE = "java/lang/Throwable"; + public static final String INTERNAL_NAME_JAVA_LANG_CLASS = "java/lang/Class"; + public static final String INTERNAL_NAME_JAVA_LANG_STRING = "java/lang/String"; + public static final String INTERNAL_NAME_JAVA_IO_SERIALIZABLE = "java/io/Serializable"; + + public static final String INTERNAL_METHOD_NAME_INIT = ""; + public static final String INTERNAL_METHOD_TYPE_INIT = "()V"; + public static final String INTERNAL_METHOD_NAME_CLINIT = ""; + public static final String INTERNAL_METHOD_TYPE_CLINIT = "()V"; + + public static final String INTERNAL_METHOD_NAME_CLASS_FOR_NAME = "forName"; + public static final String INTERNAL_METHOD_TYPE_CLASS_FOR_NAME = "(Ljava/lang/String;)Ljava/lang/Class;"; + public static final String INTERNAL_METHOD_NAME_CLASS_GET_COMPONENT_TYPE = "getComponentType"; + public static final String INTERNAL_METHOD_TYPE_CLASS_GET_COMPONENT_TYPE = "()Ljava/lang/Class;"; + public static final String INTERNAL_METHOD_NAME_CLASS_GET_FIELD = "getField"; + public static final String INTERNAL_METHOD_TYPE_CLASS_GET_FIELD = "(Ljava/lang/String;)Ljava/lang/reflect/Field;"; + public static final String INTERNAL_METHOD_NAME_CLASS_GET_DECLARED_FIELD = "getDeclaredField"; + public static final String INTERNAL_METHOD_TYPE_CLASS_GET_DECLARED_FIELD = "(Ljava/lang/String;)Ljava/lang/reflect/Field;"; + public static final String INTERNAL_METHOD_NAME_CLASS_GET_METHOD = "getMethod"; + public static final String INTERNAL_METHOD_TYPE_CLASS_GET_METHOD = "(Ljava/lang/String;[Ljava/lang/Class;)Ljava/lang/reflect/Method;"; + public static final String INTERNAL_METHOD_NAME_CLASS_GET_DECLARED_METHOD = "getDeclaredMethod"; + public static final String INTERNAL_METHOD_TYPE_CLASS_GET_DECLARED_METHOD = "(Ljava/lang/String;[Ljava/lang/Class;)Ljava/lang/reflect/Method;"; + + public static final String INTERNAL_METHOD_NAME_DOT_CLASS_JAVAC = "class$"; + public static final String INTERNAL_METHOD_TYPE_DOT_CLASS_JAVAC = "(Ljava/lang/String;)Ljava/lang/Class;"; + public static final String INTERNAL_METHOD_NAME_DOT_CLASS_JIKES = "class"; + public static final String INTERNAL_METHOD_TYPE_DOT_CLASS_JIKES = "(Ljava/lang/String;Z)Ljava/lang/Class;"; + + public static final String INTERNAL_METHOD_NAME_NEW_INSTANCE = "newInstance"; + public static final String INTERNAL_METHOD_TYPE_NEW_INSTANCE = "()Ljava/lang/Object;"; + + public static final char INTERNAL_TYPE_VOID = 'V'; + public static final char INTERNAL_TYPE_BOOLEAN = 'Z'; + public static final char INTERNAL_TYPE_BYTE = 'B'; + public static final char INTERNAL_TYPE_CHAR = 'C'; + public static final char INTERNAL_TYPE_SHORT = 'S'; + public static final char INTERNAL_TYPE_INT = 'I'; + public static final char INTERNAL_TYPE_LONG = 'J'; + public static final char INTERNAL_TYPE_FLOAT = 'F'; + public static final char INTERNAL_TYPE_DOUBLE = 'D'; + public static final char INTERNAL_TYPE_CLASS_START = 'L'; + public static final char INTERNAL_TYPE_CLASS_END = ';'; + public static final char INTERNAL_TYPE_ARRAY = '['; + public static final char INTERNAL_TYPE_GENERIC_VARIABLE_START = 'T'; + public static final char INTERNAL_TYPE_GENERIC_START = '<'; + public static final char INTERNAL_TYPE_GENERIC_BOUND = ':'; + public static final char INTERNAL_TYPE_GENERIC_END = '>'; + + public static final String EXTERNAL_TYPE_JAVA_LANG_OBJECT = "java.lang.Object"; + public static final String EXTERNAL_PACKAGE_JAVA_LANG = "java.lang."; + + public static final String EXTERNAL_TYPE_VOID = "void"; + public static final String EXTERNAL_TYPE_BOOLEAN = "boolean"; + public static final String EXTERNAL_TYPE_BYTE = "byte"; + public static final String EXTERNAL_TYPE_CHAR = "char"; + public static final String EXTERNAL_TYPE_SHORT = "short"; + public static final String EXTERNAL_TYPE_INT = "int"; + public static final String EXTERNAL_TYPE_FLOAT = "float"; + public static final String EXTERNAL_TYPE_LONG = "long"; + public static final String EXTERNAL_TYPE_DOUBLE = "double"; + public static final String EXTERNAL_TYPE_ARRAY = "[]"; + + public static final int TYPICAL_CONSTANT_POOL_SIZE = 256; + public static final int TYPICAL_FIELD_COUNT = 64; + public static final int TYPICAL_METHOD_COUNT = 64; + public static final int TYPICAL_CODE_LENGTH = 1024; + public static final int TYPICAL_EXCEPTION_TABLE_LENGTH = 16; + public static final int TYPICAL_VARIABLES_SIZE = 64; + public static final int TYPICAL_STACK_SIZE = 16; +} diff --git a/src/proguard/classfile/ClassPool.java b/src/proguard/classfile/ClassPool.java new file mode 100644 index 0000000..57728a5 --- /dev/null +++ b/src/proguard/classfile/ClassPool.java @@ -0,0 +1,147 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.util.ClassUtil; +import proguard.classfile.visitor.*; + +import java.util.*; + +/** + * This is a set of representations of classes. They can be enumerated or + * retrieved by name. They can also be accessed by means of class visitors. + * + * @author Eric Lafortune + */ +public class ClassPool +{ + private final Map classes = new HashMap(); + + + /** + * Clears the class pool. + */ + public void clear() + { + classes.clear(); + } + + + /** + * Adds the given Clazz to the class pool. + */ + public void addClass(Clazz clazz) + { + classes.put(clazz.getName(), clazz); + } + + + /** + * Removes the given Clazz from the class pool. + */ + public void removeClass(Clazz clazz) + { + classes.remove(clazz.getName()); + } + + + /** + * Returns a Clazz from the class pool based on its name. Returns + * null if the class with the given name is not in the class + * pool. Returns the base class if the class name is an array type. + */ + public Clazz getClass(String className) + { + return (Clazz)classes.get(ClassUtil.internalClassNameFromClassType(className)); + } + + + /** + * Returns an Iterator of all class names in the class pool. + */ + public Iterator classNames() + { + return classes.keySet().iterator(); + } + + + /** + * Returns the number of classes in the class pool. + */ + public int size() + { + return classes.size(); + } + + + /** + * Applies the given ClassPoolVisitor to the class pool. + */ + public void accept(ClassPoolVisitor classPoolVisitor) + { + classPoolVisitor.visitClassPool(this); + } + + + /** + * Applies the given ClassVisitor to all classes in the class pool, + * in random order. + */ + public void classesAccept(ClassVisitor classVisitor) + { + Iterator iterator = classes.values().iterator(); + while (iterator.hasNext()) + { + Clazz clazz = (Clazz)iterator.next(); + clazz.accept(classVisitor); + } + } + + + /** + * Applies the given ClassVisitor to all classes in the class pool, + * in sorted order. + */ + public void classesAcceptAlphabetically(ClassVisitor classVisitor) + { + TreeMap sortedClasses = new TreeMap(classes); + Iterator iterator = sortedClasses.values().iterator(); + while (iterator.hasNext()) + { + Clazz clazz = (Clazz)iterator.next(); + clazz.accept(classVisitor); + } + } + + + /** + * Applies the given ClassVisitor to the class with the given name, + * if it is present in the class pool. + */ + public void classAccept(String className, ClassVisitor classVisitor) + { + Clazz clazz = getClass(className); + if (clazz != null) + { + clazz.accept(classVisitor); + } + } +} diff --git a/src/proguard/classfile/Clazz.java b/src/proguard/classfile/Clazz.java new file mode 100644 index 0000000..da37d9a --- /dev/null +++ b/src/proguard/classfile/Clazz.java @@ -0,0 +1,232 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.visitor.*; + + +/** + * This interface provides access to the representation of a Java class. + * + * @author Eric Lafortune + */ +public interface Clazz extends VisitorAccepter +{ + /** + * Returns the access flags of this class. + * @see ClassConstants + */ + public int getAccessFlags(); + + /** + * Returns the full internal name of this class. + */ + public String getName(); + + /** + * Returns the full internal name of the super class of this class, or + * null if this class represents java.lang.Object. + */ + public String getSuperName(); + + /** + * Returns the number of interfaces that this class implements. + */ + public int getInterfaceCount(); + + /** + * Returns the full internal name of the interface at the given index of + * this class. + */ + public String getInterfaceName(int index); + + /** + * Returns the tag value of the Constant at the specified index. + */ + public int getTag(int constantIndex); + + /** + * Returns the String value of the Utf8Constant at the specified index. + */ + public String getString(int constantIndex); + + /** + * Returns the String value of the StringConstant at the specified index. + */ + public String getStringString(int constantIndex); + + /** + * Returns the class name of ClassConstant at the specified index. + */ + public String getClassName(int constantIndex); + + /** + * Returns the name of the NameAndTypeConstant at the specified index. + */ + public String getName(int constantIndex); + + /** + * Returns the type of the NameAndTypeConstant at the specified index. + */ + public String getType(int constantIndex); + + + // Methods pertaining to related classes. + + /** + * Notifies this Clazz that it is being subclassed by another class. + */ + public void addSubClass(Clazz clazz); + + /** + * Returns the super class of this class. + */ + public Clazz getSuperClass(); + + /** + * Returns the interface at the given index. + */ + public Clazz getInterface(int index); + + /** + * Returns whether this class extends the given class. + * A class is always considered to extend itself. + * Interfaces are considered to only extend the root Object class. + */ + public boolean extends_(Clazz clazz); + + /** + * Returns whether this class implements the given class. + * A class is always considered to implement itself. + * Interfaces are considered to implement all their superinterfaces. + */ + public boolean extendsOrImplements(Clazz clazz); + + + // Methods for getting specific class members. + + /** + * Returns the field with the given name and descriptor. + */ + Field findField(String name, String descriptor); + + /** + * Returns the method with the given name and descriptor. + */ + Method findMethod(String name, String descriptor); + + + // Methods for accepting various types of visitors. + + /** + * Accepts the given class visitor. + */ + public void accept(ClassVisitor classVisitor); + + /** + * Accepts the given class visitor in the class hierarchy. + * @param visitThisClass specifies whether to visit this class. + * @param visitSuperClass specifies whether to visit the super classes. + * @param visitInterfaces specifies whether to visit the interfaces. + * @param visitSubclasses specifies whether to visit the subclasses. + * @param classVisitor the ClassVisitor that will + * visit the class hierarchy. + */ + public void hierarchyAccept(boolean visitThisClass, + boolean visitSuperClass, + boolean visitInterfaces, + boolean visitSubclasses, + ClassVisitor classVisitor); + + /** + * Lets the given class visitor visit all known subclasses. + * @param classVisitor the ClassVisitor that will visit the + * subclasses. + */ + public void subclassesAccept(ClassVisitor classVisitor); + + /** + * Lets the given constant pool entry visitor visit all constant pool entries + * of this class. + */ + public void constantPoolEntriesAccept(ConstantVisitor constantVisitor); + + /** + * Lets the given constant pool entry visitor visit the constant pool entry + * at the specified index. + */ + public void constantPoolEntryAccept(int index, ConstantVisitor constantVisitor); + + /** + * Lets the given constant pool entry visitor visit the class constant pool + * entry of this class. + */ + public void thisClassConstantAccept(ConstantVisitor constantVisitor); + + /** + * Lets the given constant pool entry visitor visit the class constant pool + * entry of the super class of this class, if there is one. + */ + public void superClassConstantAccept(ConstantVisitor constantVisitor); + + /** + * Lets the given constant pool entry visitor visit the class constant pool + * entries for all interfaces of this class. + */ + public void interfaceConstantsAccept(ConstantVisitor constantVisitor); + + /** + * Lets the given member info visitor visit all fields of this class. + */ + public void fieldsAccept(MemberVisitor memberVisitor); + + /** + * Lets the given member info visitor visit the specified field. + */ + public void fieldAccept(String name, String descriptor, MemberVisitor memberVisitor); + + /** + * Lets the given member info visitor visit all methods of this class. + */ + public void methodsAccept(MemberVisitor memberVisitor); + + /** + * Lets the given member info visitor visit the specified method. + */ + public void methodAccept(String name, String descriptor, MemberVisitor memberVisitor); + + /** + * Returns whether the given method may possibly have implementing or + * overriding methods down the class hierarchy. This can only be true + * if the class is not final, and the method is not private, static, or + * final, or a constructor. + * @param method the method that may have implementations. + * @return whether it may have implementations. + */ + public boolean mayHaveImplementations(Method method); + + /** + * Lets the given attribute info visitor visit all attributes of this class. + */ + public void attributesAccept(AttributeVisitor attributeVisitor); +} diff --git a/src/proguard/classfile/Field.java b/src/proguard/classfile/Field.java new file mode 100644 index 0000000..ba1315a --- /dev/null +++ b/src/proguard/classfile/Field.java @@ -0,0 +1,32 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + + + +/** + * Representation of a field from a class. + * + * @author Eric Lafortune + */ +public interface Field extends Member +{ +} diff --git a/src/proguard/classfile/LibraryClass.java b/src/proguard/classfile/LibraryClass.java new file mode 100644 index 0000000..0a27593 --- /dev/null +++ b/src/proguard/classfile/LibraryClass.java @@ -0,0 +1,489 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This Clazz is a compact representation of the essential data in a Java class. + * + * @author Eric Lafortune + */ +public class LibraryClass implements Clazz +{ + public int u2accessFlags; + public String thisClassName; + public String superClassName; + public String[] interfaceNames; + public LibraryField[] fields; + public LibraryMethod[] methods; + + /** + * An extra field pointing to the superclass of this class. + * This field is filled out by the {@link ClassSuperHierarchyInitializer}. + */ + public Clazz superClass; + + /** + * An extra field pointing to the interfaces of this class. + * This field is filled out by the {@link ClassSuperHierarchyInitializer}. + */ + public Clazz[] interfaceClasses; + + /** + * An extra field pointing to the subclasses of this class. + * This field is filled out by the {@link ClassSubHierarchyInitializer}. + */ + public Clazz[] subClasses; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an empty LibraryClass. + */ + public LibraryClass() {} + + + /** + * Returns whether this library class is visible to the outside world. + */ + boolean isVisible() + { + return (u2accessFlags & ClassConstants.INTERNAL_ACC_PUBLIC) != 0; + } + + + // Implementations for Clazz. + + public int getAccessFlags() + { + return u2accessFlags; + } + + public String getName() + { + return thisClassName; + } + + public String getSuperName() + { + // This may be java/lang/Object, in which case there is no super. + return superClassName; + } + + public int getInterfaceCount() + { + return interfaceClasses.length; + } + + public String getInterfaceName(int index) + { + return interfaceNames[index]; + } + + public int getTag(int constantIndex) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store constant pool"); + } + + public String getString(int constantIndex) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store constant pool"); + } + + public String getStringString(int constantIndex) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store constant pool"); + } + + public String getClassName(int constantIndex) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store constant pool"); + } + + public String getName(int constantIndex) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store constant pool"); + } + + public String getType(int constantIndex) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store constant pool"); + } + + + public void addSubClass(Clazz clazz) + { + if (subClasses == null) + { + subClasses = new Clazz[1]; + } + else + { + // Copy the old elements into new larger array. + Clazz[] temp = new Clazz[subClasses.length+1]; + System.arraycopy(subClasses, 0, temp, 0, subClasses.length); + subClasses = temp; + } + + subClasses[subClasses.length-1] = clazz; + } + + + public Clazz getSuperClass() + { + return superClass; + } + + + public Clazz getInterface(int index) + { + return interfaceClasses[index]; + } + + + public boolean extends_(Clazz clazz) + { + if (this.equals(clazz)) + { + return true; + } + + return superClass != null && + superClass.extends_(clazz); + } + + + public boolean extendsOrImplements(Clazz clazz) + { + if (this.equals(clazz)) + { + return true; + } + + if (superClass != null && + superClass.extendsOrImplements(clazz)) + { + return true; + } + + if (interfaceClasses != null) + { + for (int index = 0; index < interfaceClasses.length; index++) + { + Clazz interfaceClass = interfaceClasses[index]; + if (interfaceClass != null && + interfaceClass.extendsOrImplements(clazz)) + { + return true; + } + } + } + + return false; + } + + + public Field findField(String name, String descriptor) + { + for (int index = 0; index < fields.length; index++) + { + Field field = fields[index]; + if (field != null && + (name == null || field.getName(this).equals(name)) && + (descriptor == null || field.getDescriptor(this).equals(descriptor))) + { + return field; + } + } + + return null; + } + + + public Method findMethod(String name, String descriptor) + { + for (int index = 0; index < methods.length; index++) + { + Method method = methods[index]; + if (method != null && + (name == null || method.getName(this).equals(name)) && + (descriptor == null || method.getDescriptor(this).equals(descriptor))) + { + return method; + } + } + + return null; + } + + + public void accept(ClassVisitor classVisitor) + { + classVisitor.visitLibraryClass(this); + } + + + public void hierarchyAccept(boolean visitThisClass, + boolean visitSuperClass, + boolean visitInterfaces, + boolean visitSubclasses, + ClassVisitor classVisitor) + { + // First visit the current classfile. + if (visitThisClass) + { + accept(classVisitor); + } + + // Then visit its superclass, recursively. + if (visitSuperClass) + { + if (superClass != null) + { + superClass.hierarchyAccept(true, + true, + visitInterfaces, + false, + classVisitor); + } + } + + // Then visit its interfaces, recursively. + if (visitInterfaces) + { + // Visit the interfaces of the superclasses, if we haven't done so yet. + if (!visitSuperClass) + { + if (superClass != null) + { + superClass.hierarchyAccept(false, + false, + true, + false, + classVisitor); + } + } + + // Visit the interfaces. + if (interfaceClasses != null) + { + for (int index = 0; index < interfaceClasses.length; index++) + { + Clazz interfaceClass = interfaceClasses[index]; + if (interfaceClass != null) + { + interfaceClass.hierarchyAccept(true, + false, + true, + false, + classVisitor); + } + } + } + } + + // Then visit its subclasses, recursively. + if (visitSubclasses) + { + if (subClasses != null) + { + for (int index = 0; index < subClasses.length; index++) + { + subClasses[index].hierarchyAccept(true, + false, + false, + true, + classVisitor); + } + } + } + } + + + /** + * Lets the given class visitor visit the superclass, if it is known. + * @param classVisitor the ClassVisitor that will visit the + * superclass. + */ + public void superClassAccept(ClassVisitor classVisitor) + { + if (superClass != null) + { + superClass.accept(classVisitor); + } + } + + + /** + * Lets the given class visitor visit all known direct interfaces. + * @param classVisitor the ClassVisitor that will visit the + * interfaces. + */ + public void interfacesAccept(ClassVisitor classVisitor) + { + if (interfaceClasses != null) + { + for (int index = 0; index < interfaceClasses.length; index++) + { + Clazz interfaceClass = interfaceClasses[index]; + if (interfaceClass != null) + { + interfaceClass.accept(classVisitor); + } + } + } + } + + + public void subclassesAccept(ClassVisitor classVisitor) + { + if (subClasses != null) + { + for (int index = 0; index < subClasses.length; index++) + { + subClasses[index].accept(classVisitor); + } + } + } + + + public void constantPoolEntriesAccept(ConstantVisitor constantVisitor) + { + // This class doesn't keep references to its constant pool entries. + } + + + public void constantPoolEntryAccept(int index, ConstantVisitor constantVisitor) + { + // This class doesn't keep references to its constant pool entries. + } + + + public void thisClassConstantAccept(ConstantVisitor constantVisitor) + { + // This class doesn't keep references to its constant pool entries. + } + + + public void superClassConstantAccept(ConstantVisitor constantVisitor) + { + // This class doesn't keep references to its constant pool entries. + } + + + public void interfaceConstantsAccept(ConstantVisitor constantVisitor) + { + // This class doesn't keep references to its constant pool entries. + } + + + public void fieldsAccept(MemberVisitor memberVisitor) + { + for (int index = 0; index < fields.length; index++) + { + Field field = fields[index]; + if (field != null) + { + field.accept(this, memberVisitor); + } + } + } + + + public void fieldAccept(String name, String descriptor, MemberVisitor memberVisitor) + { + Field field = findField(name, descriptor); + if (field != null) + { + field.accept(this, memberVisitor); + } + } + + + public void methodsAccept(MemberVisitor memberVisitor) + { + for (int index = 0; index < methods.length; index++) + { + Method method = methods[index]; + if (method != null) + { + method.accept(this, memberVisitor); + } + } + } + + + public void methodAccept(String name, String descriptor, MemberVisitor memberVisitor) + { + Method method = findMethod(name, descriptor); + if (method != null) + { + method.accept(this, memberVisitor); + } + } + + + public boolean mayHaveImplementations(Method method) + { + return + (u2accessFlags & ClassConstants.INTERNAL_ACC_FINAL) == 0 && + (method == null || + ((method.getAccessFlags() & (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC | + ClassConstants.INTERNAL_ACC_FINAL)) == 0 && + !method.getName(this).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT))); + } + + + public void attributesAccept(AttributeVisitor attributeVisitor) + { + throw new UnsupportedOperationException("Library class ["+thisClassName+"] doesn't store attributes"); + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } + + + // Implementations for Object. + + public String toString() + { + return "LibraryClass("+getName()+")"; + } +} diff --git a/src/proguard/classfile/LibraryField.java b/src/proguard/classfile/LibraryField.java new file mode 100644 index 0000000..2908c37 --- /dev/null +++ b/src/proguard/classfile/LibraryField.java @@ -0,0 +1,77 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.visitor.*; + +/** + * Representation of a field from a class-file. + * + * @author Eric Lafortune + */ +public class LibraryField extends LibraryMember implements Field +{ + /** + * An extra field pointing to the Clazz object referenced in the + * descriptor string. This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz referencedClass; + + + /** + * Creates an uninitialized LibraryField. + */ + public LibraryField() + { + } + + + /** + * Creates an initialized LibraryField. + */ + public LibraryField(int u2accessFlags, + String name, + String descriptor) + { + super(u2accessFlags, name, descriptor); + } + + + // Implementations for LibraryMember. + + public void accept(LibraryClass libraryClass, MemberVisitor memberVisitor) + { + memberVisitor.visitLibraryField(libraryClass, this); + } + + + // Implementations for Member. + + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } +} diff --git a/src/proguard/classfile/LibraryMember.java b/src/proguard/classfile/LibraryMember.java new file mode 100644 index 0000000..41ccb60 --- /dev/null +++ b/src/proguard/classfile/LibraryMember.java @@ -0,0 +1,108 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.visitor.MemberVisitor; + +/** + * Representation of a field or method from a library class. + * + * @author Eric Lafortune + */ +public abstract class LibraryMember implements Member +{ + private static final int ACC_VISIBLE = ClassConstants.INTERNAL_ACC_PUBLIC | + ClassConstants.INTERNAL_ACC_PROTECTED; + + + public int u2accessFlags; + public String name; + public String descriptor; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an uninitialized LibraryMember. + */ + protected LibraryMember() + { + } + + + /** + * Creates an initialized LibraryMember. + */ + protected LibraryMember(int u2accessFlags, + String name, + String descriptor) + { + this.u2accessFlags = u2accessFlags; + this.name = name; + this.descriptor = descriptor; + } + + + /** + * Accepts the given member info visitor. + */ + public abstract void accept(LibraryClass libraryClass, + MemberVisitor memberVisitor); + + + // Implementations for Member. + + public int getAccessFlags() + { + return u2accessFlags; + } + + public String getName(Clazz clazz) + { + return name; + } + + public String getDescriptor(Clazz clazz) + { + return descriptor; + } + + public void accept(Clazz clazz, MemberVisitor memberVisitor) + { + accept((LibraryClass)clazz, memberVisitor); + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/LibraryMethod.java b/src/proguard/classfile/LibraryMethod.java new file mode 100644 index 0000000..a49a5f1 --- /dev/null +++ b/src/proguard/classfile/LibraryMethod.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.visitor.*; + +/** + * Representation of a method from a class-file. + * + * @author Eric Lafortune + */ +public class LibraryMethod extends LibraryMember implements Method +{ + /** + * An extra field pointing to the Clazz objects referenced in the + * descriptor string. This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + + /** + * Creates an uninitialized LibraryMethod. + */ + public LibraryMethod() + { + } + + + /** + * Creates an initialized LibraryMethod. + */ + public LibraryMethod(int u2accessFlags, + String name, + String descriptor) + { + super(u2accessFlags, name, descriptor); + } + + + // Implementations for LibraryMember. + + public void accept(LibraryClass libraryClass, MemberVisitor memberVisitor) + { + memberVisitor.visitLibraryMethod(libraryClass, this); + } + + + // Implementations for Member. + + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + if (referencedClasses[index] != null) + { + referencedClasses[index].accept(classVisitor); + } + } + } + } +} diff --git a/src/proguard/classfile/Member.java b/src/proguard/classfile/Member.java new file mode 100644 index 0000000..1400b9c --- /dev/null +++ b/src/proguard/classfile/Member.java @@ -0,0 +1,57 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.visitor.*; + +/** + * Representation of a field or method from a class. + * + * @author Eric Lafortune + */ +public interface Member extends VisitorAccepter +{ + /** + * Returns the access flags. + */ + public int getAccessFlags(); + + /** + * Returns the class member name. + */ + public String getName(Clazz clazz); + + /** + * Returns the class member's descriptor. + */ + public String getDescriptor(Clazz clazz); + + /** + * Accepts the given class visitor. + */ + public void accept(Clazz clazz, MemberVisitor memberVisitor); + + /** + * Lets the Clazz objects referenced in the descriptor string + * accept the given visitor. + */ + public void referencedClassesAccept(ClassVisitor classVisitor); +} diff --git a/src/proguard/classfile/Method.java b/src/proguard/classfile/Method.java new file mode 100644 index 0000000..ebcae2b --- /dev/null +++ b/src/proguard/classfile/Method.java @@ -0,0 +1,32 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + + + +/** + * Representation of a method from a class. + * + * @author Eric Lafortune + */ +public interface Method extends Member +{ +} diff --git a/src/proguard/classfile/ProgramClass.java b/src/proguard/classfile/ProgramClass.java new file mode 100644 index 0000000..9d0fc0c --- /dev/null +++ b/src/proguard/classfile/ProgramClass.java @@ -0,0 +1,494 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.ClassSubHierarchyInitializer; +import proguard.classfile.visitor.*; + +/** + * This Clazz is a complete representation of the data in a Java class. + * + * @author Eric Lafortune + */ +public class ProgramClass implements Clazz +{ + public int u4magic; + public int u4version; + public int u2constantPoolCount; + public Constant[] constantPool; + public int u2accessFlags; + public int u2thisClass; + public int u2superClass; + public int u2interfacesCount; + public int[] u2interfaces; + public int u2fieldsCount; + public ProgramField[] fields; + public int u2methodsCount; + public ProgramMethod[] methods; + public int u2attributesCount; + public Attribute[] attributes; + + /** + * An extra field pointing to the subclasses of this class. + * This field is filled out by the {@link ClassSubHierarchyInitializer}. + */ + public Clazz[] subClasses; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an uninitialized ProgramClass. + */ + public ProgramClass() {} + + + /** + * Returns the Constant at the given index in the constant pool. + */ + public Constant getConstant(int constantIndex) + { + return constantPool[constantIndex]; + } + + + // Implementations for Clazz. + + public int getAccessFlags() + { + return u2accessFlags; + } + + public String getName() + { + return getClassName(u2thisClass); + } + + public String getSuperName() + { + return u2superClass == 0 ? null : getClassName(u2superClass); + } + + public int getInterfaceCount() + { + return u2interfacesCount; + } + + public String getInterfaceName(int index) + { + return getClassName(u2interfaces[index]); + } + + public int getTag(int constantIndex) + { + return constantPool[constantIndex].getTag(); + } + + public String getString(int constantIndex) + { + try + { + return ((Utf8Constant)constantPool[constantIndex]).getString(); + } + catch (ClassCastException ex) + { + new ClassPrinter().visitProgramClass(this); + throw new ClassCastException("Expected Utf8Constant at index ["+constantIndex+"] in class ["+getName()+"], found ["+ex.getMessage()+"]"); + } + } + + public String getStringString(int constantIndex) + { + try + { + return ((StringConstant)constantPool[constantIndex]).getString(this); + } + catch (ClassCastException ex) + { + throw new ClassCastException("Expected StringConstant at index ["+constantIndex+"] in class ["+getName()+"], found ["+ex.getMessage()+"]"); + } + } + + public String getClassName(int constantIndex) + { + try + { + return ((ClassConstant)constantPool[constantIndex]).getName(this); + } + catch (ClassCastException ex) + { + throw new ClassCastException("Expected ClassConstant at index ["+constantIndex+"] in class ["+getName()+"], found ["+ex.getMessage()+"]"); + } + } + + public String getName(int constantIndex) + { + try + { + return ((NameAndTypeConstant)constantPool[constantIndex]).getName(this); + } + catch (ClassCastException ex) + { + throw new ClassCastException("Expected NameAndTypeConstant at index ["+constantIndex+"] in class ["+getName()+"], found ["+ex.getMessage()+"]"); + } + } + + public String getType(int constantIndex) + { + try + { + return ((NameAndTypeConstant)constantPool[constantIndex]).getType(this); + } + catch (ClassCastException ex) + { + throw new ClassCastException("Expected NameAndTypeConstant at index ["+constantIndex+"] in class ["+getName()+"], found ["+ex.getMessage()+"]"); + } + } + + + public void addSubClass(Clazz clazz) + { + if (subClasses == null) + { + subClasses = new Clazz[1]; + } + else + { + // Copy the old elements into new larger array. + Clazz[] temp = new Clazz[subClasses.length+1]; + System.arraycopy(subClasses, 0, temp, 0, subClasses.length); + subClasses = temp; + } + + subClasses[subClasses.length-1] = clazz; + } + + + public Clazz getSuperClass() + { + return u2superClass != 0 ? + ((ClassConstant)constantPool[u2superClass]).referencedClass : + null; + } + + + public Clazz getInterface(int index) + { + return ((ClassConstant)constantPool[u2interfaces[index]]).referencedClass; + } + + + public boolean extends_(Clazz clazz) + { + if (this.equals(clazz)) + { + return true; + } + + Clazz superClass = getSuperClass(); + return superClass != null && + superClass.extends_(clazz); + } + + + public boolean extendsOrImplements(Clazz clazz) + { + if (this.equals(clazz)) + { + return true; + } + + Clazz superClass = getSuperClass(); + if (superClass != null && + superClass.extendsOrImplements(clazz)) + { + return true; + } + + for (int index = 0; index < u2interfacesCount; index++) + { + Clazz interfaceClass = getInterface(index); + if (interfaceClass != null && + interfaceClass.extendsOrImplements(clazz)) + { + return true; + } + } + + return false; + } + + + public Field findField(String name, String descriptor) + { + for (int index = 0; index < u2fieldsCount; index++) + { + Field field = fields[index]; + if ((name == null || field.getName(this).equals(name)) && + (descriptor == null || field.getDescriptor(this).equals(descriptor))) + { + return field; + } + } + + return null; + } + + + public Method findMethod(String name, String descriptor) + { + for (int index = 0; index < u2methodsCount; index++) + { + Method method = methods[index]; + if ((name == null || method.getName(this).equals(name)) && + (descriptor == null || method.getDescriptor(this).equals(descriptor))) + { + return method; + } + } + + return null; + } + + + public void accept(ClassVisitor classVisitor) + { + classVisitor.visitProgramClass(this); + } + + + public void hierarchyAccept(boolean visitThisClass, + boolean visitSuperClass, + boolean visitInterfaces, + boolean visitSubclasses, + ClassVisitor classVisitor) + { + // First visit the current classfile. + if (visitThisClass) + { + accept(classVisitor); + } + + // Then visit its superclass, recursively. + if (visitSuperClass) + { + Clazz superClass = getSuperClass(); + if (superClass != null) + { + superClass.hierarchyAccept(true, + true, + visitInterfaces, + false, + classVisitor); + } + } + + // Then visit its interfaces, recursively. + if (visitInterfaces) + { + // Visit the interfaces of the superclasses, if we haven't done so yet. + if (!visitSuperClass) + { + Clazz superClass = getSuperClass(); + if (superClass != null) + { + superClass.hierarchyAccept(false, + false, + true, + false, + classVisitor); + } + } + + // Visit the interfaces. + for (int index = 0; index < u2interfacesCount; index++) + { + Clazz interfaceClass = getInterface(index); + if (interfaceClass != null) + { + interfaceClass.hierarchyAccept(true, + false, + true, + false, + classVisitor); + } + } + } + + // Then visit its subclasses, recursively. + if (visitSubclasses) + { + if (subClasses != null) + { + for (int index = 0; index < subClasses.length; index++) + { + Clazz subClass = subClasses[index]; + subClass.hierarchyAccept(true, + false, + false, + true, + classVisitor); + } + } + } + } + + + public void subclassesAccept(ClassVisitor classVisitor) + { + if (subClasses != null) + { + for (int index = 0; index < subClasses.length; index++) + { + subClasses[index].accept(classVisitor); + } + } + } + + + public void constantPoolEntriesAccept(ConstantVisitor constantVisitor) + { + for (int index = 1; index < u2constantPoolCount; index++) + { + if (constantPool[index] != null) + { + constantPool[index].accept(this, constantVisitor); + } + } + } + + + public void constantPoolEntryAccept(int index, ConstantVisitor constantVisitor) + { + constantPool[index].accept(this, constantVisitor); + } + + + public void thisClassConstantAccept(ConstantVisitor constantVisitor) + { + constantPool[u2thisClass].accept(this, constantVisitor); + } + + + public void superClassConstantAccept(ConstantVisitor constantVisitor) + { + if (u2superClass != 0) + { + constantPool[u2superClass].accept(this, constantVisitor); + } + } + + + public void interfaceConstantsAccept(ConstantVisitor constantVisitor) + { + for (int index = 0; index < u2interfacesCount; index++) + { + constantPool[u2interfaces[index]].accept(this, constantVisitor); + } + } + + + public void fieldsAccept(MemberVisitor memberVisitor) + { + for (int index = 0; index < u2fieldsCount; index++) + { + fields[index].accept(this, memberVisitor); + } + } + + + public void fieldAccept(String name, String descriptor, MemberVisitor memberVisitor) + { + Field field = findField(name, descriptor); + if (field != null) + { + field.accept(this, memberVisitor); + } + } + + + public void methodsAccept(MemberVisitor memberVisitor) + { + for (int index = 0; index < u2methodsCount; index++) + { + methods[index].accept(this, memberVisitor); + } + } + + + public void methodAccept(String name, String descriptor, MemberVisitor memberVisitor) + { + Method method = findMethod(name, descriptor); + if (method != null) + { + method.accept(this, memberVisitor); + } + } + + + public boolean mayHaveImplementations(Method method) + { + return + (u2accessFlags & ClassConstants.INTERNAL_ACC_FINAL) == 0 && + (method == null || + ((method.getAccessFlags() & (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC | + ClassConstants.INTERNAL_ACC_FINAL)) == 0 && + !method.getName(this).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT))); + } + + + public void attributesAccept(AttributeVisitor attributeVisitor) + { + for (int index = 0; index < u2attributesCount; index++) + { + attributes[index].accept(this, attributeVisitor); + } + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } + + + // Implementations for Object. + + public String toString() + { + return "ProgramClass("+getName()+")"; + } +} diff --git a/src/proguard/classfile/ProgramField.java b/src/proguard/classfile/ProgramField.java new file mode 100644 index 0000000..5991b00 --- /dev/null +++ b/src/proguard/classfile/ProgramField.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.visitor.*; + +/** + * Representation of a field from a program class. + * + * @author Eric Lafortune + */ +public class ProgramField extends ProgramMember implements Field +{ + /** + * An extra field pointing to the Clazz object referenced in the + * descriptor string. This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz referencedClass; + + + /** + * Creates an uninitialized ProgramField. + */ + public ProgramField() + { + } + + + /** + * Creates an initialized ProgramField. + */ + public ProgramField(int u2accessFlags, + int u2nameIndex, + int u2descriptorIndex, + int u2attributesCount, + Attribute[] attributes, + Clazz referencedClass) + { + super(u2accessFlags, u2nameIndex, u2descriptorIndex, u2attributesCount, attributes); + + this.referencedClass = referencedClass; + } + + + // Implementations for ProgramMember. + + public void accept(ProgramClass programClass, MemberVisitor memberVisitor) + { + memberVisitor.visitProgramField(programClass, this); + } + + + public void attributesAccept(ProgramClass programClass, AttributeVisitor attributeVisitor) + { + for (int index = 0; index < u2attributesCount; index++) + { + attributes[index].accept(programClass, this, attributeVisitor); + } + } + + + // Implementations for Member. + + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } +} diff --git a/src/proguard/classfile/ProgramMember.java b/src/proguard/classfile/ProgramMember.java new file mode 100644 index 0000000..ea6f46d --- /dev/null +++ b/src/proguard/classfile/ProgramMember.java @@ -0,0 +1,168 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + + +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * Representation of a field or method from a program class. + * + * @author Eric Lafortune + */ +public abstract class ProgramMember implements Member +{ + public int u2accessFlags; + public int u2nameIndex; + public int u2descriptorIndex; + public int u2attributesCount; + public Attribute[] attributes; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an uninitialized ProgramMember. + */ + protected ProgramMember() + { + } + + + /** + * Creates an initialized ProgramMember. + */ + protected ProgramMember(int u2accessFlags, + int u2nameIndex, + int u2descriptorIndex, + int u2attributesCount, + Attribute[] attributes) + { + this.u2accessFlags = u2accessFlags; + this.u2nameIndex = u2nameIndex; + this.u2descriptorIndex = u2descriptorIndex; + this.u2attributesCount = u2attributesCount; + this.attributes = attributes; + } + + + /** + * Returns the line number range of the given class member as "m:n", + * if it can find it, or null otherwise. + */ + public String getLineNumberRange(Clazz clazz) + { + CodeAttribute codeAttribute = + (CodeAttribute)getAttribute(clazz, ClassConstants.ATTR_Code); + if (codeAttribute == null) + { + return null; + } + + LineNumberTableAttribute lineNumberTableAttribute = + (LineNumberTableAttribute)codeAttribute.getAttribute(clazz, + ClassConstants.ATTR_LineNumberTable); + if (lineNumberTableAttribute == null) + { + return null; + } + + return "" + + lineNumberTableAttribute.getLineNumber(0) + + ":" + + lineNumberTableAttribute.getLineNumber(Integer.MAX_VALUE); + } + + + /** + * Returns the (first) attribute with the given name. + */ + private Attribute getAttribute(Clazz clazz, String name) + { + for (int index = 0; index < u2attributesCount; index++) + { + Attribute attribute = attributes[index]; + if (attribute.getAttributeName(clazz).equals(name)) + { + return attribute; + } + } + + return null; + } + + + /** + * Accepts the given member info visitor. + */ + public abstract void accept(ProgramClass programClass, + MemberVisitor memberVisitor); + + + + /** + * Lets the given attribute info visitor visit all the attributes of + * this member info. + */ + public abstract void attributesAccept(ProgramClass programClass, + AttributeVisitor attributeVisitor); + + + // Implementations for Member. + + public int getAccessFlags() + { + return u2accessFlags; + } + + public String getName(Clazz clazz) + { + return clazz.getString(u2nameIndex); + } + + public String getDescriptor(Clazz clazz) + { + return clazz.getString(u2descriptorIndex); + } + + public void accept(Clazz clazz, MemberVisitor memberVisitor) + { + accept((ProgramClass)clazz, memberVisitor); + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/ProgramMethod.java b/src/proguard/classfile/ProgramMethod.java new file mode 100644 index 0000000..943c3d6 --- /dev/null +++ b/src/proguard/classfile/ProgramMethod.java @@ -0,0 +1,99 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.visitor.*; + +/** + * Representation of a method from a program class. + * + * @author Eric Lafortune + */ +public class ProgramMethod extends ProgramMember implements Method +{ + /** + * An extra field pointing to the Clazz objects referenced in the + * descriptor string. This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + + /** + * Creates an uninitialized ProgramMethod. + */ + public ProgramMethod() + { + } + + + /** + * Creates an initialized ProgramMethod. + */ + public ProgramMethod(int u2accessFlags, + int u2nameIndex, + int u2descriptorIndex, + int u2attributesCount, + Attribute[] attributes, + Clazz[] referencedClasses) + { + super(u2accessFlags, u2nameIndex, u2descriptorIndex, u2attributesCount, attributes); + + this.referencedClasses = referencedClasses; + } + + + // Implementations for ProgramMember. + + public void accept(ProgramClass programClass, MemberVisitor memberVisitor) + { + memberVisitor.visitProgramMethod(programClass, this); + } + + + public void attributesAccept(ProgramClass programClass, AttributeVisitor attributeVisitor) + { + for (int index = 0; index < u2attributesCount; index++) + { + attributes[index].accept(programClass, this, attributeVisitor); + } + } + + + // Implementations for Member. + + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + if (referencedClasses[index] != null) + { + referencedClasses[index].accept(classVisitor); + } + } + } + } +} diff --git a/src/proguard/classfile/VisitorAccepter.java b/src/proguard/classfile/VisitorAccepter.java new file mode 100644 index 0000000..e38f888 --- /dev/null +++ b/src/proguard/classfile/VisitorAccepter.java @@ -0,0 +1,47 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile; + + + + +/** + * This interface is a base interface for visitor accepters. It allows + * visitors to set and get any temporary information they desire on the + * objects they are visiting. Note that every visitor accepter has only one + * such property, so visitors will have to take care not to overwrite each + * other's information, if it is still required. + * + * @author Eric Lafortune + */ +public interface VisitorAccepter +{ + /** + * Gets the visitor information of the visitor accepter. + */ + public Object getVisitorInfo(); + + + /** + * Sets the visitor information of the visitor accepter. + */ + public void setVisitorInfo(Object visitorInfo); +} diff --git a/src/proguard/classfile/attribute/Attribute.java b/src/proguard/classfile/attribute/Attribute.java new file mode 100644 index 0000000..2e16e22 --- /dev/null +++ b/src/proguard/classfile/attribute/Attribute.java @@ -0,0 +1,142 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This abstract class represents an attribute that is attached to a class, + * a class member, or a code attribute. Specific types of attributes are + * subclassed from it. + * + * @author Eric Lafortune + * @noinspection AbstractClassWithoutAbstractMethods + */ +public abstract class Attribute implements VisitorAccepter +{ + public int u2attributeNameIndex; + //public int u4attributeLength; + //public byte info[]; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Create an uninitialized Attribute. + */ + protected Attribute() + { + } + + + /** + * Create an initialized Attribute. + */ + protected Attribute(int u2attributeNameIndex) + { + this.u2attributeNameIndex = u2attributeNameIndex; + } + + + /** + * Returns the String name of the attribute. + */ + public String getAttributeName(Clazz clazz) + { + return clazz.getString(u2attributeNameIndex); + } + + + // Methods to be implemented by extensions, if applicable. + + /** + * Accepts the given visitor. + */ + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + /** + * Accepts the given visitor in the context of the given field. + */ + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + // Delegate the default invocation if the field is null anyway. + if (field == null) + { + accept(clazz, attributeVisitor); + } + else + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + } + + /** + * Accepts the given visitor in the context of the given method. + */ + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + // Delegate the default invocation if the method is null anyway. + if (method == null) + { + accept(clazz, (Field)null, attributeVisitor); + } + else + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + } + + /** + * Accepts the given visitor in the context of the given code attribute. + */ + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + // Delegate the default invocation if the code attribute is null anyway. + if (codeAttribute == null) + { + accept(clazz, method, attributeVisitor); + } + else + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/attribute/CodeAttribute.java b/src/proguard/classfile/attribute/CodeAttribute.java new file mode 100644 index 0000000..92ff9ea --- /dev/null +++ b/src/proguard/classfile/attribute/CodeAttribute.java @@ -0,0 +1,202 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This Attribute represents a code attribute. + * + * @author Eric Lafortune + */ +public class CodeAttribute extends Attribute +{ + public int u2maxStack; + public int u2maxLocals; + public int u4codeLength; + public byte[] code; + public int u2exceptionTableLength; + public ExceptionInfo[] exceptionTable; + public int u2attributesCount; + public Attribute[] attributes; + + + /** + * Creates an uninitialized CodeAttribute. + */ + public CodeAttribute() + { + } + + + /** + * Creates an initialized CodeAttribute. + */ + public CodeAttribute(int u2attributeNameIndex, + int u2maxStack, + int u2maxLocals, + int u4codeLength, + byte[] code, + int u2exceptionTableLength, + ExceptionInfo[] exceptionTable, + int u2attributesCount, + Attribute[] attributes) + { + super(u2attributeNameIndex); + + this.u2maxStack = u2maxStack; + this.u2maxLocals = u2maxLocals; + this.u4codeLength = u4codeLength; + this.code = code; + this.u2exceptionTableLength = u2exceptionTableLength; + this.exceptionTable = exceptionTable; + this.u2attributesCount = u2attributesCount; + this.attributes = attributes; + } + + + /** + * Returns the (first) attribute with the given name. + */ + public Attribute getAttribute(Clazz clazz, String name) + { + for (int index = 0; index < u2attributesCount; index++) + { + Attribute attribute = attributes[index]; + if (attribute.getAttributeName(clazz).equals(name)) + { + return attribute; + } + } + + return null; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitCodeAttribute(clazz, method, this); + } + + + /** + * Applies the given instruction visitor to all instructions. + */ + public void instructionsAccept(Clazz clazz, Method method, InstructionVisitor instructionVisitor) + { + instructionsAccept(clazz, method, 0, u4codeLength, instructionVisitor); + } + + + /** + * Applies the given instruction visitor to the instruction at the specified + * offset. + */ + public void instructionAccept(Clazz clazz, Method method, int offset, InstructionVisitor instructionVisitor) + { + Instruction instruction = InstructionFactory.create(code, offset); + instruction.accept(clazz, method, this, offset, instructionVisitor); + } + + + /** + * Applies the given instruction visitor to all instructions in the + * specified range of offsets. + */ + public void instructionsAccept(Clazz clazz, Method method, int startOffset, int endOffset, InstructionVisitor instructionVisitor) + { + int offset = startOffset; + + while (offset < endOffset) + { + // Note that the instruction is only volatile. + Instruction instruction = InstructionFactory.create(code, offset); + int instructionLength = instruction.length(offset); + instruction.accept(clazz, method, this, offset, instructionVisitor); + offset += instructionLength; + } + } + + + /** + * Applies the given exception visitor to all exceptions. + */ + public void exceptionsAccept(Clazz clazz, Method method, ExceptionInfoVisitor exceptionInfoVisitor) + { + for (int index = 0; index < u2exceptionTableLength; index++) + { + // We don't need double dispatching here, since there is only one + // type of ExceptionInfo. + exceptionInfoVisitor.visitExceptionInfo(clazz, method, this, exceptionTable[index]); + } + } + + + /** + * Applies the given exception visitor to all exceptions that are applicable + * to the instruction at the specified offset. + */ + public void exceptionsAccept(Clazz clazz, Method method, int offset, ExceptionInfoVisitor exceptionInfoVisitor) + { + for (int index = 0; index < u2exceptionTableLength; index++) + { + ExceptionInfo exceptionInfo = exceptionTable[index]; + if (exceptionInfo.isApplicable(offset)) + { + exceptionInfoVisitor.visitExceptionInfo(clazz, method, this, exceptionInfo); + } + } + } + + + /** + * Applies the given exception visitor to all exceptions that are applicable + * to any of the instructions in the specified range of offsets. + */ + public void exceptionsAccept(Clazz clazz, Method method, int startOffset, int endOffset, ExceptionInfoVisitor exceptionInfoVisitor) + { + for (int index = 0; index < u2exceptionTableLength; index++) + { + ExceptionInfo exceptionInfo = exceptionTable[index]; + if (exceptionInfo.isApplicable(startOffset, endOffset)) + { + exceptionInfoVisitor.visitExceptionInfo(clazz, method, this, exceptionInfo); + } + } + } + + + /** + * Applies the given attribute visitor to all attributes. + */ + public void attributesAccept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + for (int index = 0; index < u2attributesCount; index++) + { + attributes[index].accept(clazz, method, this, attributeVisitor); + } + } +} diff --git a/src/proguard/classfile/attribute/ConstantValueAttribute.java b/src/proguard/classfile/attribute/ConstantValueAttribute.java new file mode 100644 index 0000000..3ae991e --- /dev/null +++ b/src/proguard/classfile/attribute/ConstantValueAttribute.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a constant value attribute. + * + * @author Eric Lafortune + */ +public class ConstantValueAttribute extends Attribute +{ + public int u2constantValueIndex; + + + /** + * Creates an uninitialized ConstantValueAttribute. + */ + public ConstantValueAttribute() + { + } + + + /** + * Creates an initialized ConstantValueAttribute. + */ + public ConstantValueAttribute(int u2attributeNameIndex, + int u2constantValueIndex) + { + super(u2attributeNameIndex); + + this.u2constantValueIndex = u2constantValueIndex; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitConstantValueAttribute(clazz, field, this); + } +} diff --git a/src/proguard/classfile/attribute/DeprecatedAttribute.java b/src/proguard/classfile/attribute/DeprecatedAttribute.java new file mode 100644 index 0000000..4180950 --- /dev/null +++ b/src/proguard/classfile/attribute/DeprecatedAttribute.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a deprecated attribute. + * + * @author Eric Lafortune + */ +public class DeprecatedAttribute extends Attribute +{ + /** + * Creates an uninitialized DeprecatedAttribute. + */ + public DeprecatedAttribute() + { + } + + + /** + * Creates an initialized DeprecatedAttribute. + */ + public DeprecatedAttribute(int u2attributeNameIndex) + { + super(u2attributeNameIndex); + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitDeprecatedAttribute(clazz, this); + } + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitDeprecatedAttribute(clazz, field, this); + } + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitDeprecatedAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/EnclosingMethodAttribute.java b/src/proguard/classfile/attribute/EnclosingMethodAttribute.java new file mode 100644 index 0000000..9275b3a --- /dev/null +++ b/src/proguard/classfile/attribute/EnclosingMethodAttribute.java @@ -0,0 +1,132 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.visitor.*; + +/** + * This Attribute represents an enclosing method attribute. + * + * @author Eric Lafortune + */ +public class EnclosingMethodAttribute extends Attribute +{ + public int u2classIndex; + public int u2nameAndTypeIndex; + + /** + * An extra field pointing to the referenced Clazz object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + */ + public Clazz referencedClass; + + /** + * An extra field optionally pointing to the referenced Method object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + */ + public Method referencedMethod; + + + /** + * Creates an uninitialized EnclosingMethodAttribute. + */ + public EnclosingMethodAttribute() + { + } + + + /** + * Creates an initialized EnclosingMethodAttribute. + */ + public EnclosingMethodAttribute(int u2attributeNameIndex, + int u2classIndex, + int u2nameAndTypeIndex) + { + super(u2attributeNameIndex); + + this.u2classIndex = u2classIndex; + this.u2nameAndTypeIndex = u2nameAndTypeIndex; + } + + + /** + * Returns the class name. + */ + public String getClassName(Clazz clazz) + { + return clazz.getClassName(u2classIndex); + } + + /** + * Returns the method/field name. + */ + public String getName(Clazz clazz) + { + return clazz.getName(u2nameAndTypeIndex); + } + + /** + * Returns the type. + */ + public String getType(Clazz clazz) + { + return clazz.getType(u2nameAndTypeIndex); + } + + + /** + * Lets the referenced class accept the given visitor. + */ + public void referencedClassAccept(ClassVisitor classVisitor) + { + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + + + /** + * Lets the referenced class member accept the given visitor. + */ + public void referencedMethodAccept(MemberVisitor memberVisitor) + { + if (referencedMethod != null) + { + referencedMethod.accept(referencedClass, + memberVisitor); + } + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitEnclosingMethodAttribute(clazz, this); + } +} diff --git a/src/proguard/classfile/attribute/ExceptionInfo.java b/src/proguard/classfile/attribute/ExceptionInfo.java new file mode 100644 index 0000000..082efab --- /dev/null +++ b/src/proguard/classfile/attribute/ExceptionInfo.java @@ -0,0 +1,100 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.VisitorAccepter; + +/** + * Representation of an Exception table entry. + * + * @author Eric Lafortune + */ +public class ExceptionInfo implements VisitorAccepter +{ + public int u2startPC; + public int u2endPC; + public int u2handlerPC; + public int u2catchType; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an uninitialized ExceptionInfo. + */ + public ExceptionInfo() + { + this(0, 0, 0, 0); + } + + + /** + * Creates an ExceptionInfo with the given properties. + */ + public ExceptionInfo(int u2startPC, + int u2endPC, + int u2handlerPC, + int u2catchType) + { + this.u2startPC = u2startPC; + this.u2endPC = u2endPC; + this.u2handlerPC = u2handlerPC; + this.u2catchType = u2catchType; + } + + + /** + * Returns whether the exception's try block contains the instruction at the + * given offset. + */ + public boolean isApplicable(int instructionOffset) + { + return instructionOffset >= u2startPC && + instructionOffset < u2endPC; + } + + + /** + * Returns whether the exception's try block overlaps with the specified + * block of instructions. + */ + public boolean isApplicable(int startOffset, int endOffset) + { + return u2startPC < endOffset && + u2endPC > startOffset; + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/attribute/ExceptionsAttribute.java b/src/proguard/classfile/attribute/ExceptionsAttribute.java new file mode 100644 index 0000000..d22c4a6 --- /dev/null +++ b/src/proguard/classfile/attribute/ExceptionsAttribute.java @@ -0,0 +1,80 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Attribute represents an exceptions attribute. + * + * @author Eric Lafortune + */ +public class ExceptionsAttribute extends Attribute +{ + public int u2exceptionIndexTableLength; + public int[] u2exceptionIndexTable; + + + /** + * Creates an uninitialized ExceptionsAttribute. + */ + public ExceptionsAttribute() + { + } + + + /** + * Creates an initialized ExceptionsAttribute. + */ + public ExceptionsAttribute(int u2attributeNameIndex, + int u2exceptionIndexTableLength, + int[] u2exceptionIndexTable) + { + super(u2attributeNameIndex); + + this.u2exceptionIndexTableLength = u2exceptionIndexTableLength; + this.u2exceptionIndexTable = u2exceptionIndexTable; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitExceptionsAttribute(clazz, method, this); + } + + + /** + * Applies the given constant pool visitor to all exception class pool info + * entries. + */ + public void exceptionEntriesAccept(ProgramClass programClass, ConstantVisitor constantVisitor) + { + for (int index = 0; index < u2exceptionIndexTableLength; index++) + { + programClass.constantPoolEntryAccept(u2exceptionIndexTable[index], + constantVisitor); + } + } +} diff --git a/src/proguard/classfile/attribute/InnerClassesAttribute.java b/src/proguard/classfile/attribute/InnerClassesAttribute.java new file mode 100644 index 0000000..2f7e310 --- /dev/null +++ b/src/proguard/classfile/attribute/InnerClassesAttribute.java @@ -0,0 +1,80 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.visitor.*; + +/** + * This Attribute represents an inner classes attribute. + * + * @author Eric Lafortune + */ +public class InnerClassesAttribute extends Attribute +{ + public int u2classesCount; + public InnerClassesInfo[] classes; + + + /** + * Creates an uninitialized InnerClassesAttribute. + */ + public InnerClassesAttribute() + { + } + + + /** + * Creates an initialized InnerClassesAttribute. + */ + public InnerClassesAttribute(int u2attributeNameIndex, + int u2classesCount, + InnerClassesInfo[] classes) + { + super(u2attributeNameIndex); + + this.u2classesCount = u2classesCount; + this.classes = classes; + } + + // + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitInnerClassesAttribute(clazz, this); + } + + + /** + * Applies the given visitor to all inner classes. + */ + public void innerClassEntriesAccept(Clazz clazz, InnerClassesInfoVisitor innerClassesInfoVisitor) + { + for (int index = 0; index < u2classesCount; index++) + { + // We don't need double dispatching here, since there is only one + // type of InnerClassesInfo. + innerClassesInfoVisitor.visitInnerClassesInfo(clazz, classes[index]); + } + } +} diff --git a/src/proguard/classfile/attribute/InnerClassesInfo.java b/src/proguard/classfile/attribute/InnerClassesInfo.java new file mode 100644 index 0000000..1bdd6c3 --- /dev/null +++ b/src/proguard/classfile/attribute/InnerClassesInfo.java @@ -0,0 +1,122 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * Representation of an Inner Classes table entry. + * + * @author Eric Lafortune + */ +public class InnerClassesInfo implements VisitorAccepter +{ + public int u2innerClassIndex; + public int u2outerClassIndex; + public int u2innerNameIndex; + public int u2innerClassAccessFlags; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Returns the inner class index. + */ + protected int getInnerClassIndex() + { + return u2innerClassIndex; + } + + /** + * Returns the name index. + */ + protected int getInnerNameIndex() + { + return u2innerNameIndex; + } + + /** + * Sets the name index. + */ + protected void setInnerNameIndex(int index) + { + u2innerNameIndex = index; + } + + + /** + * Applies the given constant pool visitor to the class constant of the + * inner class, if any. + */ + public void innerClassConstantAccept(Clazz clazz, ConstantVisitor constantVisitor) + { + if (u2innerClassIndex != 0) + { + clazz.constantPoolEntryAccept(u2innerClassIndex, + constantVisitor); + } + } + + + /** + * Applies the given constant pool visitor to the class constant of the + * outer class, if any. + */ + public void outerClassConstantAccept(Clazz clazz, ConstantVisitor constantVisitor) + { + if (u2outerClassIndex != 0) + { + clazz.constantPoolEntryAccept(u2outerClassIndex, + constantVisitor); + } + } + + + /** + * Applies the given constant pool visitor to the Utf8 constant of the + * inner name, if any. + */ + public void innerNameConstantAccept(Clazz clazz, ConstantVisitor constantVisitor) + { + if (u2innerNameIndex != 0) + { + clazz.constantPoolEntryAccept(u2innerNameIndex, + constantVisitor); + } + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/attribute/LineNumberInfo.java b/src/proguard/classfile/attribute/LineNumberInfo.java new file mode 100644 index 0000000..f58083a --- /dev/null +++ b/src/proguard/classfile/attribute/LineNumberInfo.java @@ -0,0 +1,50 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +/** + * Representation of an Line Number table entry. + * + * @author Eric Lafortune + */ +public class LineNumberInfo +{ + public int u2startPC; + public int u2lineNumber; + + + /** + * Creates an uninitialized LineNumberInfo. + */ + public LineNumberInfo() + { + } + + + /** + * Creates an initialized LineNumberInfo. + */ + public LineNumberInfo(int u2startPC, int u2lineNumber) + { + this.u2startPC = u2startPC; + this.u2lineNumber = u2lineNumber; + } +} diff --git a/src/proguard/classfile/attribute/LineNumberTableAttribute.java b/src/proguard/classfile/attribute/LineNumberTableAttribute.java new file mode 100644 index 0000000..4d507d9 --- /dev/null +++ b/src/proguard/classfile/attribute/LineNumberTableAttribute.java @@ -0,0 +1,100 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.*; + +/** + * This Attribute represents a line number table attribute. + * + * @author Eric Lafortune + */ +public class LineNumberTableAttribute extends Attribute +{ + public int u2lineNumberTableLength; + public LineNumberInfo[] lineNumberTable; + + + /** + * Creates an uninitialized LineNumberTableAttribute. + */ + public LineNumberTableAttribute() + { + } + + + /** + * Creates an initialized LineNumberTableAttribute. + */ + public LineNumberTableAttribute(int u2attributeNameIndex, + int u2lineNumberTableLength, + LineNumberInfo[] lineNumberTable) + { + super(u2attributeNameIndex); + + this.u2lineNumberTableLength = u2lineNumberTableLength; + this.lineNumberTable = lineNumberTable; + } + + + /** + * Returns the line number corresponding to the given byte code program + * counter. + */ + public int getLineNumber(int pc) + { + for (int index = u2lineNumberTableLength-1 ; index >= 0 ; index--) + { + LineNumberInfo info = lineNumberTable[index]; + if (pc >= info.u2startPC) + { + return info.u2lineNumber; + } + } + + return u2lineNumberTableLength > 0 ? + lineNumberTable[0].u2lineNumber : + 0; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitLineNumberTableAttribute(clazz, method, codeAttribute, this); + } + + + /** + * Applies the given visitor to all line numbers. + */ + public void lineNumbersAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfoVisitor lineNumberInfoVisitor) + { + for (int index = 0; index < u2lineNumberTableLength; index++) + { + // We don't need double dispatching here, since there is only one + // type of LineNumberInfo. + lineNumberInfoVisitor.visitLineNumberInfo(clazz, method, codeAttribute, lineNumberTable[index]); + } + } +} diff --git a/src/proguard/classfile/attribute/LocalVariableInfo.java b/src/proguard/classfile/attribute/LocalVariableInfo.java new file mode 100644 index 0000000..4e54c22 --- /dev/null +++ b/src/proguard/classfile/attribute/LocalVariableInfo.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.Clazz; +import proguard.classfile.visitor.ClassVisitor; + +/** + * Representation of an Local Variable table entry. + * + * @author Eric Lafortune + */ +public class LocalVariableInfo +{ + public int u2startPC; + public int u2length; + public int u2nameIndex; + public int u2descriptorIndex; + public int u2index; + + /** + * An extra field pointing to the referenced Clazz object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + */ + public Clazz referencedClass; + + + /** + * Creates an uninitialized LocalVariableInfo. + */ + public LocalVariableInfo() + { + } + + + /** + * Creates an initialized LocalVariableInfo. + */ + public LocalVariableInfo(int u2startPC, + int u2length, + int u2nameIndex, + int u2descriptorIndex, + int u2index) + { + this.u2startPC = u2startPC; + this.u2length = u2length; + this.u2nameIndex = u2nameIndex; + this.u2descriptorIndex = u2descriptorIndex; + this.u2index = u2index; + } + + + /** + * Lets the referenced class accept the given visitor. + */ + public void referencedClassAccept(ClassVisitor classVisitor) + { + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } +} diff --git a/src/proguard/classfile/attribute/LocalVariableTableAttribute.java b/src/proguard/classfile/attribute/LocalVariableTableAttribute.java new file mode 100644 index 0000000..9c3f115 --- /dev/null +++ b/src/proguard/classfile/attribute/LocalVariableTableAttribute.java @@ -0,0 +1,79 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.*; + +/** + * This Attribute represents a local variable table attribute. + * + * @author Eric Lafortune + */ +public class LocalVariableTableAttribute extends Attribute +{ + public int u2localVariableTableLength; + public LocalVariableInfo[] localVariableTable; + + + /** + * Creates an uninitialized LocalVariableTableAttribute. + */ + public LocalVariableTableAttribute() + { + } + + + /** + * Creates an initialized LocalVariableTableAttribute. + */ + public LocalVariableTableAttribute(int u2attributeNameIndex, + int u2localVariableTableLength, + LocalVariableInfo[] localVariableTable) + { + super(u2attributeNameIndex); + + this.u2localVariableTableLength = u2localVariableTableLength; + this.localVariableTable = localVariableTable; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitLocalVariableTableAttribute(clazz, method, codeAttribute, this); + } + + + /** + * Applies the given visitor to all local variables. + */ + public void localVariablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfoVisitor localVariableInfoVisitor) + { + for (int index = 0; index < u2localVariableTableLength; index++) + { + // We don't need double dispatching here, since there is only one + // type of LocalVariableInfo. + localVariableInfoVisitor.visitLocalVariableInfo(clazz, method, codeAttribute, localVariableTable[index]); + } + } +} diff --git a/src/proguard/classfile/attribute/LocalVariableTypeInfo.java b/src/proguard/classfile/attribute/LocalVariableTypeInfo.java new file mode 100644 index 0000000..1b71f35 --- /dev/null +++ b/src/proguard/classfile/attribute/LocalVariableTypeInfo.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.Clazz; +import proguard.classfile.visitor.ClassVisitor; + +/** + * Representation of an Local Variable table entry. + * + * @author Eric Lafortune + */ +public class LocalVariableTypeInfo +{ + public int u2startPC; + public int u2length; + public int u2nameIndex; + public int u2signatureIndex; + public int u2index; + + /** + * An extra field pointing to the Clazz objects referenced in the + * type string. This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + + /** + * Creates an uninitialized LocalVariableTypeInfo. + */ + public LocalVariableTypeInfo() + { + } + + + /** + * Creates an initialized LocalVariableTypeInfo. + */ + public LocalVariableTypeInfo(int u2startPC, + int u2length, + int u2nameIndex, + int u2signatureIndex, + int u2index) + { + this.u2startPC = u2startPC; + this.u2length = u2length; + this.u2nameIndex = u2nameIndex; + this.u2signatureIndex = u2signatureIndex; + this.u2index = u2index; + } + + + /** + * Applies the given visitor to all referenced classes. + */ + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + Clazz referencedClass = referencedClasses[index]; + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + } + } +} diff --git a/src/proguard/classfile/attribute/LocalVariableTypeTableAttribute.java b/src/proguard/classfile/attribute/LocalVariableTypeTableAttribute.java new file mode 100644 index 0000000..fd856fe --- /dev/null +++ b/src/proguard/classfile/attribute/LocalVariableTypeTableAttribute.java @@ -0,0 +1,79 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.*; + +/** + * This Attribute represents a local variable table type attribute. + * + * @author Eric Lafortune + */ +public class LocalVariableTypeTableAttribute extends Attribute +{ + public int u2localVariableTypeTableLength; + public LocalVariableTypeInfo[] localVariableTypeTable; + + + /** + * Creates an uninitialized LocalVariableTypeTableAttribute. + */ + public LocalVariableTypeTableAttribute() + { + } + + + /** + * Creates an initialized LocalVariableTypeTableAttribute. + */ + public LocalVariableTypeTableAttribute(int u2attributeNameIndex, + int u2localVariableTypeTableLength, + LocalVariableTypeInfo[] localVariableTypeTable) + { + super(u2attributeNameIndex); + + this.u2localVariableTypeTableLength = u2localVariableTypeTableLength; + this.localVariableTypeTable = localVariableTypeTable; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitLocalVariableTypeTableAttribute(clazz, method, codeAttribute, this); + } + + + /** + * Applies the given visitor to all local variable types. + */ + public void localVariablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfoVisitor localVariableTypeInfoVisitor) + { + for (int index = 0; index < u2localVariableTypeTableLength; index++) + { + // We don't need double dispatching here, since there is only one + // type of LocalVariableTypeInfo. + localVariableTypeInfoVisitor.visitLocalVariableTypeInfo(clazz, method, codeAttribute, localVariableTypeTable[index]); + } + } +} diff --git a/src/proguard/classfile/attribute/SignatureAttribute.java b/src/proguard/classfile/attribute/SignatureAttribute.java new file mode 100644 index 0000000..c7585fe --- /dev/null +++ b/src/proguard/classfile/attribute/SignatureAttribute.java @@ -0,0 +1,100 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This Attribute represents a signature attribute. + * + * @author Eric Lafortune + */ +public class SignatureAttribute extends Attribute +{ + public int u2signatureIndex; + + /** + * An extra field pointing to the Clazz objects referenced in the + * signature string. This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + + /** + * Creates an uninitialized SignatureAttribute. + */ + public SignatureAttribute() + { + } + + + /** + * Creates an initialized SignatureAttribute. + */ + public SignatureAttribute(int u2attributeNameIndex, + int u2signatureIndex) + { + super(u2attributeNameIndex); + + this.u2signatureIndex = u2signatureIndex; + } + + + /** + * Lets the Clazz objects referenced in the signature string accept the + * given visitor. + */ + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + if (referencedClasses[index] != null) + { + referencedClasses[index].accept(classVisitor); + } + } + } + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSignatureAttribute(clazz, this); + } + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSignatureAttribute(clazz, field, this); + } + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSignatureAttribute(clazz, method, this); + } + } diff --git a/src/proguard/classfile/attribute/SourceDirAttribute.java b/src/proguard/classfile/attribute/SourceDirAttribute.java new file mode 100644 index 0000000..a26e8b1 --- /dev/null +++ b/src/proguard/classfile/attribute/SourceDirAttribute.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a source directory attribute. + * + * @author Eric Lafortune + */ +public class SourceDirAttribute extends Attribute +{ + public int u2sourceDirIndex; + + + /** + * Creates an uninitialized SourceDirAttribute. + */ + public SourceDirAttribute() + { + } + + + /** + * Creates an initialized SourceDirAttribute. + */ + public SourceDirAttribute(int u2attributeNameIndex, + int u2sourceDirIndex) + { + super(u2attributeNameIndex); + + this.u2sourceDirIndex = u2sourceDirIndex; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSourceDirAttribute(clazz, this); + } +} diff --git a/src/proguard/classfile/attribute/SourceFileAttribute.java b/src/proguard/classfile/attribute/SourceFileAttribute.java new file mode 100644 index 0000000..24269b7 --- /dev/null +++ b/src/proguard/classfile/attribute/SourceFileAttribute.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a source file attribute. + * + * @author Eric Lafortune + */ +public class SourceFileAttribute extends Attribute +{ + public int u2sourceFileIndex; + + + /** + * Creates an uninitialized SourceFileAttribute. + */ + public SourceFileAttribute() + { + } + + + /** + * Creates an initialized SourceFileAttribute. + */ + public SourceFileAttribute(int u2attributeNameIndex, + int u2sourceFileIndex) + { + super(u2attributeNameIndex); + + this.u2sourceFileIndex = u2sourceFileIndex; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSourceFileAttribute(clazz, this); + } +} diff --git a/src/proguard/classfile/attribute/SyntheticAttribute.java b/src/proguard/classfile/attribute/SyntheticAttribute.java new file mode 100644 index 0000000..6ccb1b5 --- /dev/null +++ b/src/proguard/classfile/attribute/SyntheticAttribute.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a synthetic attribute. + * + * @author Eric Lafortune + */ +public class SyntheticAttribute extends Attribute +{ + /** + * Creates an uninitialized SyntheticAttribute. + */ + public SyntheticAttribute() + { + } + + + /** + * Creates an initialized SyntheticAttribute. + */ + public SyntheticAttribute(int u2attributeNameIndex) + { + super(u2attributeNameIndex); + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSyntheticAttribute(clazz, this); + } + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSyntheticAttribute(clazz, field, this); + } + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitSyntheticAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/UnknownAttribute.java b/src/proguard/classfile/attribute/UnknownAttribute.java new file mode 100644 index 0000000..2f138bd --- /dev/null +++ b/src/proguard/classfile/attribute/UnknownAttribute.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute; + + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents an unknown attribute. + * + * @author Eric Lafortune + */ +public class UnknownAttribute extends Attribute +{ + public final int u4attributeLength; + public byte[] info; + + + /** + * Creates an uninitialized UnknownAttribute with the given length. + */ + public UnknownAttribute(int attributeLength) + { + u4attributeLength = attributeLength; + } + + + /** + * Creates an initialized UnknownAttribute. + */ + public UnknownAttribute(int u2attributeNameIndex, + int u4attributeLength, + byte[] info) + { + super(u2attributeNameIndex); + + this.u4attributeLength = u4attributeLength; + this.info = info; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitUnknownAttribute(clazz, this); + } + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitUnknownAttribute(clazz, this); + } + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitUnknownAttribute(clazz, this); + } + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitUnknownAttribute(clazz, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/Annotation.java b/src/proguard/classfile/attribute/annotation/Annotation.java new file mode 100644 index 0000000..41bb8e3 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/Annotation.java @@ -0,0 +1,143 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * Representation of an annotation. + * + * @author Eric Lafortune + */ +public class Annotation implements VisitorAccepter +{ + public int u2typeIndex; + public int u2elementValuesCount; + public ElementValue[] elementValues; + + /** + * An extra field pointing to the Clazz objects referenced in the + * type string. This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an uninitialized Annotation. + */ + public Annotation() + { + } + + + /** + * Creates an initialized Annotation. + */ + public Annotation(int u2typeIndex, + int u2elementValuesCount, + ElementValue[] elementValues) + { + this.u2typeIndex = u2typeIndex; + this.u2elementValuesCount = u2elementValuesCount; + this.elementValues = elementValues; + } + + + /** + * Returns the type. + */ + public String getType(Clazz clazz) + { + return clazz.getString(u2typeIndex); + } + + + + /** + * Applies the given visitor to the first referenced class. This is the + * main annotation class. + */ + public void referencedClassAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + Clazz referencedClass = referencedClasses[0]; + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + } + + + /** + * Applies the given visitor to all referenced classes. + */ + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + Clazz referencedClass = referencedClasses[index]; + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + } + } + + + /** + * Applies the given visitor to all element value pairs. + */ + public void elementValuesAccept(Clazz clazz, ElementValueVisitor elementValueVisitor) + { + for (int index = 0; index < u2elementValuesCount; index++) + { + elementValues[index].accept(clazz, this, elementValueVisitor); + } + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/attribute/annotation/AnnotationDefaultAttribute.java b/src/proguard/classfile/attribute/annotation/AnnotationDefaultAttribute.java new file mode 100644 index 0000000..b378cd2 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/AnnotationDefaultAttribute.java @@ -0,0 +1,73 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents an annotation default attribute. + * + * @author Eric Lafortune + */ +public class AnnotationDefaultAttribute extends Attribute +{ + public ElementValue defaultValue; + + + /** + * Creates an uninitialized AnnotationDefaultAttribute. + */ + public AnnotationDefaultAttribute() + { + } + + + /** + * Creates an initialized AnnotationDefaultAttribute. + */ + public AnnotationDefaultAttribute(int u2attributeNameIndex, + ElementValue defaultValue) + { + super(u2attributeNameIndex); + + this.defaultValue = defaultValue; + } + + + /** + * Applies the given visitor to the default element value. + */ + public void defaultValueAccept(Clazz clazz, ElementValueVisitor elementValueVisitor) + { + defaultValue.accept(clazz, null, elementValueVisitor); + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitAnnotationDefaultAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/AnnotationElementValue.java b/src/proguard/classfile/attribute/annotation/AnnotationElementValue.java new file mode 100644 index 0000000..29129d0 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/AnnotationElementValue.java @@ -0,0 +1,76 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.visitor.*; + +/** + * This ElementValue represents an annotation element value. + * + * @author Eric Lafortune + */ +public class AnnotationElementValue extends ElementValue +{ + public Annotation annotationValue; + + + /** + * Creates an uninitialized AnnotationElementValue. + */ + public AnnotationElementValue() + { + } + + + /** + * Creates an initialized AnnotationElementValue. + */ + public AnnotationElementValue(int u2elementNameIndex, + Annotation annotationValue) + { + super(u2elementNameIndex); + + this.annotationValue = annotationValue; + } + + + /** + * Applies the given visitor to the annotation. + */ + public void annotationAccept(Clazz clazz, AnnotationVisitor annotationVisitor) + { + annotationVisitor.visitAnnotation(clazz, annotationValue); + } + + + // Implementations for ElementValue. + + public int getTag() + { + return ClassConstants.ELEMENT_VALUE_ANNOTATION; + } + + public void accept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor) + { + elementValueVisitor.visitAnnotationElementValue(clazz, annotation, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/AnnotationsAttribute.java b/src/proguard/classfile/attribute/annotation/AnnotationsAttribute.java new file mode 100644 index 0000000..8117077 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/AnnotationsAttribute.java @@ -0,0 +1,100 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.annotation.visitor.AnnotationVisitor; + +/** + * This Attribute represents an annotations attribute. + * + * @author Eric Lafortune + */ +public abstract class AnnotationsAttribute extends Attribute +{ + public int u2annotationsCount; + public Annotation[] annotations; + + + /** + * Creates an uninitialized AnnotationsAttribute. + */ + protected AnnotationsAttribute() + { + } + + + /** + * Creates an initialized AnnotationsAttribute. + */ + protected AnnotationsAttribute(int u2attributeNameIndex, + int u2annotationsCount, + Annotation[] annotations) + { + super(u2attributeNameIndex); + + this.u2annotationsCount = u2annotationsCount; + this.annotations = annotations; + } + + + /** + * Applies the given visitor to all class annotations. + */ + public void annotationsAccept(Clazz clazz, AnnotationVisitor annotationVisitor) + { + for (int index = 0; index < u2annotationsCount; index++) + { + // We don't need double dispatching here, since there is only one + // type of Annotation. + annotationVisitor.visitAnnotation(clazz, annotations[index]); + } + } + + + /** + * Applies the given visitor to all field annotations. + */ + public void annotationsAccept(Clazz clazz, Field field, AnnotationVisitor annotationVisitor) + { + for (int index = 0; index < u2annotationsCount; index++) + { + // We don't need double dispatching here, since there is only one + // type of Annotation. + annotationVisitor.visitAnnotation(clazz, field, annotations[index]); + } + } + + + /** + * Applies the given visitor to all method annotations. + */ + public void annotationsAccept(Clazz clazz, Method method, AnnotationVisitor annotationVisitor) + { + for (int index = 0; index < u2annotationsCount; index++) + { + // We don't need double dispatching here, since there is only one + // type of Annotation. + annotationVisitor.visitAnnotation(clazz, method, annotations[index]); + } + } +} diff --git a/src/proguard/classfile/attribute/annotation/ArrayElementValue.java b/src/proguard/classfile/attribute/annotation/ArrayElementValue.java new file mode 100644 index 0000000..25b8b9f --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/ArrayElementValue.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; + +/** + * This ElementValue represents an array element value. + * + * @author Eric Lafortune + */ +public class ArrayElementValue extends ElementValue +{ + public int u2elementValuesCount; + public ElementValue[] elementValues; + + + /** + * Creates an uninitialized ArrayElementValue. + */ + public ArrayElementValue() + { + } + + + /** + * Creates an initialized ArrayElementValue. + */ + public ArrayElementValue(int u2elementNameIndex, + int u2elementValuesCount, + ElementValue[] elementValues) + { + super(u2elementNameIndex); + + this.u2elementValuesCount = u2elementValuesCount; + this.elementValues = elementValues; + } + + + // Implementations for ElementValue. + + public int getTag() + { + return ClassConstants.ELEMENT_VALUE_ARRAY; + } + + public void accept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor) + { + elementValueVisitor.visitArrayElementValue(clazz, annotation, this); + } + + + /** + * Applies the given visitor to all nested element values. + */ + public void elementValuesAccept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor) + { + for (int index = 0; index < u2elementValuesCount; index++) + { + elementValues[index].accept(clazz, annotation, elementValueVisitor); + } + } +} diff --git a/src/proguard/classfile/attribute/annotation/ClassElementValue.java b/src/proguard/classfile/attribute/annotation/ClassElementValue.java new file mode 100644 index 0000000..ba51641 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/ClassElementValue.java @@ -0,0 +1,95 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ElementValue represents a class element value. + * + * @author Eric Lafortune + */ +public class ClassElementValue extends ElementValue +{ + public int u2classInfoIndex; + + /** + * An extra field pointing to the Clazz objects referenced in the + * type name string. This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + + /** + * Creates an uninitialized ClassElementValue. + */ + public ClassElementValue() + { + } + + + /** + * Creates an initialized ClassElementValue. + */ + public ClassElementValue(int u2elementNameIndex, + int u2classInfoIndex) + { + super(u2elementNameIndex); + + this.u2classInfoIndex = u2classInfoIndex; + } + + + /** + * Applies the given visitor to all referenced classes. + */ + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + Clazz referencedClass = referencedClasses[index]; + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + } + } + + + // Implementations for ElementValue. + + public int getTag() + { + return ClassConstants.ELEMENT_VALUE_CLASS; + } + + public void accept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor) + { + elementValueVisitor.visitClassElementValue(clazz, annotation, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/ConstantElementValue.java b/src/proguard/classfile/attribute/annotation/ConstantElementValue.java new file mode 100644 index 0000000..3ebe5e5 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/ConstantElementValue.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; + +/** + * This ElementValue represents a constant element value. + * + * @author Eric Lafortune + */ +public class ConstantElementValue extends ElementValue +{ + public final int u1tag; + public int u2constantValueIndex; + + + /** + * Creates an uninitialized ConstantElementValue. + */ + public ConstantElementValue(int u1tag) + { + this.u1tag = u1tag; + } + + + /** + * Creates an initialized ConstantElementValue. + */ + public ConstantElementValue(int u1tag, + int u2elementNameIndex, + int u2constantValueIndex) + { + super(u2elementNameIndex); + + this.u1tag = u1tag; + this.u2constantValueIndex = u2constantValueIndex; + } + + + // Implementations for ElementValue. + + public int getTag() + { + return u1tag; + } + + public void accept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor) + { + elementValueVisitor.visitConstantElementValue(clazz, annotation, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/ElementValue.java b/src/proguard/classfile/attribute/annotation/ElementValue.java new file mode 100644 index 0000000..39f8953 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/ElementValue.java @@ -0,0 +1,126 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This abstract class represents an element value that is attached to an + * annotation or an annotation default. Specific types of element values are + * subclassed from it. + * + * @author Eric Lafortune + */ +public abstract class ElementValue implements VisitorAccepter +{ + /** + * An extra field for the optional element name. It is used in element value + * pairs of annotations. Otherwise, it is 0. + */ + public int u2elementNameIndex; + + /** + * An extra field pointing to the referenced Clazz + * object, if applicable. This field is typically filled out by the + * {@link proguard.classfile.util.ClassReferenceInitializer}. + */ + public Clazz referencedClass; + + /** + * An extra field pointing to the referenced Method + * object, if applicable. This field is typically filled out by the + * {@link proguard.classfile.util.ClassReferenceInitializer}. + */ + public Method referencedMethod; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Creates an uninitialized ElementValue. + */ + protected ElementValue() + { + } + + + /** + * Creates an initialized ElementValue. + */ + protected ElementValue(int u2elementNameIndex) + { + this.u2elementNameIndex = u2elementNameIndex; + } + + + /** + * Returns the element name. + */ + public String getMethodName(Clazz clazz) + { + return clazz.getString(u2elementNameIndex); + } + + + // Abstract methods to be implemented by extensions. + + /** + * Returns the tag of this element value. + */ + public abstract int getTag(); + + + /** + * Accepts the given visitor. + */ + public abstract void accept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor); + + + + /** + * Applies the given visitor to the referenced method. + */ + public void referencedMethodAccept(MemberVisitor memberVisitor) + { + if (referencedMethod != null) + { + referencedMethod.accept(referencedClass, memberVisitor); + } + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/attribute/annotation/EnumConstantElementValue.java b/src/proguard/classfile/attribute/annotation/EnumConstantElementValue.java new file mode 100644 index 0000000..d46bb7f --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/EnumConstantElementValue.java @@ -0,0 +1,99 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ElementValue represents an enumeration constant element value. + * + * @author Eric Lafortune + */ +public class EnumConstantElementValue extends ElementValue +{ + public int u2typeNameIndex; + public int u2constantNameIndex; + + /** + * An extra field pointing to the Clazz objects referenced in the + * type name string. This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + * References to primitive types are ignored. + */ + public Clazz[] referencedClasses; + + + /** + * Creates an uninitialized EnumConstantElementValue. + */ + public EnumConstantElementValue() + { + } + + + /** + * Creates an initialized EnumConstantElementValue. + */ + public EnumConstantElementValue(int u2elementNameIndex, + int u2typeNameIndex, + int u2constantNameIndex) + { + super(u2elementNameIndex); + + this.u2typeNameIndex = u2typeNameIndex; + this.u2constantNameIndex = u2constantNameIndex; + } + + + /** + * Applies the given visitor to all referenced classes. + */ + public void referencedClassesAccept(ClassVisitor classVisitor) + { + if (referencedClasses != null) + { + for (int index = 0; index < referencedClasses.length; index++) + { + Clazz referencedClass = referencedClasses[index]; + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + } + } + + + // Implementations for ElementValue. + + public int getTag() + { + return ClassConstants.ELEMENT_VALUE_ENUM_CONSTANT; + } + + public void accept(Clazz clazz, Annotation annotation, ElementValueVisitor elementValueVisitor) + { + elementValueVisitor.visitEnumConstantElementValue(clazz, annotation, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/ParameterAnnotationsAttribute.java b/src/proguard/classfile/attribute/annotation/ParameterAnnotationsAttribute.java new file mode 100644 index 0000000..3c700c8 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/ParameterAnnotationsAttribute.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.annotation.visitor.AnnotationVisitor; + +/** + * This Attribute represents a runtime parameter annotations attribute. + * + * @author Eric Lafortune + */ +public abstract class ParameterAnnotationsAttribute extends Attribute +{ + public int u2parametersCount; + public int[] u2parameterAnnotationsCount; + public Annotation[][] parameterAnnotations; + + + /** + * Creates an uninitialized ParameterAnnotationsAttribute. + */ + protected ParameterAnnotationsAttribute() + { + } + + + /** + * Creates an initialized ParameterAnnotationsAttribute. + */ + protected ParameterAnnotationsAttribute(int u2attributeNameIndex, + int u2parametersCount, + int[] u2parameterAnnotationsCount, + Annotation[][] parameterAnnotations) + { + super(u2attributeNameIndex); + + this.u2parametersCount = u2parametersCount; + this.u2parameterAnnotationsCount = u2parameterAnnotationsCount; + this.parameterAnnotations = parameterAnnotations; + } + + + /** + * Applies the given visitor to all annotations. + */ + public void annotationsAccept(Clazz clazz, Method method, AnnotationVisitor annotationVisitor) + { + // Loop over all parameters. + for (int parameterIndex = 0; parameterIndex < u2parametersCount; parameterIndex++) + { + int annotationsCount = u2parameterAnnotationsCount[parameterIndex]; + Annotation[] annotations = parameterAnnotations[parameterIndex]; + + // Loop over all parameter annotations. + for (int index = 0; index < annotationsCount; index++) + { + // We don't need double dispatching here, since there is only one + // type of Annotation. + annotationVisitor.visitAnnotation(clazz, method, parameterIndex, annotations[index]); + } + } + } +} diff --git a/src/proguard/classfile/attribute/annotation/RuntimeInvisibleAnnotationsAttribute.java b/src/proguard/classfile/attribute/annotation/RuntimeInvisibleAnnotationsAttribute.java new file mode 100644 index 0000000..9c8180c --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/RuntimeInvisibleAnnotationsAttribute.java @@ -0,0 +1,70 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a runtime invisible annotations attribute. + * + * @author Eric Lafortune + */ +public class RuntimeInvisibleAnnotationsAttribute extends AnnotationsAttribute +{ + /** + * Creates an uninitialized RuntimeInvisibleAnnotationsAttribute. + */ + public RuntimeInvisibleAnnotationsAttribute() + { + } + + + /** + * Creates an initialized RuntimeInvisibleAnnotationsAttribute. + */ + public RuntimeInvisibleAnnotationsAttribute(int u2attributeNameIndex, + int u2annotationsCount, + Annotation[] annotations) + { + super(u2attributeNameIndex, u2annotationsCount, annotations); + } + + +// Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeInvisibleAnnotationsAttribute(clazz, this); + } + + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeInvisibleAnnotationsAttribute(clazz, field, this); + } + + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeInvisibleAnnotationsAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/RuntimeInvisibleParameterAnnotationsAttribute.java b/src/proguard/classfile/attribute/annotation/RuntimeInvisibleParameterAnnotationsAttribute.java new file mode 100644 index 0000000..7e41656 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/RuntimeInvisibleParameterAnnotationsAttribute.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a runtime invisible parameter annotations attribute. + * + * @author Eric Lafortune + */ +public class RuntimeInvisibleParameterAnnotationsAttribute extends ParameterAnnotationsAttribute +{ + /** + * Creates an uninitialized RuntimeInvisibleParameterAnnotationsAttribute. + */ + public RuntimeInvisibleParameterAnnotationsAttribute() + { + } + + + /** + * Creates an initialized RuntimeInvisibleParameterAnnotationsAttribute. + */ + public RuntimeInvisibleParameterAnnotationsAttribute(int u2attributeNameIndex, + int u2parametersCount, + int[] u2parameterAnnotationsCount, + Annotation[][] parameterAnnotations) + { + super(u2attributeNameIndex, + u2parametersCount, + u2parameterAnnotationsCount, + parameterAnnotations); + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeInvisibleParameterAnnotationsAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/RuntimeVisibleAnnotationsAttribute.java b/src/proguard/classfile/attribute/annotation/RuntimeVisibleAnnotationsAttribute.java new file mode 100644 index 0000000..380c52e --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/RuntimeVisibleAnnotationsAttribute.java @@ -0,0 +1,70 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a runtime visible annotations attribute. + * + * @author Eric Lafortune + */ +public class RuntimeVisibleAnnotationsAttribute extends AnnotationsAttribute +{ + /** + * Creates an uninitialized RuntimeVisibleAnnotationsAttribute. + */ + public RuntimeVisibleAnnotationsAttribute() + { + } + + + /** + * Creates an initialized RuntimeVisibleAnnotationsAttribute. + */ + public RuntimeVisibleAnnotationsAttribute(int u2attributeNameIndex, + int u2annotationsCount, + Annotation[] annotations) + { + super(u2attributeNameIndex, u2annotationsCount, annotations); + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeVisibleAnnotationsAttribute(clazz, this); + } + + + public void accept(Clazz clazz, Field field, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeVisibleAnnotationsAttribute(clazz, field, this); + } + + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeVisibleAnnotationsAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/RuntimeVisibleParameterAnnotationsAttribute.java b/src/proguard/classfile/attribute/annotation/RuntimeVisibleParameterAnnotationsAttribute.java new file mode 100644 index 0000000..626fbda --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/RuntimeVisibleParameterAnnotationsAttribute.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a runtime visible parameter annotations attribute. + * + * @author Eric Lafortune + */ +public class RuntimeVisibleParameterAnnotationsAttribute extends ParameterAnnotationsAttribute +{ + /** + * Creates an uninitialized RuntimeVisibleParameterAnnotationsAttribute. + */ + public RuntimeVisibleParameterAnnotationsAttribute() + { + } + + + /** + * Creates an initialized RuntimeVisibleParameterAnnotationsAttribute. + */ + public RuntimeVisibleParameterAnnotationsAttribute(int u2attributeNameIndex, + int u2parametersCount, + int[] u2parameterAnnotationsCount, + Annotation[][] parameterAnnotations) + { + super(u2attributeNameIndex, + u2parametersCount, + u2parameterAnnotationsCount, + parameterAnnotations); + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitRuntimeVisibleParameterAnnotationsAttribute(clazz, method, this); + } +} diff --git a/src/proguard/classfile/attribute/annotation/package.html b/src/proguard/classfile/attribute/annotation/package.html new file mode 100644 index 0000000..6aacff3 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/package.html @@ -0,0 +1,4 @@ + +This package contains classes to represent the annotation attributes inside +class files. + diff --git a/src/proguard/classfile/attribute/annotation/visitor/AllAnnotationVisitor.java b/src/proguard/classfile/attribute/annotation/visitor/AllAnnotationVisitor.java new file mode 100644 index 0000000..bce7170 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/AllAnnotationVisitor.java @@ -0,0 +1,100 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor lets a given AnnotationVisitor visit all Annotation + * objects of the attributes it visits. + * + * @author Eric Lafortune + */ +public class AllAnnotationVisitor +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final AnnotationVisitor annotationVisitor; + + + public AllAnnotationVisitor(AnnotationVisitor annotationVisitor) + { + this.annotationVisitor = annotationVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + // Visit the annotations. + runtimeVisibleAnnotationsAttribute.annotationsAccept(clazz, annotationVisitor); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + // Visit the annotations. + runtimeVisibleAnnotationsAttribute.annotationsAccept(clazz, field, annotationVisitor); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + // Visit the annotations. + runtimeVisibleAnnotationsAttribute.annotationsAccept(clazz, method, annotationVisitor); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + // Visit the annotations. + runtimeInvisibleAnnotationsAttribute.annotationsAccept(clazz, annotationVisitor); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + // Visit the annotations. + runtimeInvisibleAnnotationsAttribute.annotationsAccept(clazz, field, annotationVisitor); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + // Visit the annotations. + runtimeInvisibleAnnotationsAttribute.annotationsAccept(clazz, method, annotationVisitor); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Visit the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, annotationVisitor); + } +} diff --git a/src/proguard/classfile/attribute/annotation/visitor/AnnotatedClassVisitor.java b/src/proguard/classfile/attribute/annotation/visitor/AnnotatedClassVisitor.java new file mode 100644 index 0000000..7a1d7c6 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/AnnotatedClassVisitor.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.annotation.Annotation; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + + +/** + * This AnnotationVisitor delegates all visits to a given ClassVisitor. + * The latter visits the class of each visited annotation, although + * never twice in a row. + * + * @author Eric Lafortune + */ +public class AnnotatedClassVisitor +extends SimplifiedVisitor +implements AnnotationVisitor +{ + private final ClassVisitor classVisitor; + + private Clazz lastVisitedClass; + + + public AnnotatedClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + if (!clazz.equals(lastVisitedClass)) + { + clazz.accept(classVisitor); + + lastVisitedClass = clazz; + } + } +} diff --git a/src/proguard/classfile/attribute/annotation/visitor/AnnotationToMemberVisitor.java b/src/proguard/classfile/attribute/annotation/visitor/AnnotationToMemberVisitor.java new file mode 100644 index 0000000..c206c16 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/AnnotationToMemberVisitor.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.Annotation; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + + +/** + * This AnnotationVisitor delegates all visits to a given MemberVisitor. + * The latter visits the class member of each visited class member annotation + * or method parameter annotation, although never twice in a row. + * + * @author Eric Lafortune + */ +public class AnnotationToMemberVisitor +extends SimplifiedVisitor +implements AnnotationVisitor +{ + private final MemberVisitor memberVisitor; + + private Member lastVisitedMember; + + + public AnnotationToMemberVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Member member, Annotation annotation) + { + if (!member.equals(lastVisitedMember)) + { + member.accept(clazz, memberVisitor); + + lastVisitedMember = member; + } + } +} diff --git a/src/proguard/classfile/attribute/annotation/visitor/AnnotationTypeFilter.java b/src/proguard/classfile/attribute/annotation/visitor/AnnotationTypeFilter.java new file mode 100644 index 0000000..d869fd2 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/AnnotationTypeFilter.java @@ -0,0 +1,102 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.Annotation; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.util.*; + +/** + * This AnnotationVisitor delegates its visits to another given + * AnnotationVisitor, but only when the visited annotation has + * a type that matches a given regular expression. + * + * @author Eric Lafortune + */ +public class AnnotationTypeFilter +extends SimplifiedVisitor +implements AnnotationVisitor +{ + private final StringMatcher regularExpressionMatcher; + private final AnnotationVisitor annotationVisitor; + + + /** + * Creates a new ClassNameFilter. + * @param regularExpression the regular expression against which annotation + * type names will be matched. + * @param annotationVisitor the annotationVisitor to which + * visits will be delegated. + */ + public AnnotationTypeFilter(String regularExpression, + AnnotationVisitor annotationVisitor) + { + this.regularExpressionMatcher = new ListParser(new ClassNameParser()).parse(regularExpression); + this.annotationVisitor = annotationVisitor; + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + if (accepted(annotation.getType(clazz))) + { + annotationVisitor.visitAnnotation(clazz, annotation); + } + } + + + public void visitAnnotation(Clazz clazz, Field field, Annotation annotation) + { + if (accepted(annotation.getType(clazz))) + { + annotationVisitor.visitAnnotation(clazz, field, annotation); + } + } + + + public void visitAnnotation(Clazz clazz, Method method, Annotation annotation) + { + if (accepted(annotation.getType(clazz))) + { + annotationVisitor.visitAnnotation(clazz, method, annotation); + } + } + + + public void visitAnnotation(Clazz clazz, Method method, int parameterIndex, Annotation annotation) + { + if (accepted(annotation.getType(clazz))) + { + annotationVisitor.visitAnnotation(clazz, method, parameterIndex, annotation); + } + } + + + // Small utility methods. + + private boolean accepted(String name) + { + return regularExpressionMatcher.matches(name); + } +} diff --git a/src/proguard/classfile/attribute/annotation/visitor/AnnotationVisitor.java b/src/proguard/classfile/attribute/annotation/visitor/AnnotationVisitor.java new file mode 100644 index 0000000..16b2a56 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/AnnotationVisitor.java @@ -0,0 +1,40 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.Annotation; + +/** + * This interface specifies the methods for a visitor of + * Annotation objects. Note that there is only a single + * implementation of Annotation, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface AnnotationVisitor +{ + public void visitAnnotation(Clazz clazz, Annotation annotation); + public void visitAnnotation(Clazz clazz, Field field, Annotation annotation); + public void visitAnnotation(Clazz clazz, Method method, Annotation annotation); + public void visitAnnotation(Clazz clazz, Method method, int parameterIndex, Annotation annotation); +} diff --git a/src/proguard/classfile/attribute/annotation/visitor/ElementValueVisitor.java b/src/proguard/classfile/attribute/annotation/visitor/ElementValueVisitor.java new file mode 100644 index 0000000..112084a --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/ElementValueVisitor.java @@ -0,0 +1,51 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.annotation.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.annotation.*; + +/** + * This interface specifies the methods for a visitor of ElementValue + * objects. + * + * @author Eric Lafortune + */ +public interface ElementValueVisitor +{ + public void visitConstantElementValue( Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue); + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue); + public void visitClassElementValue( Clazz clazz, Annotation annotation, ClassElementValue classElementValue); + public void visitAnnotationElementValue( Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue); + public void visitArrayElementValue( Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue); + +// public void visitConstantElementValue( Clazz clazz, Field field, Annotation annotation, ConstantElementValue constantElementValue); +// public void visitEnumConstantElementValue(Clazz clazz, Field field, Annotation annotation, EnumConstantElementValue enumConstantElementValue); +// public void visitClassElementValue( Clazz clazz, Field field, Annotation annotation, ClassElementValue classElementValue); +// public void visitAnnotationElementValue( Clazz clazz, Field field, Annotation annotation, AnnotationElementValue annotationElementValue); +// public void visitArrayElementValue( Clazz clazz, Field field, Annotation annotation, ArrayElementValue arrayElementValue); +// +// public void visitConstantElementValue( Clazz clazz, Method method, Annotation annotation, ConstantElementValue constantElementValue); +// public void visitEnumConstantElementValue(Clazz clazz, Method method, Annotation annotation, EnumConstantElementValue enumConstantElementValue); +// public void visitClassElementValue( Clazz clazz, Method method, Annotation annotation, ClassElementValue classElementValue); +// public void visitAnnotationElementValue( Clazz clazz, Method method, Annotation annotation, AnnotationElementValue annotationElementValue); +// public void visitArrayElementValue( Clazz clazz, Method method, Annotation annotation, ArrayElementValue arrayElementValue); +} diff --git a/src/proguard/classfile/attribute/annotation/visitor/package.html b/src/proguard/classfile/attribute/annotation/visitor/package.html new file mode 100644 index 0000000..10d0648 --- /dev/null +++ b/src/proguard/classfile/attribute/annotation/visitor/package.html @@ -0,0 +1,3 @@ + +This package contains visitors for annotation attributes and their components. + diff --git a/src/proguard/classfile/attribute/package.html b/src/proguard/classfile/attribute/package.html new file mode 100644 index 0000000..d17caaa --- /dev/null +++ b/src/proguard/classfile/attribute/package.html @@ -0,0 +1,3 @@ + +This package contains classes to represent the attributes inside class files. + diff --git a/src/proguard/classfile/attribute/preverification/DoubleType.java b/src/proguard/classfile/attribute/preverification/DoubleType.java new file mode 100644 index 0000000..d574dcb --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/DoubleType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Double type. + * + * @author Eric Lafortune + */ +public class DoubleType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return DOUBLE_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitDoubleType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackDoubleType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesDoubleType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "d"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/FloatType.java b/src/proguard/classfile/attribute/preverification/FloatType.java new file mode 100644 index 0000000..2f24720 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/FloatType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Float type. + * + * @author Eric Lafortune + */ +public class FloatType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return FLOAT_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitFloatType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackFloatType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesFloatType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "f"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/FullFrame.java b/src/proguard/classfile/attribute/preverification/FullFrame.java new file mode 100644 index 0000000..adf5684 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/FullFrame.java @@ -0,0 +1,202 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.*; + +/** + * This StackMapFrame represents a "full frame". + * + * @author Eric Lafortune + */ +public class FullFrame extends StackMapFrame +{ + public int variablesCount; + public VerificationType[] variables; + public int stackCount; + public VerificationType[] stack; + + + /** + * Creates an uninitialized FullFrame. + */ + public FullFrame() + { + } + + + /** + * Creates a FullFrame with the given variables and stack. + */ + public FullFrame(int offsetDelta, + VerificationType[] variables, + VerificationType[] stack) + { + this(offsetDelta, + variables.length, + variables, + stack.length, + stack); + } + + + /** + * Creates a FullFrame with the given variables and stack. + */ + public FullFrame(int offsetDelta, + int variablesCount, + VerificationType[] variables, + int stackCount, + VerificationType[] stack) + { + this.u2offsetDelta = offsetDelta; + this.variablesCount = variablesCount; + this.variables = variables; + this.stackCount = stackCount; + this.stack = stack; + } + + + /** + * Applies the given verification type visitor to all variables. + */ + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationTypeVisitor verificationTypeVisitor) + { + for (int index = 0; index < variablesCount; index++) + { + variables[index].variablesAccept(clazz, method, codeAttribute, offset, index, verificationTypeVisitor); + } + } + + + /** + * Applies the given verification type visitor to all stack. + */ + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationTypeVisitor verificationTypeVisitor) + { + for (int index = 0; index < stackCount; index++) + { + stack[index].stackAccept(clazz, method, codeAttribute, offset, index, verificationTypeVisitor); + } + } + + + // Implementations for StackMapFrame. + + public int getTag() + { + return FULL_FRAME; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrameVisitor stackMapFrameVisitor) + { + stackMapFrameVisitor.visitFullFrame(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (!super.equals(object)) + { + return false; + } + + FullFrame other = (FullFrame)object; + + if (this.u2offsetDelta != other.u2offsetDelta || + this.variablesCount != other.variablesCount || + this.stackCount != other.stackCount) + { + return false; + } + + for (int index = 0; index < variablesCount; index++) + { + VerificationType thisType = this.variables[index]; + VerificationType otherType = other.variables[index]; + + if (!thisType.equals(otherType)) + { + return false; + } + } + + for (int index = 0; index < stackCount; index++) + { + VerificationType thisType = this.stack[index]; + VerificationType otherType = other.stack[index]; + + if (!thisType.equals(otherType)) + { + return false; + } + } + + return true; + } + + + public int hashCode() + { + int hashCode = super.hashCode(); + + for (int index = 0; index < variablesCount; index++) + { + hashCode ^= variables[index].hashCode(); + } + + for (int index = 0; index < stackCount; index++) + { + hashCode ^= stack[index].hashCode(); + } + + return hashCode; + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(super.toString()).append("Var: "); + + for (int index = 0; index < variablesCount; index++) + { + buffer = buffer.append('[') + .append(variables[index].toString()) + .append(']'); + } + + buffer.append(", Stack: "); + + for (int index = 0; index < stackCount; index++) + { + buffer = buffer.append('[') + .append(stack[index].toString()) + .append(']'); + } + + return buffer.toString(); + } +} diff --git a/src/proguard/classfile/attribute/preverification/IntegerType.java b/src/proguard/classfile/attribute/preverification/IntegerType.java new file mode 100644 index 0000000..55e3abe --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/IntegerType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Integer type. + * + * @author Eric Lafortune + */ +public class IntegerType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return INTEGER_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitIntegerType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackIntegerType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesIntegerType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "i"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/LessZeroFrame.java b/src/proguard/classfile/attribute/preverification/LessZeroFrame.java new file mode 100644 index 0000000..fcc8e0a --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/LessZeroFrame.java @@ -0,0 +1,103 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.StackMapFrameVisitor; + +/** + * This StackMapFrame represents an "chop frame". + * + * @author Eric Lafortune + */ +public class LessZeroFrame extends StackMapFrame +{ + public int choppedVariablesCount; + + + /** + * Creates an uninitialized LessZeroFrame. + */ + public LessZeroFrame() + { + } + + + /** + * Creates a LessZeroFrame with the given tag. + */ + public LessZeroFrame(int tag) + { + choppedVariablesCount = LESS_ZERO_FRAME + 3 - tag; + } + + + /** + * Creates a LessZeroFrame with the given number of chopped variables. + */ + public LessZeroFrame(byte choppedVariablesCount) + { + this.choppedVariablesCount = (int)choppedVariablesCount; + } + + + // Implementations for StackMapFrame. + + public int getTag() + { + return LESS_ZERO_FRAME + 3 - choppedVariablesCount; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrameVisitor stackMapFrameVisitor) + { + stackMapFrameVisitor.visitLessZeroFrame(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (!super.equals(object)) + { + return false; + } + + LessZeroFrame other = (LessZeroFrame)object; + + return this.u2offsetDelta == other.u2offsetDelta && + this.choppedVariablesCount != other.choppedVariablesCount; + } + + + public int hashCode() + { + return super.hashCode() ^ choppedVariablesCount; + } + + + public String toString() + { + return super.toString()+"Var: (chopped "+choppedVariablesCount+"), Stack: (empty)"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/LongType.java b/src/proguard/classfile/attribute/preverification/LongType.java new file mode 100644 index 0000000..9b14dd6 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/LongType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Long type. + * + * @author Eric Lafortune + */ +public class LongType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return LONG_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitLongType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackLongType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesLongType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "l"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/MoreZeroFrame.java b/src/proguard/classfile/attribute/preverification/MoreZeroFrame.java new file mode 100644 index 0000000..881f188 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/MoreZeroFrame.java @@ -0,0 +1,161 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.*; + +/** + * This StackMapFrame represents an "append frame". + * + * @author Eric Lafortune + */ +public class MoreZeroFrame extends StackMapFrame +{ + public int additionalVariablesCount; + public VerificationType[] additionalVariables; + + + /** + * Creates an uninitialized MoreZeroFrame. + */ + public MoreZeroFrame() + { + } + + + /** + * Creates a MoreZeroFrame with the given tag. + */ + public MoreZeroFrame(int tag) + { + additionalVariablesCount = tag + 1 - MORE_ZERO_FRAME; + } + + + /** + * Creates a MoreZeroFrame with the given additional variables. + */ + public MoreZeroFrame(VerificationType[] additionalVariables) + { + this(additionalVariables.length, additionalVariables); + } + + + /** + * Creates a MoreZeroFrame with the given additional variables. + */ + public MoreZeroFrame(int additionalVariablesCount, + VerificationType[] additionalVariables) + { + this.additionalVariablesCount = additionalVariablesCount; + this.additionalVariables = additionalVariables; + } + + + /** + * Applies the given verification type visitor to all variables. + */ + public void additionalVariablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationTypeVisitor verificationTypeVisitor) + { + for (int index = 0; index < additionalVariablesCount; index++) + { + additionalVariables[index].accept(clazz, method, codeAttribute, offset, verificationTypeVisitor); + } + } + + + // Implementations for StackMapFrame. + + public int getTag() + { + return MORE_ZERO_FRAME + additionalVariablesCount - 1; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrameVisitor stackMapFrameVisitor) + { + stackMapFrameVisitor.visitMoreZeroFrame(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (!super.equals(object)) + { + return false; + } + + MoreZeroFrame other = (MoreZeroFrame)object; + + if (this.u2offsetDelta != other.u2offsetDelta || + this.additionalVariablesCount != other.additionalVariablesCount) + { + return false; + } + + for (int index = 0; index < additionalVariablesCount; index++) + { + VerificationType thisType = this.additionalVariables[index]; + VerificationType otherType = other.additionalVariables[index]; + + if (!thisType.equals(otherType)) + { + return false; + } + } + + return true; + } + + + public int hashCode() + { + int hashCode = super.hashCode(); + + for (int index = 0; index < additionalVariablesCount; index++) + { + hashCode ^= additionalVariables[index].hashCode(); + } + + return hashCode; + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(super.toString()).append("Var: ..."); + + for (int index = 0; index < additionalVariablesCount; index++) + { + buffer = buffer.append('[') + .append(additionalVariables[index].toString()) + .append(']'); + } + + buffer.append(", Stack: (empty)"); + + return buffer.toString(); + } +} diff --git a/src/proguard/classfile/attribute/preverification/NullType.java b/src/proguard/classfile/attribute/preverification/NullType.java new file mode 100644 index 0000000..f35cefd --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/NullType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Null type. + * + * @author Eric Lafortune + */ +public class NullType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return NULL_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitNullType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackNullType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesNullType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "n"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/ObjectType.java b/src/proguard/classfile/attribute/preverification/ObjectType.java new file mode 100644 index 0000000..fbdeec7 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/ObjectType.java @@ -0,0 +1,107 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents an Object type. + * + * @author Eric Lafortune + */ +public class ObjectType extends VerificationType +{ + public int u2classIndex; + + + + /** + * Creates an uninitialized ObjectType. + */ + public ObjectType() + { + } + + + /** + * Creates an ObjectType that points to the given class constant. + */ + public ObjectType(int u2classIndex) + { + this.u2classIndex = u2classIndex; + } + + + // Implementations for VerificationType. + + public int getTag() + { + return OBJECT_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitObjectType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackObjectType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesObjectType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (!super.equals(object)) + { + return false; + } + + ObjectType other = (ObjectType)object; + + return this.u2classIndex == other.u2classIndex; + } + + + public int hashCode() + { + return super.hashCode() ^ + u2classIndex; + } + + + public String toString() + { + return "a:" + u2classIndex; + } +} diff --git a/src/proguard/classfile/attribute/preverification/SameOneFrame.java b/src/proguard/classfile/attribute/preverification/SameOneFrame.java new file mode 100644 index 0000000..db6747b --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/SameOneFrame.java @@ -0,0 +1,115 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.*; + +/** + * This StackMapFrame represents a "same locals 1 stack item frame" or a + * "same locals 1 stack item frame extended". + * + * @author Eric Lafortune + */ +public class SameOneFrame extends StackMapFrame +{ + public VerificationType stackItem; + + + /** + * Creates an uninitialized SameOneFrame. + */ + public SameOneFrame() + { + } + + + /** + * Creates a SameOneFrame with the given tag. + */ + public SameOneFrame(int tag) + { + u2offsetDelta = tag - SAME_ONE_FRAME; + } + + + /** + * Creates a SameOneFrame with the given stack verification type. + */ + public SameOneFrame(VerificationType stackItem) + { + this.stackItem = stackItem; + } + + + /** + * Applies the given verification type visitor to the stack item. + */ + public void stackItemAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationTypeVisitor verificationTypeVisitor) + { + stackItem.accept(clazz, method, codeAttribute, offset, verificationTypeVisitor); + } + + + // Implementations for StackMapFrame. + + public int getTag() + { + return u2offsetDelta < 64 ? + SAME_ONE_FRAME + u2offsetDelta : + SAME_ONE_FRAME_EXTENDED; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrameVisitor stackMapFrameVisitor) + { + stackMapFrameVisitor.visitSameOneFrame(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (!super.equals(object)) + { + return false; + } + + SameOneFrame other = (SameOneFrame)object; + + return this.u2offsetDelta == other.u2offsetDelta && + this.stackItem.equals(other.stackItem); + } + + + public int hashCode() + { + return super.hashCode() ^ stackItem.hashCode(); + } + + + public String toString() + { + return super.toString()+"Var: ..., Stack: ["+stackItem.toString()+"]"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/SameZeroFrame.java b/src/proguard/classfile/attribute/preverification/SameZeroFrame.java new file mode 100644 index 0000000..64b17f5 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/SameZeroFrame.java @@ -0,0 +1,74 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.StackMapFrameVisitor; + +/** + * This StackMapFrame represents a "same frame" or a "same frame extended". + * + * @author Eric Lafortune + * @noinspection PointlessArithmeticExpression + */ +public class SameZeroFrame extends StackMapFrame +{ + /** + * Creates an uninitialized SameZeroFrame. + */ + public SameZeroFrame() + { + } + + + /** + * Creates a SameZeroFrame with the given tag. + */ + public SameZeroFrame(int tag) + { + u2offsetDelta = tag - SAME_ZERO_FRAME; + } + + + // Implementations for StackMapFrame. + + public int getTag() + { + return u2offsetDelta < 64 ? + SAME_ZERO_FRAME + u2offsetDelta : + SAME_ZERO_FRAME_EXTENDED; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrameVisitor stackMapFrameVisitor) + { + stackMapFrameVisitor.visitSameZeroFrame(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public String toString() + { + return super.toString()+"Var: ..., Stack: (empty)"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/StackMapAttribute.java b/src/proguard/classfile/attribute/preverification/StackMapAttribute.java new file mode 100644 index 0000000..db53ff1 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/StackMapAttribute.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.preverification.visitor.StackMapFrameVisitor; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents an exceptions attribute. + * + * @author Eric Lafortune + */ +public class StackMapAttribute extends Attribute +{ + public int u2stackMapFramesCount; + public FullFrame[] stackMapFrames; + + + /** + * Creates an uninitialized ExceptionsAttribute. + */ + public StackMapAttribute() + { + } + + + /** + * Creates a StackMapTableAttribute with the given stack map frames. + */ + public StackMapAttribute(FullFrame[] stackMapFrames) + { + this(stackMapFrames.length, stackMapFrames); + } + + + /** + * Creates a StackMapTableAttribute with the given stack map frames. + */ + public StackMapAttribute(int stackMapFramesCount, + FullFrame[] stackMapFrames) + { + this.u2stackMapFramesCount = stackMapFramesCount; + this.stackMapFrames = stackMapFrames; + } + + + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitStackMapAttribute(clazz, method, codeAttribute, this); + } + + + /** + * Applies the given stack map frame visitor to all stack map frames. + */ + public void stackMapFramesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapFrameVisitor stackMapFrameVisitor) + { + for (int index = 0; index < u2stackMapFramesCount; index++) + { + FullFrame stackMapFrame = stackMapFrames[index]; + + // We don't need double dispatching here, since there is only one + // type of StackMapFrame. + stackMapFrameVisitor.visitFullFrame(clazz, method, codeAttribute, stackMapFrame.getOffsetDelta(), stackMapFrame); + } + } +} diff --git a/src/proguard/classfile/attribute/preverification/StackMapFrame.java b/src/proguard/classfile/attribute/preverification/StackMapFrame.java new file mode 100644 index 0000000..aa3e1f2 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/StackMapFrame.java @@ -0,0 +1,117 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.StackMapFrameVisitor; + +/** + * This abstract class represents a stack map frame. Specific types + * of entries are subclassed from it. + * + * @author Eric Lafortune + */ +public abstract class StackMapFrame implements VisitorAccepter +{ + public static final int SAME_ZERO_FRAME = 0; + public static final int SAME_ONE_FRAME = 64; + public static final int SAME_ONE_FRAME_EXTENDED = 247; + public static final int LESS_ZERO_FRAME = 248; + public static final int SAME_ZERO_FRAME_EXTENDED = 251; + public static final int MORE_ZERO_FRAME = 252; + public static final int FULL_FRAME = 255; + + + public int u2offsetDelta; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + + /** + * Returns the bytecode offset delta relative to the previous stack map + * frame. + */ + public int getOffsetDelta() + { + return u2offsetDelta; + } + + + // Abstract methods to be implemented by extensions. + + /** + * Returns the stack map frame tag that specifies the entry type. + */ + public abstract int getTag(); + + + /** + * Accepts the given visitor. + */ + public abstract void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrameVisitor stackMapFrameVisitor); + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + StackMapFrame other = (StackMapFrame)object; + + return this.u2offsetDelta == other.u2offsetDelta; + } + + + public int hashCode() + { + return getClass().hashCode() ^ + u2offsetDelta; + } + + + public String toString() + { + return "[" + u2offsetDelta + "] "; + } +} diff --git a/src/proguard/classfile/attribute/preverification/StackMapTableAttribute.java b/src/proguard/classfile/attribute/preverification/StackMapTableAttribute.java new file mode 100644 index 0000000..0cddf70 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/StackMapTableAttribute.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.preverification.visitor.StackMapFrameVisitor; +import proguard.classfile.attribute.visitor.AttributeVisitor; + +/** + * This Attribute represents a stack map table attribute. + * + * @author Eric Lafortune + */ +public class StackMapTableAttribute extends Attribute +{ + public int u2stackMapFramesCount; + public StackMapFrame[] stackMapFrames; + + + /** + * Creates an uninitialized StackMapTableAttribute. + */ + public StackMapTableAttribute() + { + } + + + /** + * Creates a StackMapTableAttribute with the given stack map frames. + */ + public StackMapTableAttribute(StackMapFrame[] stackMapFrames) + { + this(stackMapFrames.length, stackMapFrames); + } + + + /** + * Creates a StackMapTableAttribute with the given stack map frames. + */ + public StackMapTableAttribute(int stackMapFramesCount, + StackMapFrame[] stackMapFrames) + { + this.u2stackMapFramesCount = stackMapFramesCount; + this.stackMapFrames = stackMapFrames; + } + + + // Implementations for Attribute. + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, AttributeVisitor attributeVisitor) + { + attributeVisitor.visitStackMapTableAttribute(clazz, method, codeAttribute, this); + } + + + /** + * Applies the given stack map frame visitor to all stack map frames. + */ + public void stackMapFramesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapFrameVisitor stackMapFrameVisitor) + { + int offset = 0; + + for (int index = 0; index < u2stackMapFramesCount; index++) + { + StackMapFrame stackMapFrame = stackMapFrames[index]; + + // Note that the byte code offset is computed differently for the + // first stack map frame. + offset += stackMapFrame.getOffsetDelta() + (index == 0 ? 0 : 1); + + stackMapFrame.accept(clazz, method, codeAttribute, offset, stackMapFrameVisitor); + } + } +} diff --git a/src/proguard/classfile/attribute/preverification/TopType.java b/src/proguard/classfile/attribute/preverification/TopType.java new file mode 100644 index 0000000..bde8dda --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/TopType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Top type. + * + * @author Eric Lafortune + */ +public class TopType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return TOP_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitTopType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackTopType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesTopType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "T"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/UninitializedThisType.java b/src/proguard/classfile/attribute/preverification/UninitializedThisType.java new file mode 100644 index 0000000..dc4654f --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/UninitializedThisType.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a UninitializedThis type. + * + * @author Eric Lafortune + */ +public class UninitializedThisType extends VerificationType +{ + // Implementations for VerificationType. + + public int getTag() + { + return UNINITIALIZED_THIS_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitUninitializedThisType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackUninitializedThisType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesUninitializedThisType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public String toString() + { + return "u:this"; + } +} diff --git a/src/proguard/classfile/attribute/preverification/UninitializedType.java b/src/proguard/classfile/attribute/preverification/UninitializedType.java new file mode 100644 index 0000000..a495f1f --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/UninitializedType.java @@ -0,0 +1,106 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This VerificationType represents a Uninitialized type. + * + * @author Eric Lafortune + */ +public class UninitializedType extends VerificationType +{ + public int u2newInstructionOffset; + + + /** + * Creates an uninitialized UninitializedType. + */ + public UninitializedType() + { + } + + + /** + * Creates an UninitializedType pointing to the given 'new' instruction. + */ + public UninitializedType(int u2newInstructionOffset) + { + this.u2newInstructionOffset = u2newInstructionOffset; + } + + + // Implementations for VerificationType. + + public int getTag() + { + return UNINITIALIZED_TYPE; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitUninitializedType(clazz, method, codeAttribute, instructionOffset, this); + } + + + public void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitStackUninitializedType(clazz, method, codeAttribute, instructionOffset, stackIndex, this); + } + + + public void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor) + { + verificationTypeVisitor.visitVariablesUninitializedType(clazz, method, codeAttribute, instructionOffset, variableIndex, this); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (!super.equals(object)) + { + return false; + } + + UninitializedType other = (UninitializedType)object; + + return this.u2newInstructionOffset == other.u2newInstructionOffset; + } + + + public int hashCode() + { + return super.hashCode() ^ + u2newInstructionOffset; + } + + + public String toString() + { + return "u:" + u2newInstructionOffset; + } +} diff --git a/src/proguard/classfile/attribute/preverification/VerificationType.java b/src/proguard/classfile/attribute/preverification/VerificationType.java new file mode 100644 index 0000000..f33d511 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/VerificationType.java @@ -0,0 +1,103 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.visitor.VerificationTypeVisitor; + +/** + * This abstract class represents a verification type of a local variable or + * a stack element. Specific verification types are subclassed from it. + * + * @author Eric Lafortune + */ +public abstract class VerificationType implements VisitorAccepter +{ + public static final int TOP_TYPE = 0; + public static final int INTEGER_TYPE = 1; + public static final int FLOAT_TYPE = 2; + public static final int DOUBLE_TYPE = 3; + public static final int LONG_TYPE = 4; + public static final int NULL_TYPE = 5; + public static final int UNINITIALIZED_THIS_TYPE = 6; + public static final int OBJECT_TYPE = 7; + public static final int UNINITIALIZED_TYPE = 8; + + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + /** + * Returns the tag of the verification type. + */ + public abstract int getTag(); + + + /** + * Accepts the given visitor in the context of a method's code, either on + * a stack or as a variable. + */ + public abstract void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, VerificationTypeVisitor verificationTypeVisitor); + + + /** + * Accepts the given visitor in the context of a stack in a method's code . + */ + public abstract void stackAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int stackIndex, VerificationTypeVisitor verificationTypeVisitor); + + + /** + * Accepts the given visitor in the context of a variable in a method's code. + */ + public abstract void variablesAccept(Clazz clazz, Method method, CodeAttribute codeAttribute, int instructionOffset, int variableIndex, VerificationTypeVisitor verificationTypeVisitor); + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } +} diff --git a/src/proguard/classfile/attribute/preverification/VerificationTypeFactory.java b/src/proguard/classfile/attribute/preverification/VerificationTypeFactory.java new file mode 100644 index 0000000..f8ef7e0 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/VerificationTypeFactory.java @@ -0,0 +1,112 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification; + +/** + * This class provides methods to create and reuse IntegerType objects. + * + * @author Eric Lafortune + */ +public class VerificationTypeFactory +{ + // Shared copies of Type objects, to avoid creating a lot of objects. + static final IntegerType INTEGER_TYPE = new IntegerType(); + static final LongType LONG_TYPE = new LongType(); + static final FloatType FLOAT_TYPE = new FloatType(); + static final DoubleType DOUBLE_TYPE = new DoubleType(); + static final TopType TOP_TYPE = new TopType(); + static final NullType NULL_TYPE = new NullType(); + static final UninitializedThisType UNINITIALIZED_THIS_TYPE = new UninitializedThisType(); + + + /** + * Creates a new IntegerType. + */ + public static IntegerType createIntegerType() + { + return INTEGER_TYPE; + } + + /** + * Creates a new LongType. + */ + public static LongType createLongType() + { + return LONG_TYPE; + } + + /** + * Creates a new FloatType. + */ + public static FloatType createFloatType() + { + return FLOAT_TYPE; + } + + /** + * Creates a new DoubleType. + */ + public static DoubleType createDoubleType() + { + return DOUBLE_TYPE; + } + + /** + * Creates a new TopType. + */ + public static TopType createTopType() + { + return TOP_TYPE; + } + + /** + * Creates a new NullType. + */ + public static NullType createNullType() + { + return NULL_TYPE; + } + + /** + * Creates a new UninitializedThisType. + */ + public static UninitializedThisType createUninitializedThisType() + { + return UNINITIALIZED_THIS_TYPE; + } + + /** + * Creates a new UninitializedType for an instance that was created at + * the given offset. + */ + public static UninitializedType createUninitializedType(int newInstructionOffset) + { + return new UninitializedType(newInstructionOffset); + } + + /** + * Creates a new ObjectType of the given type. + */ + public static ObjectType createObjectType(int classIndex) + { + return new ObjectType(classIndex); + } +} diff --git a/src/proguard/classfile/attribute/preverification/visitor/StackMapFrameVisitor.java b/src/proguard/classfile/attribute/preverification/visitor/StackMapFrameVisitor.java new file mode 100644 index 0000000..7db246c --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/visitor/StackMapFrameVisitor.java @@ -0,0 +1,40 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.*; + +/** + * This interface specifies the methods for a visitor of + * StackMapFrame objects. + * + * @author Eric Lafortune + */ +public interface StackMapFrameVisitor +{ + public void visitSameZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameZeroFrame sameZeroFrame); + public void visitSameOneFrame( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame); + public void visitLessZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LessZeroFrame lessZeroFrame); + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame); + public void visitFullFrame( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame); +} diff --git a/src/proguard/classfile/attribute/preverification/visitor/VerificationTypeVisitor.java b/src/proguard/classfile/attribute/preverification/visitor/VerificationTypeVisitor.java new file mode 100644 index 0000000..e9931f8 --- /dev/null +++ b/src/proguard/classfile/attribute/preverification/visitor/VerificationTypeVisitor.java @@ -0,0 +1,65 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.preverification.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.preverification.*; + +/** + * This interface specifies the methods for a visitor of + * VerificationType objects. There a methods for stack entries + * and methods for variable entries. + * + * @author Eric Lafortune + */ +public interface VerificationTypeVisitor +{ + public void visitIntegerType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, IntegerType integerType); + public void visitFloatType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FloatType floatType); + public void visitLongType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LongType longType); + public void visitDoubleType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, DoubleType doubleType); + public void visitTopType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TopType topType); + public void visitObjectType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType); + public void visitNullType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, NullType nullType); + public void visitUninitializedType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType); + public void visitUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedThisType uninitializedThisType); + + public void visitStackIntegerType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, IntegerType integerType); + public void visitStackFloatType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, FloatType floatType); + public void visitStackLongType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, LongType longType); + public void visitStackDoubleType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, DoubleType doubleType); + public void visitStackTopType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, TopType topType); + public void visitStackObjectType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, ObjectType objectType); + public void visitStackNullType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, NullType nullType); + public void visitStackUninitializedType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedType uninitializedType); + public void visitStackUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedThisType uninitializedThisType); + + public void visitVariablesIntegerType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, IntegerType integerType); + public void visitVariablesFloatType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, FloatType floatType); + public void visitVariablesLongType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, LongType longType); + public void visitVariablesDoubleType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, DoubleType doubleType); + public void visitVariablesTopType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, TopType topType); + public void visitVariablesObjectType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, ObjectType objectType); + public void visitVariablesNullType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, NullType nullType); + public void visitVariablesUninitializedType( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedType uninitializedType); + public void visitVariablesUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedThisType uninitializedThisType); +} diff --git a/src/proguard/classfile/attribute/visitor/AllAttributeVisitor.java b/src/proguard/classfile/attribute/visitor/AllAttributeVisitor.java new file mode 100644 index 0000000..61b0f1a --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/AllAttributeVisitor.java @@ -0,0 +1,117 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor, MemberVisitor, and AttributeVisitor lets a given + * AttributeVisitor visit all Attribute objects of the program classes, + * program class members, or code attributes, respectively, that it visits. + * + * @author Eric Lafortune + */ +public class AllAttributeVisitor +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + AttributeVisitor +{ + private final boolean deep; + private final AttributeVisitor attributeVisitor; + + + /** + * Creates a new shallow AllAttributeVisitor. + * @param attributeVisitor the AttributeVisitor to which visits will be + * delegated. + */ + public AllAttributeVisitor(AttributeVisitor attributeVisitor) + { + this(false, attributeVisitor); + } + + + /** + * Creates a new optionally deep AllAttributeVisitor. + * @param deep specifies whether the attributes contained + * further down the class structure should be + * visited too. + * @param attributeVisitor the AttributeVisitor to which visits will be + * delegated. + */ + public AllAttributeVisitor(boolean deep, + AttributeVisitor attributeVisitor) + { + this.deep = deep; + this.attributeVisitor = attributeVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.attributesAccept(attributeVisitor); + + // Visit the attributes further down the class structure, if required. + if (deep) + { + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + programClass.attributesAccept(this); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) {} + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + programMember.attributesAccept(programClass, attributeVisitor); + + // Visit the attributes further down the member structure, if required. + if (deep) + { + programMember.attributesAccept(programClass, this); + } + } + + + public void visitLibraryMember(LibraryClass programClass, LibraryMember programMember) {} + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + codeAttribute.attributesAccept(clazz, method, attributeVisitor); + } +} diff --git a/src/proguard/classfile/attribute/visitor/AllExceptionInfoVisitor.java b/src/proguard/classfile/attribute/visitor/AllExceptionInfoVisitor.java new file mode 100644 index 0000000..839e104 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/AllExceptionInfoVisitor.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor lets a given ExceptionInfoVisitor visit all exceptions + * objects of the CodeAttribute objects it visits. + * + * @author Eric Lafortune + */ +public class AllExceptionInfoVisitor +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final ExceptionInfoVisitor exceptionInfoVisitor; + + + public AllExceptionInfoVisitor(ExceptionInfoVisitor exceptionInfoVisitor) + { + this.exceptionInfoVisitor = exceptionInfoVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + codeAttribute.exceptionsAccept(clazz, method, exceptionInfoVisitor); + } +} diff --git a/src/proguard/classfile/attribute/visitor/AttributeNameFilter.java b/src/proguard/classfile/attribute/visitor/AttributeNameFilter.java new file mode 100644 index 0000000..aa81ce0 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/AttributeNameFilter.java @@ -0,0 +1,345 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.util.StringMatcher; + +/** + * This AttributeVisitor delegates its visits another AttributeVisitor, but + * only when the visited attribute has a name that passes a given string + * matcher. + * + * @author Eric Lafortune + */ +public class AttributeNameFilter +implements AttributeVisitor +{ + private final StringMatcher stringMatcher; + private final AttributeVisitor attributeVisitor; + + + /** + * Creates a new AttributeNameFilter. + * @param stringMatcher the string matcher that will check the attribute + * names. + * @param attributeVisitor the AttributeVisitor to which + * visits will be delegated. + */ + public AttributeNameFilter(StringMatcher stringMatcher, + AttributeVisitor attributeVisitor) + { + this.stringMatcher = stringMatcher; + this.attributeVisitor = attributeVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + if (accepted(clazz, unknownAttribute)) + { + unknownAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + if (accepted(clazz, sourceFileAttribute)) + { + sourceFileAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + if (accepted(clazz, sourceDirAttribute)) + { + sourceDirAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + if (accepted(clazz, innerClassesAttribute)) + { + innerClassesAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + if (accepted(clazz, enclosingMethodAttribute)) + { + enclosingMethodAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + if (accepted(clazz, deprecatedAttribute)) + { + deprecatedAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, Field field, DeprecatedAttribute deprecatedAttribute) + { + if (accepted(clazz, deprecatedAttribute)) + { + deprecatedAttribute.accept(clazz, field, attributeVisitor); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, Method method, DeprecatedAttribute deprecatedAttribute) + { + if (accepted(clazz, deprecatedAttribute)) + { + deprecatedAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + if (accepted(clazz, syntheticAttribute)) + { + syntheticAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, Field field, SyntheticAttribute syntheticAttribute) + { + if (accepted(clazz, syntheticAttribute)) + { + syntheticAttribute.accept(clazz, field, attributeVisitor); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, Method method, SyntheticAttribute syntheticAttribute) + { + if (accepted(clazz, syntheticAttribute)) + { + syntheticAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + if (accepted(clazz, signatureAttribute)) + { + signatureAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitSignatureAttribute(Clazz clazz, Field field, SignatureAttribute signatureAttribute) + { + if (accepted(clazz, signatureAttribute)) + { + signatureAttribute.accept(clazz, field, attributeVisitor); + } + } + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute signatureAttribute) + { + if (accepted(clazz, signatureAttribute)) + { + signatureAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + if (accepted(clazz, constantValueAttribute)) + { + constantValueAttribute.accept(clazz, field, attributeVisitor); + } + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + if (accepted(clazz, exceptionsAttribute)) + { + exceptionsAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (accepted(clazz, codeAttribute)) + { + codeAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + if (accepted(clazz, stackMapAttribute)) + { + stackMapAttribute.accept(clazz, method, codeAttribute, attributeVisitor); + } + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + if (accepted(clazz, stackMapTableAttribute)) + { + stackMapTableAttribute.accept(clazz, method, codeAttribute, attributeVisitor); + } + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + if (accepted(clazz, lineNumberTableAttribute)) + { + lineNumberTableAttribute.accept(clazz, method, codeAttribute, attributeVisitor); + } + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + if (accepted(clazz, localVariableTableAttribute)) + { + localVariableTableAttribute.accept(clazz, method, codeAttribute, attributeVisitor); + } + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + if (accepted(clazz, localVariableTypeTableAttribute)) + { + localVariableTypeTableAttribute.accept(clazz, method, codeAttribute, attributeVisitor); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + if (accepted(clazz, runtimeVisibleAnnotationsAttribute)) + { + runtimeVisibleAnnotationsAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + if (accepted(clazz, runtimeVisibleAnnotationsAttribute)) + { + runtimeVisibleAnnotationsAttribute.accept(clazz, field, attributeVisitor); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + if (accepted(clazz, runtimeVisibleAnnotationsAttribute)) + { + runtimeVisibleAnnotationsAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + if (accepted(clazz, runtimeInvisibleAnnotationsAttribute)) + { + runtimeInvisibleAnnotationsAttribute.accept(clazz, attributeVisitor); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + if (accepted(clazz, runtimeInvisibleAnnotationsAttribute)) + { + runtimeInvisibleAnnotationsAttribute.accept(clazz, field, attributeVisitor); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + if (accepted(clazz, runtimeInvisibleAnnotationsAttribute)) + { + runtimeInvisibleAnnotationsAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + if (accepted(clazz, runtimeVisibleParameterAnnotationsAttribute)) + { + runtimeVisibleParameterAnnotationsAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + if (accepted(clazz, runtimeInvisibleParameterAnnotationsAttribute)) + { + runtimeInvisibleParameterAnnotationsAttribute.accept(clazz, method, attributeVisitor); + } + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + if (accepted(clazz, annotationDefaultAttribute)) + { + annotationDefaultAttribute.accept(clazz, method, attributeVisitor); + } + } + + + // Small utility methods. + + private boolean accepted(Clazz clazz, Attribute attribute) + { + return stringMatcher.matches(attribute.getAttributeName(clazz)); + } +} diff --git a/src/proguard/classfile/attribute/visitor/AttributeVisitor.java b/src/proguard/classfile/attribute/visitor/AttributeVisitor.java new file mode 100644 index 0000000..e8f226b --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/AttributeVisitor.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; + +/** + * This interface specifies the methods for a visitor of Attribute + * objects. + * + * @author Eric Lafortune + */ +public interface AttributeVisitor +{ + // Attributes that are attached to classes. + + public void visitUnknownAttribute( Clazz clazz, UnknownAttribute unknownAttribute); + public void visitSourceFileAttribute( Clazz clazz, SourceFileAttribute sourceFileAttribute); + public void visitSourceDirAttribute( Clazz clazz, SourceDirAttribute sourceDirAttribute); + public void visitInnerClassesAttribute( Clazz clazz, InnerClassesAttribute innerClassesAttribute); + public void visitEnclosingMethodAttribute( Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute); + + // Attributes that are attached to classes, fields, and methods. + + public void visitDeprecatedAttribute( Clazz clazz, DeprecatedAttribute deprecatedAttribute); + public void visitDeprecatedAttribute( Clazz clazz, Field field, DeprecatedAttribute deprecatedAttribute); + public void visitDeprecatedAttribute( Clazz clazz, Method method, DeprecatedAttribute deprecatedAttribute); + + public void visitSyntheticAttribute( Clazz clazz, SyntheticAttribute syntheticAttribute); + public void visitSyntheticAttribute( Clazz clazz, Field field, SyntheticAttribute syntheticAttribute); + public void visitSyntheticAttribute( Clazz clazz, Method method, SyntheticAttribute syntheticAttribute); + + public void visitSignatureAttribute( Clazz clazz, SignatureAttribute signatureAttribute); + public void visitSignatureAttribute( Clazz clazz, Field field, SignatureAttribute signatureAttribute); + public void visitSignatureAttribute( Clazz clazz, Method method, SignatureAttribute signatureAttribute); + + // Attributes that are attached to fields. + + public void visitConstantValueAttribute( Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute); + + // Attributes that are attached to methods. + + public void visitExceptionsAttribute( Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute); + public void visitCodeAttribute( Clazz clazz, Method method, CodeAttribute codeAttribute); + + // Attributes that are attached to code attributes. + + public void visitStackMapAttribute( Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute); + public void visitStackMapTableAttribute( Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute); + public void visitLineNumberTableAttribute( Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute); + public void visitLocalVariableTableAttribute( Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute); + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute); + + // Annotation attributes. + + public void visitRuntimeVisibleAnnotationsAttribute( Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute); + public void visitRuntimeVisibleAnnotationsAttribute( Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute); + public void visitRuntimeVisibleAnnotationsAttribute( Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute); + + public void visitRuntimeInvisibleAnnotationsAttribute( Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute); + public void visitRuntimeInvisibleAnnotationsAttribute( Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute); + public void visitRuntimeInvisibleAnnotationsAttribute( Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute); + + public void visitRuntimeVisibleParameterAnnotationsAttribute( Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute); + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute); + + public void visitAnnotationDefaultAttribute( Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute); +} diff --git a/src/proguard/classfile/attribute/visitor/ExceptionInfoVisitor.java b/src/proguard/classfile/attribute/visitor/ExceptionInfoVisitor.java new file mode 100644 index 0000000..7c85e53 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/ExceptionInfoVisitor.java @@ -0,0 +1,37 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; + +/** + * This interface specifies the methods for a visitor of + * ExceptionInfo objects. Note that there is only a single + * implementation of ExceptionInfo, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface ExceptionInfoVisitor +{ + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo); +} diff --git a/src/proguard/classfile/attribute/visitor/InnerClassesInfoVisitor.java b/src/proguard/classfile/attribute/visitor/InnerClassesInfoVisitor.java new file mode 100644 index 0000000..91267b0 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/InnerClassesInfoVisitor.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.InnerClassesInfo; + + +/** + * This interface specifies the methods for a visitor of + * InnerClassesInfo objects. Note that there is only a single + * implementation of InnerClassesInfo, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface InnerClassesInfoVisitor +{ + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo); +} diff --git a/src/proguard/classfile/attribute/visitor/LineNumberInfoVisitor.java b/src/proguard/classfile/attribute/visitor/LineNumberInfoVisitor.java new file mode 100644 index 0000000..e59ed7b --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/LineNumberInfoVisitor.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; + + +/** + * This interface specifies the methods for a visitor of + * LineNumberInfo objects. Note that there is only a single + * implementation of LineNumberInfo, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface LineNumberInfoVisitor +{ + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo); +} diff --git a/src/proguard/classfile/attribute/visitor/LocalVariableInfoVisitor.java b/src/proguard/classfile/attribute/visitor/LocalVariableInfoVisitor.java new file mode 100644 index 0000000..8647cb3 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/LocalVariableInfoVisitor.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; + + +/** + * This interface specifies the methods for a visitor of + * LocalVariableInfo objects. Note that there is only a single + * implementation of LocalVariableInfo, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface LocalVariableInfoVisitor +{ + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo); +} diff --git a/src/proguard/classfile/attribute/visitor/LocalVariableTypeInfoVisitor.java b/src/proguard/classfile/attribute/visitor/LocalVariableTypeInfoVisitor.java new file mode 100644 index 0000000..9ad38e0 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/LocalVariableTypeInfoVisitor.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; + + +/** + * This interface specifies the methods for a visitor of + * LocalVariableTypeInfo objects. Note that there is only a single + * implementation of LocalVariableTypeInfo, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface LocalVariableTypeInfoVisitor +{ + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo); +} diff --git a/src/proguard/classfile/attribute/visitor/MultiAttributeVisitor.java b/src/proguard/classfile/attribute/visitor/MultiAttributeVisitor.java new file mode 100644 index 0000000..870ba94 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/MultiAttributeVisitor.java @@ -0,0 +1,356 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; + +/** + * This AttributeVisitor delegates all visits to each AttributeVisitor + * in a given list. + * + * @author Eric Lafortune + */ +public class MultiAttributeVisitor implements AttributeVisitor +{ + private AttributeVisitor[] attributeVisitors; + + + public MultiAttributeVisitor() + { + } + + + public MultiAttributeVisitor(AttributeVisitor[] attributeVisitors) + { + this.attributeVisitors = attributeVisitors; + } + + + public void addAttributeVisitor(AttributeVisitor attributeVisitor) + { + incrementArraySize(); + + attributeVisitors[attributeVisitors.length - 1] = attributeVisitor; + } + + + private void incrementArraySize() + { + if (attributeVisitors == null) + { + attributeVisitors = new AttributeVisitor[1]; + } + else + { + AttributeVisitor[] newAttributeVisitors = + new AttributeVisitor[attributeVisitors.length + 1]; + System.arraycopy(attributeVisitors, 0, + newAttributeVisitors, 0, + attributeVisitors.length); + attributeVisitors = newAttributeVisitors; + } + } + + + // Implementations for AttributeVisitor. + + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitUnknownAttribute(clazz, unknownAttribute); + } + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSourceFileAttribute(clazz, sourceFileAttribute); + } + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSourceDirAttribute(clazz, sourceDirAttribute); + } + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitInnerClassesAttribute(clazz, innerClassesAttribute); + } + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitEnclosingMethodAttribute(clazz, enclosingMethodAttribute); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitDeprecatedAttribute(clazz, deprecatedAttribute); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSyntheticAttribute(clazz, syntheticAttribute); + } + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute syntheticAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSignatureAttribute(clazz, syntheticAttribute); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, Field field, DeprecatedAttribute deprecatedAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitDeprecatedAttribute(clazz, field, deprecatedAttribute); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, Field field, SyntheticAttribute syntheticAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSyntheticAttribute(clazz, field, syntheticAttribute); + } + } + + + public void visitSignatureAttribute(Clazz clazz, Field field, SignatureAttribute syntheticAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSignatureAttribute(clazz, field, syntheticAttribute); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, Method method, DeprecatedAttribute deprecatedAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitDeprecatedAttribute(clazz, method, deprecatedAttribute); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, Method method, SyntheticAttribute syntheticAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSyntheticAttribute(clazz, method, syntheticAttribute); + } + } + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute syntheticAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitSignatureAttribute(clazz, method, syntheticAttribute); + } + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitConstantValueAttribute(clazz, field, constantValueAttribute); + } + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitExceptionsAttribute(clazz, method, exceptionsAttribute); + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitCodeAttribute(clazz, method, codeAttribute); + } + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitStackMapAttribute(clazz, method, codeAttribute, stackMapAttribute); + } + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitStackMapTableAttribute(clazz, method, codeAttribute, stackMapTableAttribute); + } + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitLineNumberTableAttribute(clazz, method, codeAttribute, lineNumberTableAttribute); + } + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitLocalVariableTableAttribute(clazz, method, codeAttribute, localVariableTableAttribute); + } + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitLocalVariableTypeTableAttribute(clazz, method, codeAttribute, localVariableTypeTableAttribute); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeVisibleAnnotationsAttribute(clazz, runtimeVisibleAnnotationsAttribute); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeInvisibleAnnotationsAttribute(clazz, runtimeInvisibleAnnotationsAttribute); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeVisibleAnnotationsAttribute(clazz, field, runtimeVisibleAnnotationsAttribute); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeInvisibleAnnotationsAttribute(clazz, field, runtimeInvisibleAnnotationsAttribute); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeVisibleAnnotationsAttribute(clazz, method, runtimeVisibleAnnotationsAttribute); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeInvisibleAnnotationsAttribute(clazz, method, runtimeInvisibleAnnotationsAttribute); + } + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeVisibleParameterAnnotationsAttribute(clazz, method, runtimeVisibleParameterAnnotationsAttribute); + } + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitRuntimeInvisibleParameterAnnotationsAttribute(clazz, method, runtimeInvisibleParameterAnnotationsAttribute); + } + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + for (int index = 0; index < attributeVisitors.length; index++) + { + attributeVisitors[index].visitAnnotationDefaultAttribute(clazz, method, annotationDefaultAttribute); + } + } +} diff --git a/src/proguard/classfile/attribute/visitor/RequiredAttributeFilter.java b/src/proguard/classfile/attribute/visitor/RequiredAttributeFilter.java new file mode 100644 index 0000000..92099f9 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/RequiredAttributeFilter.java @@ -0,0 +1,351 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.obfuscate.AttributeShrinker; + +/** + * This AttributeVisitor delegates its visits to one of two other + * AttributeVisitor instances, depending on whether the visited attribute + * is strictly required or not. + * + * @see AttributeShrinker + * + * @author Eric Lafortune + */ +public class RequiredAttributeFilter +implements AttributeVisitor +{ + private final AttributeVisitor requiredAttributeVisitor; + private final AttributeVisitor optionalAttributeVisitor; + + + /** + * Creates a new RequiredAttributeFilter for visiting required attributes. + * @param requiredAttributeVisitor the visitor that will visit required + * attributes. + */ + public RequiredAttributeFilter(AttributeVisitor requiredAttributeVisitor) + { + this(requiredAttributeVisitor, null); + } + + + /** + * Creates a new RequiredAttributeFilter for visiting required and + * optional attributes. + * @param requiredAttributeVisitor the visitor that will visit required + * attributes. + * @param optionalAttributeVisitor the visitor that will visit optional + * attributes. + */ + public RequiredAttributeFilter(AttributeVisitor requiredAttributeVisitor, + AttributeVisitor optionalAttributeVisitor) + { + this.requiredAttributeVisitor = requiredAttributeVisitor; + this.optionalAttributeVisitor = optionalAttributeVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + if (optionalAttributeVisitor != null) + { + unknownAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + if (optionalAttributeVisitor != null) + { + sourceFileAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + if (optionalAttributeVisitor != null) + { + sourceDirAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + if (optionalAttributeVisitor != null) + { + innerClassesAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + if (optionalAttributeVisitor != null) + { + enclosingMethodAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + if (optionalAttributeVisitor != null) + { + deprecatedAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, Field field, DeprecatedAttribute deprecatedAttribute) + { + if (optionalAttributeVisitor != null) + { + deprecatedAttribute.accept(clazz, field, optionalAttributeVisitor); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, Method method, DeprecatedAttribute deprecatedAttribute) + { + if (optionalAttributeVisitor != null) + { + deprecatedAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + if (optionalAttributeVisitor != null) + { + syntheticAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, Field field, SyntheticAttribute syntheticAttribute) + { + if (optionalAttributeVisitor != null) + { + syntheticAttribute.accept(clazz, field, optionalAttributeVisitor); + } + } + + + public void visitSyntheticAttribute(Clazz clazz, Method method, SyntheticAttribute syntheticAttribute) + { + if (optionalAttributeVisitor != null) + { + syntheticAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + if (optionalAttributeVisitor != null) + { + signatureAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitSignatureAttribute(Clazz clazz, Field field, SignatureAttribute signatureAttribute) + { + if (optionalAttributeVisitor != null) + { + signatureAttribute.accept(clazz, field, optionalAttributeVisitor); + } + } + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute signatureAttribute) + { + if (optionalAttributeVisitor != null) + { + signatureAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + if (requiredAttributeVisitor != null) + { + constantValueAttribute.accept(clazz, field, requiredAttributeVisitor); + } + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + if (optionalAttributeVisitor != null) + { + exceptionsAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (requiredAttributeVisitor != null) + { + codeAttribute.accept(clazz, method, requiredAttributeVisitor); + } + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + if (optionalAttributeVisitor != null) + { + stackMapAttribute.accept(clazz, method, codeAttribute, optionalAttributeVisitor); + } + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + if (requiredAttributeVisitor != null) + { + stackMapTableAttribute.accept(clazz, method, codeAttribute, requiredAttributeVisitor); + } + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + if (optionalAttributeVisitor != null) + { + lineNumberTableAttribute.accept(clazz, method, codeAttribute, optionalAttributeVisitor); + } + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + if (optionalAttributeVisitor != null) + { + localVariableTableAttribute.accept(clazz, method, codeAttribute, optionalAttributeVisitor); + } + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + if (optionalAttributeVisitor != null) + { + localVariableTypeTableAttribute.accept(clazz, method, codeAttribute, optionalAttributeVisitor); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeVisibleAnnotationsAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeVisibleAnnotationsAttribute.accept(clazz, field, optionalAttributeVisitor); + } + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeVisibleAnnotationsAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeInvisibleAnnotationsAttribute.accept(clazz, optionalAttributeVisitor); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeInvisibleAnnotationsAttribute.accept(clazz, field, optionalAttributeVisitor); + } + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeInvisibleAnnotationsAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeVisibleParameterAnnotationsAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + if (optionalAttributeVisitor != null) + { + runtimeInvisibleParameterAnnotationsAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + if (optionalAttributeVisitor != null) + { + annotationDefaultAttribute.accept(clazz, method, optionalAttributeVisitor); + } + } +} diff --git a/src/proguard/classfile/attribute/visitor/StackSizeComputer.java b/src/proguard/classfile/attribute/visitor/StackSizeComputer.java new file mode 100644 index 0000000..401f188 --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/StackSizeComputer.java @@ -0,0 +1,379 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.attribute.visitor; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassPrinter; +import proguard.classfile.attribute.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor computes the stack sizes at all instruction offsets + * of the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class StackSizeComputer +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private boolean[] evaluated = new boolean[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] stackSizes = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + + private boolean exitInstructionBlock; + + private int stackSize; + private int maxStackSize; + + + /** + * Returns whether the instruction at the given offset is reachable in the + * most recently visited code attribute. + */ + public boolean isReachable(int instructionOffset) + { + return evaluated[instructionOffset]; + } + + + /** + * Returns the stack size at the given instruction offset of the most + * recently visited code attribute. + */ + public int getStackSize(int instructionOffset) + { + if (!evaluated[instructionOffset]) + { + throw new IllegalArgumentException("Unknown stack size at unreachable instruction offset ["+instructionOffset+"]"); + } + + return stackSizes[instructionOffset]; + } + + + /** + * Returns the maximum stack size of the most recently visited code attribute. + */ + public int getMaxStackSize() + { + return maxStackSize; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the code has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while computing stack sizes:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + if (DEBUG) + { + method.accept(clazz, new ClassPrinter()); + } + + throw ex; + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (DEBUG) + { + System.out.println("StackSizeComputer: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + } + + // Try to reuse the previous array. + int codeLength = codeAttribute.u4codeLength; + if (evaluated.length < codeLength) + { + evaluated = new boolean[codeLength]; + stackSizes = new int[codeLength]; + } + else + { + for (int index = 0; index < codeLength; index++) + { + evaluated[index] = false; + } + } + + // The initial stack is always empty. + stackSize = 0; + maxStackSize = 0; + + // Evaluate the instruction block starting at the entry point of the method. + evaluateInstructionBlock(clazz, method, codeAttribute, 0); + + // Evaluate the exception handlers. + codeAttribute.exceptionsAccept(clazz, method, this); + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + byte opcode = simpleInstruction.opcode; + + // Some simple instructions exit from the current instruction block. + exitInstructionBlock = + opcode == InstructionConstants.OP_IRETURN || + opcode == InstructionConstants.OP_LRETURN || + opcode == InstructionConstants.OP_FRETURN || + opcode == InstructionConstants.OP_DRETURN || + opcode == InstructionConstants.OP_ARETURN || + opcode == InstructionConstants.OP_RETURN || + opcode == InstructionConstants.OP_ATHROW; + } + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Constant pool instructions never end the current instruction block. + exitInstructionBlock = false; + } + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + byte opcode = variableInstruction.opcode; + + // The ret instruction end the current instruction block. + exitInstructionBlock = + opcode == InstructionConstants.OP_RET; + } + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + byte opcode = branchInstruction.opcode; + + // Evaluate the target instruction blocks. + evaluateInstructionBlock(clazz, + method, + codeAttribute, + offset + + branchInstruction.branchOffset); + + // Evaluate the instructions after a subroutine branch. + if (opcode == InstructionConstants.OP_JSR || + opcode == InstructionConstants.OP_JSR_W) + { + // We assume subroutine calls (jsr and jsr_w instructions) don't + // change the stack, other than popping the return value. + stackSize -= 1; + + evaluateInstructionBlock(clazz, + method, + codeAttribute, + offset + branchInstruction.length(offset)); + } + + // Some branch instructions always end the current instruction block. + exitInstructionBlock = + opcode == InstructionConstants.OP_GOTO || + opcode == InstructionConstants.OP_GOTO_W || + opcode == InstructionConstants.OP_JSR || + opcode == InstructionConstants.OP_JSR_W; + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + // Evaluate the target instruction blocks. + + // Loop over all jump offsets. + int[] jumpOffsets = switchInstruction.jumpOffsets; + + for (int index = 0; index < jumpOffsets.length; index++) + { + // Evaluate the jump instruction block. + evaluateInstructionBlock(clazz, + method, + codeAttribute, + offset + jumpOffsets[index]); + } + + // Also evaluate the default instruction block. + evaluateInstructionBlock(clazz, + method, + codeAttribute, + offset + switchInstruction.defaultOffset); + + // The switch instruction always ends the current instruction block. + exitInstructionBlock = true; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + if (DEBUG) + { + System.out.println("Exception:"); + } + + // The stack size when entering the exception handler is always 1. + stackSize = 1; + + // Evaluate the instruction block starting at the entry point of the + // exception handler. + evaluateInstructionBlock(clazz, + method, + codeAttribute, + exceptionInfo.u2handlerPC); + } + + + // Small utility methods. + + /** + * Evaluates a block of instructions that hasn't been handled before, + * starting at the given offset and ending at a branch instruction, a return + * instruction, or a throw instruction. Branch instructions are handled + * recursively. + */ + private void evaluateInstructionBlock(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int instructionOffset) + { + if (DEBUG) + { + if (evaluated[instructionOffset]) + { + System.out.println("-- (instruction block at "+instructionOffset+" already evaluated)"); + } + else + { + System.out.println("-- instruction block:"); + } + } + + // Remember the initial stack size. + int initialStackSize = stackSize; + + // Remember the maximum stack size. + if (maxStackSize < stackSize) + { + maxStackSize = stackSize; + } + + // Evaluate any instructions that haven't been evaluated before. + while (!evaluated[instructionOffset]) + { + // Mark the instruction as evaluated. + evaluated[instructionOffset] = true; + + Instruction instruction = InstructionFactory.create(codeAttribute.code, + instructionOffset); + + if (DEBUG) + { + int stackPushCount = instruction.stackPushCount(clazz); + int stackPopCount = instruction.stackPopCount(clazz); + System.out.println("["+instructionOffset+"]: "+ + stackSize+" - "+ + stackPopCount+" + "+ + stackPushCount+" = "+ + (stackSize+stackPushCount-stackPopCount)+": "+ + instruction.toString(instructionOffset)); + } + + // Compute the instruction's effect on the stack size. + stackSize -= instruction.stackPopCount(clazz); + + if (stackSize < 0) + { + throw new IllegalArgumentException("Stack size becomes negative after instruction "+ + instruction.toString(instructionOffset)+" in ["+ + clazz.getName()+"."+ + method.getName(clazz)+ + method.getDescriptor(clazz)+"]"); + } + + stackSizes[instructionOffset] = + stackSize += instruction.stackPushCount(clazz); + + // Remember the maximum stack size. + if (maxStackSize < stackSize) + { + maxStackSize = stackSize; + } + + // Remember the next instruction offset. + int nextInstructionOffset = instructionOffset + + instruction.length(instructionOffset); + + // Visit the instruction, in order to handle branches. + instruction.accept(clazz, method, codeAttribute, instructionOffset, this); + + // Stop evaluating after a branch. + if (exitInstructionBlock) + { + break; + } + + // Continue with the next instruction. + instructionOffset = nextInstructionOffset; + + if (DEBUG) + { + if (evaluated[instructionOffset]) + { + System.out.println("-- (instruction at "+instructionOffset+" already evaluated)"); + } + } + } + + // Restore the stack size for possible subsequent instruction blocks. + this.stackSize = initialStackSize; + } +} diff --git a/src/proguard/classfile/attribute/visitor/package.html b/src/proguard/classfile/attribute/visitor/package.html new file mode 100644 index 0000000..056244a --- /dev/null +++ b/src/proguard/classfile/attribute/visitor/package.html @@ -0,0 +1,3 @@ + +This package contains visitors for attributes and their components. + diff --git a/src/proguard/classfile/constant/ClassConstant.java b/src/proguard/classfile/constant/ClassConstant.java new file mode 100644 index 0000000..d217bf6 --- /dev/null +++ b/src/proguard/classfile/constant/ClassConstant.java @@ -0,0 +1,105 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This Constant represents a class constant in the constant pool. + * + * @author Eric Lafortune + */ +public class ClassConstant extends Constant +{ + public int u2nameIndex; + + /** + * An extra field pointing to the referenced Clazz object. + * This field is filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer ClassReferenceInitializer}. + */ + public Clazz referencedClass; + + /** + * An extra field pointing to the java.lang.Class Clazz object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}.. + */ + public Clazz javaLangClassClass; + + + /** + * Creates an uninitialized ClassConstant. + */ + public ClassConstant() + { + } + + + /** + * Creates a new ClassConstant with the given name index. + * @param u2nameIndex the index of the name in the constant pool. + * @param referencedClass the referenced class. + */ + public ClassConstant(int u2nameIndex, + Clazz referencedClass) + { + this.u2nameIndex = u2nameIndex; + this.referencedClass = referencedClass; + } + + + /** + * Returns the name. + */ + public String getName(Clazz clazz) + { + return clazz.getString(u2nameIndex); + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Class; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitClassConstant(clazz, this); + } + + + /** + * Lets the referenced class accept the given visitor. + */ + public void referencedClassAccept(ClassVisitor classVisitor) + { + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } +} diff --git a/src/proguard/classfile/constant/Constant.java b/src/proguard/classfile/constant/Constant.java new file mode 100644 index 0000000..30ce5df --- /dev/null +++ b/src/proguard/classfile/constant/Constant.java @@ -0,0 +1,68 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This abstract class represents an entry in the ConstantPool. Specific types + * of entries are subclassed from it. + * + * @author Eric Lafortune + */ +public abstract class Constant implements VisitorAccepter +{ + //public int u1tag; + //public byte info[]; + + /** + * An extra field in which visitors can store information. + */ + public Object visitorInfo; + + + // Abstract methods to be implemented by extensions. + + /** + * Returns the constant pool info tag that specifies the entry type. + */ + public abstract int getTag(); + + + /** + * Accepts the given visitor. + */ + public abstract void accept(Clazz clazz, ConstantVisitor constantVisitor); + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return visitorInfo; + } + + public void setVisitorInfo(Object visitorInfo) + { + this.visitorInfo = visitorInfo; + } +} diff --git a/src/proguard/classfile/constant/DoubleConstant.java b/src/proguard/classfile/constant/DoubleConstant.java new file mode 100644 index 0000000..61779b5 --- /dev/null +++ b/src/proguard/classfile/constant/DoubleConstant.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a double constant in the constant pool. + * + * @author Eric Lafortune + */ +public class DoubleConstant extends Constant +{ + public double f8value; + + + /** + * Creates an uninitialized DoubleConstant. + */ + public DoubleConstant() + { + } + + + /** + * Creates a new DoubleConstant with the given double value. + */ + public DoubleConstant(double value) + { + f8value = value; + } + + + /** + * Returns the double value of this DoubleConstant. + */ + public double getValue() + { + return f8value; + } + + + /** + * Sets the double value of this DoubleConstant. + */ + public void setValue(double value) + { + f8value = value; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Double; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitDoubleConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/FieldrefConstant.java b/src/proguard/classfile/constant/FieldrefConstant.java new file mode 100644 index 0000000..d4afce5 --- /dev/null +++ b/src/proguard/classfile/constant/FieldrefConstant.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a field reference constant in the constant pool. + * + * @author Eric Lafortune + */ +public class FieldrefConstant extends RefConstant +{ + /** + * Creates an uninitialized FieldrefConstant. + */ + public FieldrefConstant() + { + } + + + /** + * Creates a new FieldrefConstant with the given name and type indices. + * @param u2classIndex the index of the class in the constant pool. + * @param u2nameAndTypeIndex the index of the name and type entry in the constant pool. + * @param referencedClass the referenced class. + * @param referencedMember the referenced member info. + */ + public FieldrefConstant(int u2classIndex, + int u2nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + this.u2classIndex = u2classIndex; + this.u2nameAndTypeIndex = u2nameAndTypeIndex; + this.referencedClass = referencedClass; + this.referencedMember = referencedMember; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Fieldref; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitFieldrefConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/FloatConstant.java b/src/proguard/classfile/constant/FloatConstant.java new file mode 100644 index 0000000..578f567 --- /dev/null +++ b/src/proguard/classfile/constant/FloatConstant.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a float constant in the constant pool. + * + * @author Eric Lafortune + */ +public class FloatConstant extends Constant +{ + public float f4value; + + + /** + * Creates an uninitialized FloatConstant. + */ + public FloatConstant() + { + } + + + /** + * Creates a new FloatConstant with the given float value. + */ + public FloatConstant(float value) + { + f4value = value; + } + + + /** + * Returns the float value of this FloatConstant. + */ + public float getValue() + { + return f4value; + } + + + /** + * Sets the float value of this FloatConstant. + */ + public void setValue(float value) + { + f4value = value; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Float; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitFloatConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/IntegerConstant.java b/src/proguard/classfile/constant/IntegerConstant.java new file mode 100644 index 0000000..8a476c6 --- /dev/null +++ b/src/proguard/classfile/constant/IntegerConstant.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a integer constant in the constant pool. + * + * @author Eric Lafortune + */ +public class IntegerConstant extends Constant +{ + public int u4value; + + + /** + * Creates an uninitialized IntegerConstant. + */ + public IntegerConstant() + { + } + + + /** + * Creates a new IntegerConstant with the given integer value. + */ + public IntegerConstant(int value) + { + u4value = value; + } + + + /** + * Returns the integer value of this IntegerConstant. + */ + public int getValue() + { + return u4value; + } + + + /** + * Sets the integer value of this IntegerConstant. + */ + public void setValue(int value) + { + u4value = value; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Integer; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitIntegerConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/InterfaceMethodrefConstant.java b/src/proguard/classfile/constant/InterfaceMethodrefConstant.java new file mode 100644 index 0000000..ddee42f --- /dev/null +++ b/src/proguard/classfile/constant/InterfaceMethodrefConstant.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a interface method reference constant in the constant pool. + * + * @author Eric Lafortune + */ +public class InterfaceMethodrefConstant extends RefConstant +{ + /** + * Creates an uninitialized InterfaceMethodrefConstant. + */ + public InterfaceMethodrefConstant() + { + } + + + /** + * Creates a new InterfaceMethodrefConstant with the given name and type indices. + * @param u2classIndex the index of the class in the constant pool. + * @param u2nameAndTypeIndex the index of the name and type entry in the constant pool. + * @param referencedClass the referenced class. + * @param referencedMember the referenced member info. + */ + public InterfaceMethodrefConstant(int u2classIndex, + int u2nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + this.u2classIndex = u2classIndex; + this.u2nameAndTypeIndex = u2nameAndTypeIndex; + this.referencedClass = referencedClass; + this.referencedMember = referencedMember; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_InterfaceMethodref; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitInterfaceMethodrefConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/LongConstant.java b/src/proguard/classfile/constant/LongConstant.java new file mode 100644 index 0000000..ea66e07 --- /dev/null +++ b/src/proguard/classfile/constant/LongConstant.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a long constant in the constant pool. + * + * @author Eric Lafortune + */ +public class LongConstant extends Constant +{ + public long u8value; + + + /** + * Creates an uninitialized LongConstant. + */ + public LongConstant() + { + } + + + /** + * Creates a new LongConstant with the given long value. + */ + public LongConstant(long value) + { + u8value = value; + } + + + /** + * Returns the long value of this LongConstant. + */ + public long getValue() + { + return u8value; + } + + + /** + * Sets the long value of this LongConstant. + */ + public void setValue(long value) + { + u8value = value; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Long; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitLongConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/MethodrefConstant.java b/src/proguard/classfile/constant/MethodrefConstant.java new file mode 100644 index 0000000..858eec9 --- /dev/null +++ b/src/proguard/classfile/constant/MethodrefConstant.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a method reference constant in the constant pool. + * + * @author Eric Lafortune + */ +public class MethodrefConstant extends RefConstant +{ + /** + * Creates an uninitialized MethodrefConstant. + */ + public MethodrefConstant() + { + } + + + /** + * Creates a new MethodrefConstant with the given name and type indices. + * @param u2classIndex the index of the class in the constant pool. + * @param u2nameAndTypeIndex the index of the name and type entry in the constant pool. + * @param referencedClass the referenced class. + * @param referencedMember the referenced member info. + */ + public MethodrefConstant(int u2classIndex, + int u2nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + this.u2classIndex = u2classIndex; + this.u2nameAndTypeIndex = u2nameAndTypeIndex; + this.referencedClass = referencedClass; + this.referencedMember = referencedMember; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Methodref; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitMethodrefConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/NameAndTypeConstant.java b/src/proguard/classfile/constant/NameAndTypeConstant.java new file mode 100644 index 0000000..e83d2f1 --- /dev/null +++ b/src/proguard/classfile/constant/NameAndTypeConstant.java @@ -0,0 +1,119 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This Constant represents a name and type constant in the constant pool. + * + * @author Eric Lafortune + */ +public class NameAndTypeConstant extends Constant +{ + public int u2nameIndex; + public int u2descriptorIndex; + + + /** + * Creates an uninitialized NameAndTypeConstant. + */ + public NameAndTypeConstant() + { + } + + + /** + * Creates a new NameAndTypeConstant with the given name and type indices. + * @param u2nameIndex the index of the name in the constant pool. + * @param u2descriptorIndex the index of the descriptor in the constant + * pool. + */ + public NameAndTypeConstant(int u2nameIndex, + int u2descriptorIndex) + { + this.u2nameIndex = u2nameIndex; + this.u2descriptorIndex = u2descriptorIndex; + } + + + /** + * Returns the name index. + */ + protected int getNameIndex() + { + return u2nameIndex; + } + + /** + * Sets the name index. + */ + protected void setNameIndex(int index) + { + u2nameIndex = index; + } + + /** + * Returns the descriptor index. + */ + protected int getDescriptorIndex() + { + return u2descriptorIndex; + } + + /** + * Sets the descriptor index. + */ + protected void setDescriptorIndex(int index) + { + u2descriptorIndex = index; + } + + /** + * Returns the name. + */ + public String getName(Clazz clazz) + { + return clazz.getString(u2nameIndex); + } + + /** + * Returns the type. + */ + public String getType(Clazz clazz) + { + return clazz.getString(u2descriptorIndex); + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_NameAndType; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitNameAndTypeConstant(clazz, this); + } +} diff --git a/src/proguard/classfile/constant/RefConstant.java b/src/proguard/classfile/constant/RefConstant.java new file mode 100644 index 0000000..4e4d019 --- /dev/null +++ b/src/proguard/classfile/constant/RefConstant.java @@ -0,0 +1,130 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.visitor.*; + +/** + * This Constant represents a ref constant in the constant pool. + * + * @author Eric Lafortune + */ +public abstract class RefConstant extends Constant +{ + public int u2classIndex; + public int u2nameAndTypeIndex; + + /** + * An extra field pointing to the referenced Clazz object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + */ + public Clazz referencedClass; + + /** + * An extra field optionally pointing to the referenced Member object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}. + */ + public Member referencedMember; + + + protected RefConstant() + { + } + + + /** + * Returns the class index. + */ + public int getClassIndex() + { + return u2classIndex; + } + + /** + * Returns the name-and-type index. + */ + public int getNameAndTypeIndex() + { + return u2nameAndTypeIndex; + } + + /** + * Sets the name-and-type index. + */ + public void setNameAndTypeIndex(int index) + { + u2nameAndTypeIndex = index; + } + + /** + * Returns the class name. + */ + public String getClassName(Clazz clazz) + { + return clazz.getClassName(u2classIndex); + } + + /** + * Returns the method/field name. + */ + public String getName(Clazz clazz) + { + return clazz.getName(u2nameAndTypeIndex); + } + + /** + * Returns the type. + */ + public String getType(Clazz clazz) + { + return clazz.getType(u2nameAndTypeIndex); + } + + + /** + * Lets the referenced class accept the given visitor. + */ + public void referencedClassAccept(ClassVisitor classVisitor) + { + if (referencedClass != null) + { + referencedClass.accept(classVisitor); + } + } + + + /** + * Lets the referenced class member accept the given visitor. + */ + public void referencedMemberAccept(MemberVisitor memberVisitor) + { + if (referencedMember != null) + { + referencedMember.accept(referencedClass, + memberVisitor); + } + } +} diff --git a/src/proguard/classfile/constant/StringConstant.java b/src/proguard/classfile/constant/StringConstant.java new file mode 100644 index 0000000..9a8d453 --- /dev/null +++ b/src/proguard/classfile/constant/StringConstant.java @@ -0,0 +1,135 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.visitor.*; + +/** + * This Constant represents a string constant in the constant pool. + * + * @author Eric Lafortune + */ +public class StringConstant extends Constant +{ + public int u2stringIndex; + + /** + * An extra field pointing to the referenced Clazz object, if this + * string is being used in Class.forName(), .class, or + * Class.getDeclaredField/Method constructs. + * This field is typically filled out by the {@link + * proguard.classfile.util.DynamicClassReferenceInitializer + * DynamicClassReferenceInitializer} or by the {@link + * proguard.classfile.util.DynamicMemberReferenceInitializer + * DynamicMemberReferenceInitializer}. + */ + public Clazz referencedClass; + + /** + * An extra field pointing to the referenced Member object, if this + * string is being used in Class.getDeclaredField/Method constructs. + * This field is typically filled out by the {@link + * proguard.classfile.util.DynamicMemberReferenceInitializer + * DynamicMemberReferenceInitializer}. + */ + public Member referencedMember; + + /** + * An extra field pointing to the java.lang.String Clazz object. + * This field is typically filled out by the {@link + * proguard.classfile.util.ClassReferenceInitializer + * ClassReferenceInitializer}.. + */ + public Clazz javaLangStringClass; + + + /** + * Creates an uninitialized StringConstant. + */ + public StringConstant() + { + } + + + /** + * Creates a new StringConstant with the given string index. + * @param u2stringIndex the index of the string in the constant pool. + * @param referencedClass the referenced class, if any. + * @param referenceMember the referenced class member, if any. + */ + public StringConstant(int u2stringIndex, + Clazz referencedClass, + Member referenceMember) + { + this.u2stringIndex = u2stringIndex; + this.referencedClass = referencedClass; + this.referencedMember = referenceMember; + } + + + /** + * Returns the string value. + */ + public String getString(Clazz clazz) + { + return clazz.getString(u2stringIndex); + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_String; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitStringConstant(clazz, this); + } + + + /** + * Lets the referenced class accept the given visitor. + */ + public void referencedClassAccept(ClassVisitor classVisitor) + { + if (referencedClass != null && + referencedMember == null) + { + referencedClass.accept(classVisitor); + } + } + + + /** + * Lets the referenced member accept the given visitor. + */ + public void referencedMemberAccept(MemberVisitor memberVisitor) + { + if (referencedMember != null) + { + referencedMember.accept(referencedClass, memberVisitor); + } + } +} diff --git a/src/proguard/classfile/constant/Utf8Constant.java b/src/proguard/classfile/constant/Utf8Constant.java new file mode 100644 index 0000000..ae419c9 --- /dev/null +++ b/src/proguard/classfile/constant/Utf8Constant.java @@ -0,0 +1,285 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +import java.io.UnsupportedEncodingException; + +/** + * This Constant represents a UTF-8 constant in the constant pool. + * + * @author Eric Lafortune + */ +public class Utf8Constant extends Constant +{ + private static final char TWO_BYTE_LIMIT = 0x80; + private static final int TWO_BYTE_CONSTANT1 = 0xc0; + private static final int TWO_BYTE_CONSTANT2 = 0x80; + private static final int TWO_BYTE_SHIFT1 = 6; + private static final int TWO_BYTE_MASK1 = 0x1f; + private static final int TWO_BYTE_MASK2 = 0x3f; + + private static final char THREE_BYTE_LIMIT = 0x800; + private static final int THREE_BYTE_CONSTANT1 = 0xe0; + private static final int THREE_BYTE_CONSTANT2 = 0x80; + private static final int THREE_BYTE_CONSTANT3 = 0x80; + private static final int THREE_BYTE_SHIFT1 = 12; + private static final int THREE_BYTE_SHIFT2 = 6; + private static final int THREE_BYTE_MASK1 = 0x0f; + private static final int THREE_BYTE_MASK2 = 0x3f; + private static final int THREE_BYTE_MASK3 = 0x3f; + + + // There are a lot of Utf8Constant objects, so we're optimising their storage. + // Initially, we're storing the UTF-8 bytes in a byte array. + // When the corresponding String is requested, we ditch the array and just + // store the String. + + //private int u2length; + private byte[] bytes; + + private String string; + + + /** + * Creates an uninitialized Utf8Constant. + * + */ + public Utf8Constant() + { + } + + + /** + * Creates a Utf8Constant containing the given string. + */ + public Utf8Constant(String string) + { + this.bytes = null; + this.string = string; + } + + + /** + * Initializes the UTF-8 data with an array of bytes. + */ + public void setBytes(byte[] bytes) + { + this.bytes = bytes; + this.string = null; + } + + + /** + * Returns the UTF-8 data as an array of bytes. + */ + public byte[] getBytes() + { + try + { + switchToByteArrayRepresentation(); + } + catch (UnsupportedEncodingException ex) + { + throw new RuntimeException(ex.getMessage()); + } + + return bytes; + } + + + /** + * Initializes the UTF-8 data with a String. + */ + public void setString(String utf8String) + { + this.bytes = null; + this.string = utf8String; + } + + + /** + * Returns the UTF-8 data as a String. + */ + public String getString() + { + try + { + switchToStringRepresentation(); + } + catch (UnsupportedEncodingException ex) + { + throw new RuntimeException(ex.getMessage()); + } + + return string; + } + + + // Implementations for Constant. + + public int getTag() + { + return ClassConstants.CONSTANT_Utf8; + } + + public void accept(Clazz clazz, ConstantVisitor constantVisitor) + { + constantVisitor.visitUtf8Constant(clazz, this); + } + + + // Small utility methods. + + /** + * Switches to a byte array representation of the UTF-8 data. + */ + private void switchToByteArrayRepresentation() throws UnsupportedEncodingException + { + if (bytes == null) + { + bytes = getByteArrayRepresentation(string); + string = null; + } + } + + + /** + * Switches to a String representation of the UTF-8 data. + */ + private void switchToStringRepresentation() throws UnsupportedEncodingException + { + if (string == null) + { + string = getStringRepresentation(bytes); + bytes = null; + } + } + + + /** + * Returns the modified UTF-8 byte array representation of the given string. + */ + private byte[] getByteArrayRepresentation(String string) throws UnsupportedEncodingException + { + // We're computing the byte array ourselves, because the implementation + // of String.getBytes("UTF-8") has a bug, at least up to JRE 1.4.2. + // Also note the special treatment of the 0 character. + + // Compute the byte array length. + int byteLength = 0; + int stringLength = string.length(); + for (int stringIndex = 0; stringIndex < stringLength; stringIndex++) + { + char c = string.charAt(stringIndex); + + // The character is represented by one, two, or three bytes. + byteLength += c == 0 ? 2 : + c < TWO_BYTE_LIMIT ? 1 : + c < THREE_BYTE_LIMIT ? 2 : + 3; + } + + // Allocate the byte array with the computed length. + byte[] bytes = new byte[byteLength]; + + // Fill out the array. + int byteIndex = 0; + for (int stringIndex = 0; stringIndex < stringLength; stringIndex++) + { + char c = string.charAt(stringIndex); + if (c == 0) + { + // The 0 character gets a two-byte representation in classes. + bytes[byteIndex++] = (byte)TWO_BYTE_CONSTANT1; + bytes[byteIndex++] = (byte)TWO_BYTE_CONSTANT2; + } + else if (c < TWO_BYTE_LIMIT) + { + // The character is represented by a single byte. + bytes[byteIndex++] = (byte)c; + } + else if (c < THREE_BYTE_LIMIT) + { + // The character is represented by two bytes. + bytes[byteIndex++] = (byte)(TWO_BYTE_CONSTANT1 | ((c >>> TWO_BYTE_SHIFT1) & TWO_BYTE_MASK1)); + bytes[byteIndex++] = (byte)(TWO_BYTE_CONSTANT2 | ( c & TWO_BYTE_MASK2)); + } + else + { + // The character is represented by three bytes. + bytes[byteIndex++] = (byte)(THREE_BYTE_CONSTANT1 | ((c >>> THREE_BYTE_SHIFT1) & THREE_BYTE_MASK1)); + bytes[byteIndex++] = (byte)(THREE_BYTE_CONSTANT2 | ((c >>> THREE_BYTE_SHIFT2) & THREE_BYTE_MASK2)); + bytes[byteIndex++] = (byte)(THREE_BYTE_CONSTANT3 | ( c & THREE_BYTE_MASK3)); + } + } + + return bytes; + } + + + /** + * Returns the String representation of the given modified UTF-8 byte array. + */ + private String getStringRepresentation(byte[] bytes) throws UnsupportedEncodingException + { + // We're computing the string ourselves, because the implementation + // of "new String(bytes)" doesn't honor the special treatment of + // the 0 character in JRE 1.6_u11. + + // Allocate the byte array with the computed length. + char[] chars = new char[bytes.length]; + + // Fill out the array. + int charIndex = 0; + int byteIndex = 0; + while (byteIndex < bytes.length) + { + + int b = bytes[byteIndex++] & 0xff; + + // Depending on the flag bits in the first byte, the character + // is represented by a single byte, by two bytes, or by three + // bytes. We're not checking the redundant flag bits in the + // second byte and the third byte. + try + { + chars[charIndex++] = + (char)(b < TWO_BYTE_CONSTANT1 ? b : + + b < THREE_BYTE_CONSTANT1 ? ((b & TWO_BYTE_MASK1) << TWO_BYTE_SHIFT1) | + ((bytes[byteIndex++] & TWO_BYTE_MASK2) ) : + + ((b & THREE_BYTE_MASK1) << THREE_BYTE_SHIFT1) | + ((bytes[byteIndex++] & THREE_BYTE_MASK2) << THREE_BYTE_SHIFT2) | + ((bytes[byteIndex++] & THREE_BYTE_MASK3) )); + } + catch (ArrayIndexOutOfBoundsException e) + { + throw new UnsupportedEncodingException("Missing UTF-8 bytes after initial byte [0x"+Integer.toHexString(b)+"] in string ["+new String(chars, 0, charIndex)+"]"); + } + } + + return new String(chars, 0, charIndex); + } +} diff --git a/src/proguard/classfile/constant/visitor/AllConstantVisitor.java b/src/proguard/classfile/constant/visitor/AllConstantVisitor.java new file mode 100644 index 0000000..d2d3c2c --- /dev/null +++ b/src/proguard/classfile/constant/visitor/AllConstantVisitor.java @@ -0,0 +1,53 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant.visitor; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + + +/** + * This ClassVisitor lets a given ConstantVisitor visit all constant pool + * entries of the program classes it visits. + * + * @author Eric Lafortune + */ +public class AllConstantVisitor implements ClassVisitor +{ + private final ConstantVisitor constantVisitor; + + + public AllConstantVisitor(ConstantVisitor constantVisitor) + { + this.constantVisitor = constantVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.constantPoolEntriesAccept(constantVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) {} +} diff --git a/src/proguard/classfile/constant/visitor/ConstantVisitor.java b/src/proguard/classfile/constant/visitor/ConstantVisitor.java new file mode 100644 index 0000000..6cae352 --- /dev/null +++ b/src/proguard/classfile/constant/visitor/ConstantVisitor.java @@ -0,0 +1,46 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.constant.*; + + +/** + * This interface specifies the methods for a visitor of Constant + * objects. + * + * @author Eric Lafortune + */ +public interface ConstantVisitor +{ + public void visitIntegerConstant( Clazz clazz, IntegerConstant integerConstant); + public void visitLongConstant( Clazz clazz, LongConstant longConstant); + public void visitFloatConstant( Clazz clazz, FloatConstant floatConstant); + public void visitDoubleConstant( Clazz clazz, DoubleConstant doubleConstant); + public void visitStringConstant( Clazz clazz, StringConstant stringConstant); + public void visitUtf8Constant( Clazz clazz, Utf8Constant utf8Constant); + public void visitFieldrefConstant( Clazz clazz, FieldrefConstant fieldrefConstant); + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant); + public void visitMethodrefConstant( Clazz clazz, MethodrefConstant methodrefConstant); + public void visitClassConstant( Clazz clazz, ClassConstant classConstant); + public void visitNameAndTypeConstant( Clazz clazz, NameAndTypeConstant nameAndTypeConstant); +} diff --git a/src/proguard/classfile/constant/visitor/ExceptClassConstantFilter.java b/src/proguard/classfile/constant/visitor/ExceptClassConstantFilter.java new file mode 100644 index 0000000..fbb3e52 --- /dev/null +++ b/src/proguard/classfile/constant/visitor/ExceptClassConstantFilter.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.constant.visitor; + +import proguard.classfile.*; +import proguard.classfile.editor.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor delegates its visits to class constants + * to another given ConstantVisitor, except for one given class. + * + * @author Eric Lafortune + */ +public class ExceptClassConstantFilter +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final String exceptClassName; + private final ConstantVisitor constantVisitor; + + + /** + * Creates a new ClassNameFilter. + * @param exceptClassName the name of the class that will not be visited. + * @param constantVisitor the ConstantVisitor to which visits + * will be delegated. + */ + public ExceptClassConstantFilter(String exceptClassName, + ConstantVisitor constantVisitor) + { + this.exceptClassName = exceptClassName; + this.constantVisitor = constantVisitor; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + if (!classConstant.getName(clazz).equals(exceptClassName)) + { + constantVisitor.visitClassConstant(clazz, classConstant); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/constant/visitor/package.html b/src/proguard/classfile/constant/visitor/package.html new file mode 100644 index 0000000..e20f48e --- /dev/null +++ b/src/proguard/classfile/constant/visitor/package.html @@ -0,0 +1,3 @@ + +This package contains visitors for class constants. + diff --git a/src/proguard/classfile/editor/AccessFixer.java b/src/proguard/classfile/editor/AccessFixer.java new file mode 100644 index 0000000..7d6274e --- /dev/null +++ b/src/proguard/classfile/editor/AccessFixer.java @@ -0,0 +1,164 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This ConstantVisitor fixes the access modifiers of all classes and class + * members that are referenced by the constants that it visits. + * + * @author Eric Lafortune + */ +public class AccessFixer +extends SimplifiedVisitor +implements ConstantVisitor, + ClassVisitor, + MemberVisitor +{ + private MyReferencedClassFinder referencedClassFinder = new MyReferencedClassFinder(); + + private Clazz referencingClass; + private Clazz referencedClass; + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + referencingClass = clazz; + referencedClass = stringConstant.referencedClass; + + // Make sure the access flags of the referenced class or class member, + // if any, are acceptable. + stringConstant.referencedClassAccept(this); + stringConstant.referencedMemberAccept(this); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + referencingClass = clazz; + + // Remember the specified class, since it might be different from + // the referenced class that acutally contains the class member. + clazz.constantPoolEntryAccept(refConstant.u2classIndex, referencedClassFinder); + + // Make sure the access flags of the referenced class member are + // acceptable. + refConstant.referencedMemberAccept(this); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + referencingClass = clazz; + + // Make sure the access flags of the referenced class are acceptable. + classConstant.referencedClassAccept(this); + } + + + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) {} + + + public void visitProgramClass(ProgramClass programClass) + { + int currentAccessFlags = programClass.getAccessFlags(); + int currentAccessLevel = AccessUtil.accessLevel(currentAccessFlags); + + // Compute the required access level. + Clazz referencingClass = this.referencingClass; + int requiredAccessLevel = + inSamePackage(programClass, referencingClass) ? AccessUtil.PACKAGE_VISIBLE : + AccessUtil.PUBLIC; + + // Fix the class access flags if necessary. + if (currentAccessLevel < requiredAccessLevel) + { + programClass.u2accessFlags = + AccessUtil.replaceAccessFlags(currentAccessFlags, + AccessUtil.accessFlags(requiredAccessLevel)); + } + } + + + // Implementations for MemberVisitor. + + public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) {} + + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + int currentAccessFlags = programMember.getAccessFlags(); + int currentAccessLevel = AccessUtil.accessLevel(currentAccessFlags); + + // Compute the required access level. + int requiredAccessLevel = + programClass.equals(referencingClass) ? AccessUtil.PRIVATE : + inSamePackage(programClass, referencingClass) ? AccessUtil.PACKAGE_VISIBLE : + referencedClass.extends_(referencingClass) && + referencingClass.extends_(programClass) ? AccessUtil.PROTECTED : + AccessUtil.PUBLIC; + + // Fix the class member access flags if necessary. + if (currentAccessLevel < requiredAccessLevel) + { + programMember.u2accessFlags = + AccessUtil.replaceAccessFlags(currentAccessFlags, + AccessUtil.accessFlags(requiredAccessLevel)); + } + } + + + /** + * This ConstantVisitor returns the referenced class of the class constant + * that it visits. + */ + private class MyReferencedClassFinder + extends SimplifiedVisitor + implements ConstantVisitor + { + // Implementations for ConstantVisitor. + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + referencedClass = classConstant.referencedClass; + } + } + + + // Small utility methods. + + private boolean inSamePackage(ProgramClass class1, Clazz class2) + { + return ClassUtil.internalPackageName(class1.getName()).equals( + ClassUtil.internalPackageName(class2.getName())); + } +} diff --git a/src/proguard/classfile/editor/AnnotationAdder.java b/src/proguard/classfile/editor/AnnotationAdder.java new file mode 100644 index 0000000..359164a --- /dev/null +++ b/src/proguard/classfile/editor/AnnotationAdder.java @@ -0,0 +1,153 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.AnnotationVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AnnotationVisitor adds all annotations that it visits to the given + * target annotation element value, target annotation attribute, or target + * parameter annotation attribute. + * + * @author Eric Lafortune + */ +public class AnnotationAdder +extends SimplifiedVisitor +implements AnnotationVisitor +{ + private static final ElementValue[] EMPTY_ELEMENT_VALUES = new ElementValue[0]; + + + private final ProgramClass targetClass; + private final AnnotationElementValue targetAnnotationElementValue; + private final AnnotationsAttributeEditor annotationsAttributeEditor; + private final ParameterAnnotationsAttributeEditor parameterAnnotationsAttributeEditor; + + private final ConstantAdder constantAdder; + + + /** + * Creates a new AnnotationAdder that will copy annotations into the given + * target annotation element value. + */ + public AnnotationAdder(ProgramClass targetClass, + AnnotationElementValue targetAnnotationElementValue) + { + this.targetClass = targetClass; + this.targetAnnotationElementValue = targetAnnotationElementValue; + this.annotationsAttributeEditor = null; + this.parameterAnnotationsAttributeEditor = null; + + constantAdder = new ConstantAdder(targetClass); + } + + + /** + * Creates a new AnnotationAdder that will copy annotations into the given + * target annotations attribute. + */ + public AnnotationAdder(ProgramClass targetClass, + AnnotationsAttribute targetAnnotationsAttribute) + { + this.targetClass = targetClass; + this.targetAnnotationElementValue = null; + this.annotationsAttributeEditor = new AnnotationsAttributeEditor(targetAnnotationsAttribute); + this.parameterAnnotationsAttributeEditor = null; + + constantAdder = new ConstantAdder(targetClass); + } + + + /** + * Creates a new AnnotationAdder that will copy annotations into the given + * target parameter annotations attribute. + */ + public AnnotationAdder(ProgramClass targetClass, + ParameterAnnotationsAttribute targetParameterAnnotationsAttribute) + { + this.targetClass = targetClass; + this.targetAnnotationElementValue = null; + this.annotationsAttributeEditor = null; + this.parameterAnnotationsAttributeEditor = new ParameterAnnotationsAttributeEditor(targetParameterAnnotationsAttribute); + + constantAdder = new ConstantAdder(targetClass); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + Annotation newAnnotation = + new Annotation(constantAdder.addConstant(clazz, annotation.u2typeIndex), + 0, + annotation.u2elementValuesCount > 0 ? + new ElementValue[annotation.u2elementValuesCount] : + EMPTY_ELEMENT_VALUES); + + // TODO: Clone array. + newAnnotation.referencedClasses = annotation.referencedClasses; + + // Add the element values. + annotation.elementValuesAccept(clazz, + new ElementValueAdder(targetClass, + newAnnotation, + false)); + + // What's the target? + if (targetAnnotationElementValue != null) + { + // Simply set the completed annotation. + targetAnnotationElementValue.annotationValue = newAnnotation; + } + else + { + // Add the completed annotation. + annotationsAttributeEditor.addAnnotation(newAnnotation); + } + } + + + public void visitAnnotation(Clazz clazz, Method method, int parameterIndex, Annotation annotation) + { + Annotation newAnnotation = + new Annotation(constantAdder.addConstant(clazz, annotation.u2typeIndex), + 0, + annotation.u2elementValuesCount > 0 ? + new ElementValue[annotation.u2elementValuesCount] : + EMPTY_ELEMENT_VALUES); + + // TODO: Clone array. + newAnnotation.referencedClasses = annotation.referencedClasses; + + // Add the element values. + annotation.elementValuesAccept(clazz, + new ElementValueAdder(targetClass, + newAnnotation, + false)); + + // Add the completed annotation. + parameterAnnotationsAttributeEditor.addAnnotation(parameterIndex, newAnnotation); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/AnnotationsAttributeEditor.java b/src/proguard/classfile/editor/AnnotationsAttributeEditor.java new file mode 100644 index 0000000..bf8852c --- /dev/null +++ b/src/proguard/classfile/editor/AnnotationsAttributeEditor.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.annotation.*; + +/** + * This class can add annotations to a given annotations attribute. + * Annotations to be added must have been filled out beforehand. + * + * @author Eric Lafortune + */ +public class AnnotationsAttributeEditor +{ + private AnnotationsAttribute targetAnnotationsAttribute; + + + /** + * Creates a new AnnotationsAttributeEditor that will edit annotations in + * the given annotations attribute. + */ + public AnnotationsAttributeEditor(AnnotationsAttribute targetAnnotationsAttribute) + { + this.targetAnnotationsAttribute = targetAnnotationsAttribute; + } + + + /** + * Adds a given annotation to the annotations attribute. + */ + public void addAnnotation(Annotation annotation) + { + int annotationsCount = targetAnnotationsAttribute.u2annotationsCount; + Annotation[] annotations = targetAnnotationsAttribute.annotations; + + // Make sure there is enough space for the new annotation. + if (annotations.length <= annotationsCount) + { + targetAnnotationsAttribute.annotations = new Annotation[annotationsCount+1]; + System.arraycopy(annotations, 0, + targetAnnotationsAttribute.annotations, 0, + annotationsCount); + annotations = targetAnnotationsAttribute.annotations; + } + + // Add the annotation. + annotations[targetAnnotationsAttribute.u2annotationsCount++] = annotation; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/AttributeAdder.java b/src/proguard/classfile/editor/AttributeAdder.java new file mode 100644 index 0000000..2b610b7 --- /dev/null +++ b/src/proguard/classfile/editor/AttributeAdder.java @@ -0,0 +1,457 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor adds all attributes that it visits to the given + * target class, class member, or attribute. + * + * @author Eric Lafortune + */ +public class AttributeAdder +extends SimplifiedVisitor +implements AttributeVisitor +{ + private static final byte[] EMPTY_BYTES = new byte[0]; + private static final int[] EMPTY_INTS = new int[0]; + private static final Attribute[] EMPTY_ATTRIBUTES = new Attribute[0]; + private static final ExceptionInfo[] EMPTY_EXCEPTIONS = new ExceptionInfo[0]; + + + private final ProgramClass targetClass; + private final ProgramMember targetMember; + private final CodeAttribute targetCodeAttribute; + private final boolean replaceAttributes; + + private final ConstantAdder constantAdder; + private final AttributesEditor attributesEditor; + + + /** + * Creates a new AttributeAdder that will copy attributes into the given + * target class. + */ + public AttributeAdder(ProgramClass targetClass, + boolean replaceAttributes) + { + this(targetClass, null, null, replaceAttributes); + } + + + /** + * Creates a new AttributeAdder that will copy attributes into the given + * target class member. + */ + public AttributeAdder(ProgramClass targetClass, + ProgramMember targetMember, + boolean replaceAttributes) + { + this(targetClass, targetMember, null, replaceAttributes); + } + + + /** + * Creates a new AttributeAdder that will copy attributes into the given + * target attribute. + */ + public AttributeAdder(ProgramClass targetClass, + ProgramMember targetMember, + CodeAttribute targetCodeAttribute, + boolean replaceAttributes) + { + this.targetClass = targetClass; + this.targetMember = targetMember; + this.targetCodeAttribute = targetCodeAttribute; + this.replaceAttributes = replaceAttributes; + + constantAdder = new ConstantAdder(targetClass); + attributesEditor = new AttributesEditor(targetClass, + targetMember, + targetCodeAttribute, + replaceAttributes); + } + + + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + // Create a copy of the attribute. + UnknownAttribute newUnknownAttribute = + new UnknownAttribute(constantAdder.addConstant(clazz, unknownAttribute.u2attributeNameIndex), + unknownAttribute.u4attributeLength, + unknownAttribute.info); + + // Add it to the target class. + attributesEditor.addAttribute(newUnknownAttribute); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + // Create a copy of the attribute. + SourceFileAttribute newSourceFileAttribute = + new SourceFileAttribute(constantAdder.addConstant(clazz, sourceFileAttribute.u2attributeNameIndex), + constantAdder.addConstant(clazz, sourceFileAttribute.u2sourceFileIndex)); + + // Add it to the target class. + attributesEditor.addAttribute(newSourceFileAttribute); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + // Create a copy of the attribute. + SourceDirAttribute newSourceDirAttribute = + new SourceDirAttribute(constantAdder.addConstant(clazz, sourceDirAttribute.u2attributeNameIndex), + constantAdder.addConstant(clazz, sourceDirAttribute.u2sourceDirIndex)); + + // Add it to the target class. + attributesEditor.addAttribute(newSourceDirAttribute); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // TODO: Implement method. + // Note that the attribute may already be present. +// // Create a copy of the attribute. +// InnerClassesAttribute newInnerClassesAttribute = +// new InnerClassesAttribute(constantAdder.addConstant(clazz, innerClassesAttribute.u2attributeNameIndex), +// 0, +// null); +// +// // Add it to the target class. +// attributesEditor.addClassAttribute(newInnerClassesAttribute); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + // Create a copy of the attribute. + EnclosingMethodAttribute newEnclosingMethodAttribute = + new EnclosingMethodAttribute(constantAdder.addConstant(clazz, enclosingMethodAttribute.u2attributeNameIndex), + constantAdder.addConstant(clazz, enclosingMethodAttribute.u2classIndex), + enclosingMethodAttribute.u2nameAndTypeIndex == 0 ? 0 : + constantAdder.addConstant(clazz, enclosingMethodAttribute.u2nameAndTypeIndex)); + + newEnclosingMethodAttribute.referencedClass = enclosingMethodAttribute.referencedClass; + newEnclosingMethodAttribute.referencedMethod = enclosingMethodAttribute.referencedMethod; + + // Add it to the target class. + attributesEditor.addAttribute(newEnclosingMethodAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + // Create a copy of the attribute. + DeprecatedAttribute newDeprecatedAttribute = + new DeprecatedAttribute(constantAdder.addConstant(clazz, deprecatedAttribute.u2attributeNameIndex)); + + // Add it to the target. + attributesEditor.addAttribute(newDeprecatedAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + // Create a copy of the attribute. + SyntheticAttribute newSyntheticAttribute = + new SyntheticAttribute(constantAdder.addConstant(clazz, syntheticAttribute.u2attributeNameIndex)); + + // Add it to the target. + attributesEditor.addAttribute(newSyntheticAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + // Create a copy of the attribute. + SignatureAttribute newSignatureAttribute = + new SignatureAttribute(constantAdder.addConstant(clazz, signatureAttribute.u2attributeNameIndex), + constantAdder.addConstant(clazz, signatureAttribute.u2signatureIndex)); + + newSignatureAttribute.referencedClasses = signatureAttribute.referencedClasses; + + // Add it to the target. + attributesEditor.addAttribute(newSignatureAttribute); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + // Create a copy of the attribute. + ConstantValueAttribute newConstantValueAttribute = + new ConstantValueAttribute(constantAdder.addConstant(clazz, constantValueAttribute.u2attributeNameIndex), + constantAdder.addConstant(clazz, constantValueAttribute.u2constantValueIndex)); + + // Add it to the target field. + attributesEditor.addAttribute(newConstantValueAttribute); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + // Create a new exceptions attribute. + ExceptionsAttribute newExceptionsAttribute = + new ExceptionsAttribute(constantAdder.addConstant(clazz, exceptionsAttribute.u2attributeNameIndex), + 0, + exceptionsAttribute.u2exceptionIndexTableLength > 0 ? + new int[exceptionsAttribute.u2exceptionIndexTableLength] : + EMPTY_INTS); + + // Add the exceptions. + exceptionsAttribute.exceptionEntriesAccept((ProgramClass)clazz, + new ExceptionAdder(targetClass, + newExceptionsAttribute)); + + // Add it to the target method. + attributesEditor.addAttribute(newExceptionsAttribute); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Create a new code attribute. + CodeAttribute newCodeAttribute = + new CodeAttribute(constantAdder.addConstant(clazz, codeAttribute.u2attributeNameIndex), + codeAttribute.u2maxStack, + codeAttribute.u2maxLocals, + 0, + EMPTY_BYTES, + 0, + codeAttribute.u2exceptionTableLength > 0 ? + new ExceptionInfo[codeAttribute.u2exceptionTableLength] : + EMPTY_EXCEPTIONS, + 0, + codeAttribute.u2attributesCount > 0 ? + new Attribute[codeAttribute.u2attributesCount] : + EMPTY_ATTRIBUTES); + + CodeAttributeComposer codeAttributeComposer = new CodeAttributeComposer(); + + codeAttributeComposer.beginCodeFragment(codeAttribute.u4codeLength); + + // Add the instructions. + codeAttribute.instructionsAccept(clazz, + method, + new InstructionAdder(targetClass, + codeAttributeComposer)); + + // Append a label just after the code. + codeAttributeComposer.appendLabel(codeAttribute.u4codeLength); + + // Add the exceptions. + codeAttribute.exceptionsAccept(clazz, + method, + new ExceptionInfoAdder(targetClass, + codeAttributeComposer)); + + codeAttributeComposer.endCodeFragment(); + + // Add the attributes. + codeAttribute.attributesAccept(clazz, + method, + new AttributeAdder(targetClass, + targetMember, + newCodeAttribute, + replaceAttributes)); + + // Apply these changes to the new code attribute. + codeAttributeComposer.visitCodeAttribute(targetClass, + (Method)targetMember, + newCodeAttribute); + + // Add the completed code attribute to the target method. + attributesEditor.addAttribute(newCodeAttribute); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + // TODO: Implement method. + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + // TODO: Implement method. + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + // Create a new line number table attribute. + LineNumberTableAttribute newLineNumberTableAttribute = + new LineNumberTableAttribute(constantAdder.addConstant(clazz, lineNumberTableAttribute.u2attributeNameIndex), + 0, + new LineNumberInfo[lineNumberTableAttribute.u2lineNumberTableLength]); + + // Add the line numbers. + lineNumberTableAttribute.lineNumbersAccept(clazz, + method, + codeAttribute, + new LineNumberInfoAdder(newLineNumberTableAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newLineNumberTableAttribute); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Create a new local variable table attribute. + LocalVariableTableAttribute newLocalVariableTableAttribute = + new LocalVariableTableAttribute(constantAdder.addConstant(clazz, localVariableTableAttribute.u2attributeNameIndex), + 0, + new LocalVariableInfo[localVariableTableAttribute.u2localVariableTableLength]); + + // Add the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, + method, + codeAttribute, + new LocalVariableInfoAdder(targetClass, newLocalVariableTableAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newLocalVariableTableAttribute); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Create a new local variable type table attribute. + LocalVariableTypeTableAttribute newLocalVariableTypeTableAttribute = + new LocalVariableTypeTableAttribute(constantAdder.addConstant(clazz, localVariableTypeTableAttribute.u2attributeNameIndex), + 0, + new LocalVariableTypeInfo[localVariableTypeTableAttribute.u2localVariableTypeTableLength]); + + // Add the local variable types. + localVariableTypeTableAttribute.localVariablesAccept(clazz, + method, + codeAttribute, + new LocalVariableTypeInfoAdder(targetClass, newLocalVariableTypeTableAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newLocalVariableTypeTableAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + // Create a new annotations attribute. + RuntimeVisibleAnnotationsAttribute newAnnotationsAttribute = + new RuntimeVisibleAnnotationsAttribute(constantAdder.addConstant(clazz, runtimeVisibleAnnotationsAttribute.u2attributeNameIndex), + 0, + new Annotation[runtimeVisibleAnnotationsAttribute.u2annotationsCount]); + + // Add the annotations. + runtimeVisibleAnnotationsAttribute.annotationsAccept(clazz, + new AnnotationAdder(targetClass, + newAnnotationsAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + // Create a new annotations attribute. + RuntimeInvisibleAnnotationsAttribute newAnnotationsAttribute = + new RuntimeInvisibleAnnotationsAttribute(constantAdder.addConstant(clazz, runtimeInvisibleAnnotationsAttribute.u2attributeNameIndex), + 0, + new Annotation[runtimeInvisibleAnnotationsAttribute.u2annotationsCount]); + + // Add the annotations. + runtimeInvisibleAnnotationsAttribute.annotationsAccept(clazz, + new AnnotationAdder(targetClass, + newAnnotationsAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newAnnotationsAttribute); + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + // Create a new annotations attribute. + RuntimeVisibleParameterAnnotationsAttribute newParameterAnnotationsAttribute = + new RuntimeVisibleParameterAnnotationsAttribute(constantAdder.addConstant(clazz, runtimeVisibleParameterAnnotationsAttribute.u2attributeNameIndex), + 0, + new int[runtimeVisibleParameterAnnotationsAttribute.u2parametersCount], + new Annotation[runtimeVisibleParameterAnnotationsAttribute.u2parametersCount][]); + + // Add the annotations. + runtimeVisibleParameterAnnotationsAttribute.annotationsAccept(clazz, + method, + new AnnotationAdder(targetClass, + newParameterAnnotationsAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newParameterAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + // Create a new annotations attribute. + RuntimeInvisibleParameterAnnotationsAttribute newParameterAnnotationsAttribute = + new RuntimeInvisibleParameterAnnotationsAttribute(constantAdder.addConstant(clazz, runtimeInvisibleParameterAnnotationsAttribute.u2attributeNameIndex), + 0, + new int[runtimeInvisibleParameterAnnotationsAttribute.u2parametersCount], + new Annotation[runtimeInvisibleParameterAnnotationsAttribute.u2parametersCount][]); + + // Add the annotations. + runtimeInvisibleParameterAnnotationsAttribute.annotationsAccept(clazz, + method, + new AnnotationAdder(targetClass, + newParameterAnnotationsAttribute)); + + // Add it to the target. + attributesEditor.addAttribute(newParameterAnnotationsAttribute); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Create a new annotation default attribute. + AnnotationDefaultAttribute newAnnotationDefaultAttribute = + new AnnotationDefaultAttribute(constantAdder.addConstant(clazz, annotationDefaultAttribute.u2attributeNameIndex), + null); + + // Add the annotations. + annotationDefaultAttribute.defaultValueAccept(clazz, + new ElementValueAdder(targetClass, + newAnnotationDefaultAttribute, + false)); + + // Add it to the target. + attributesEditor.addAttribute(newAnnotationDefaultAttribute); + } +} diff --git a/src/proguard/classfile/editor/AttributeSorter.java b/src/proguard/classfile/editor/AttributeSorter.java new file mode 100644 index 0000000..d8e3367 --- /dev/null +++ b/src/proguard/classfile/editor/AttributeSorter.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +import java.util.*; + +/** + * This ClassVisitor sorts the attributes of the classes that it visits. + * The sorting order is based on the types of the attributes. + * + * @author Eric Lafortune + */ +public class AttributeSorter +extends SimplifiedVisitor +implements ClassVisitor, MemberVisitor, AttributeVisitor, Comparator +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Sort the attributes. + Arrays.sort(programClass.attributes, 0, programClass.u2attributesCount, this); + + // Sort the attributes of the class members. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + // Sort the attributes. + Arrays.sort(programMember.attributes, 0, programMember.u2attributesCount, this); + + // Sort the attributes of the attributes. + programMember.attributesAccept(programClass, this); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Sort the attributes. + Arrays.sort(codeAttribute.attributes, 0, codeAttribute.u2attributesCount, this); + } + + + // Implementations for Comparator. + + public int compare(Object object1, Object object2) + { + Attribute attribute1 = (Attribute)object1; + Attribute attribute2 = (Attribute)object2; + + return attribute1.u2attributeNameIndex < attribute2.u2attributeNameIndex ? -1 : + attribute1.u2attributeNameIndex > attribute2.u2attributeNameIndex ? 1 : + 0; + } +} diff --git a/src/proguard/classfile/editor/AttributesEditor.java b/src/proguard/classfile/editor/AttributesEditor.java new file mode 100644 index 0000000..10846cc --- /dev/null +++ b/src/proguard/classfile/editor/AttributesEditor.java @@ -0,0 +1,269 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; + +/** + * This class can add and delete attributes to and from classes, fields, + * methods, and code attributes. Attributes to be added must be filled out + * beforehand, including their references to the constant pool. Existing + * attributes of the same type are always replaced. + * + * @author Eric Lafortune + */ +public class AttributesEditor +{ + private final ProgramClass targetClass; + private final ProgramMember targetMember; + private final CodeAttribute targetAttribute; + private final boolean replaceAttributes; + + + /** + * Creates a new AttributeAdder that will edit attributes in the given + * target class. + */ + public AttributesEditor(ProgramClass targetClass, + boolean replaceAttributes) + { + this(targetClass, null, null, replaceAttributes); + } + + + /** + * Creates a new AttributeAdder that will edit attributes in the given + * target class member. + */ + public AttributesEditor(ProgramClass targetClass, + ProgramMember targetMember, + boolean replaceAttributes) + { + this(targetClass, targetMember, null, replaceAttributes); + } + + + /** + * Creates a new AttributeAdder that will edit attributes in the given + * target code attribute. + */ + public AttributesEditor(ProgramClass targetClass, + ProgramMember targetMember, + CodeAttribute targetAttribute, + boolean replaceAttributes) + { + this.targetClass = targetClass; + this.targetMember = targetMember; + this.targetAttribute = targetAttribute; + this.replaceAttributes = replaceAttributes; + } + + + /** + * Adds the given attribute to the target. + */ + public void addAttribute(Attribute attribute) + { + // What's the target? + if (targetAttribute != null) + { + // Try to replace an existing attribute. + if (!replaceAttributes || + !replaceAttribute(targetAttribute.u2attributesCount, + targetAttribute.attributes, + attribute)) + { + // Otherwise append the attribute. + targetAttribute.attributes = + addAttribute(targetAttribute.u2attributesCount, + targetAttribute.attributes, + attribute); + + targetAttribute.u2attributesCount++; + } + } + else if (targetMember != null) + { + // Try to replace an existing attribute. + if (!replaceAttributes || + !replaceAttribute(targetMember.u2attributesCount, + targetMember.attributes, + attribute)) + { + // Otherwise append the attribute. + targetMember.attributes = + addAttribute(targetMember.u2attributesCount, + targetMember.attributes, + attribute); + + targetMember.u2attributesCount++; + } + } + else + { + // Try to replace an existing attribute. + if (!replaceAttributes || + !replaceAttribute(targetClass.u2attributesCount, + targetClass.attributes, + attribute)) + { + // Otherwise append the attribute. + targetClass.attributes = + addAttribute(targetClass.u2attributesCount, + targetClass.attributes, + attribute); + + targetClass.u2attributesCount++; + } + } + } + + + /** + * Deletes the specified attribute from the target. + */ + public void deleteAttribute(String attributeName) + { + // What's the target? + if (targetAttribute != null) + { + targetAttribute.u2attributesCount = + deleteAttribute(targetAttribute.u2attributesCount, + targetAttribute.attributes, + attributeName); + } + else if (targetMember != null) + { + targetMember.u2attributesCount = + deleteAttribute(targetMember.u2attributesCount, + targetMember.attributes, + attributeName); + } + else + { + targetClass.u2attributesCount = + deleteAttribute(targetClass.u2attributesCount, + targetClass.attributes, + attributeName); + } + } + + + // Small utility methods. + + /** + * Tries put the given attribute in place of an existing attribute of the + * same name, returning whether it was present. + */ + private boolean replaceAttribute(int attributesCount, + Attribute[] attributes, + Attribute attribute) + { + // Find the attribute with the same name. + int index = findAttribute(attributesCount, + attributes, + attribute.getAttributeName(targetClass)); + if (index < 0) + { + return false; + } + + attributes[index] = attribute; + + return true; + } + + + /** + * Appends the given attribute to the given array of attributes, creating a + * new array if necessary. + */ + private Attribute[] addAttribute(int attributesCount, + Attribute[] attributes, + Attribute attribute) + { + // Is the array too small to contain the additional attribute? + if (attributes.length <= attributesCount) + { + // Create a new array and copy the attributes into it. + Attribute[] newAttributes = new Attribute[attributesCount + 1]; + System.arraycopy(attributes, 0, + newAttributes, 0, + attributesCount); + attributes = newAttributes; + } + + // Append the attribute. + attributes[attributesCount] = attribute; + + return attributes; + } + + + /** + * Deletes the attributes with the given name from the given array of + * attributes, returning the new number of attributes. + */ + private int deleteAttribute(int attributesCount, + Attribute[] attributes, + String attributeName) + { + // Find the attribute. + int index = findAttribute(attributesCount, + attributes, + attributeName); + if (index < 0) + { + return attributesCount; + } + + // Shift the other attributes in the array. + System.arraycopy(attributes, index + 1, + attributes, index, + attributesCount - index - 1); + + // Clear the last entry in the array. + attributes[--attributesCount] = null; + + return attributesCount; + } + + + /** + * Finds the index of the attribute with the given name in the given + * array of attributes. + */ + private int findAttribute(int attributesCount, + Attribute[] attributes, + String attributeName) + { + for (int index = 0; index < attributesCount; index++) + { + if (attributes[index].getAttributeName(targetClass).equals(attributeName)) + { + return index; + } + } + + return -1; + } +} diff --git a/src/proguard/classfile/editor/ClassEditor.java b/src/proguard/classfile/editor/ClassEditor.java new file mode 100644 index 0000000..e503ea3 --- /dev/null +++ b/src/proguard/classfile/editor/ClassEditor.java @@ -0,0 +1,255 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; + +/** + * This class can add interfaces and class members to a given class. + * Elements to be added must be filled out beforehand, including their + * references to the constant pool. + * + * @author Eric Lafortune + */ +public class ClassEditor +{ + private static final boolean DEBUG = false; + + private ProgramClass targetClass; + + + /** + * Creates a new ClassEditor that will edit elements in the given + * target class. + */ + public ClassEditor(ProgramClass targetClass) + { + this.targetClass = targetClass; + } + + + /** + * Adds the given interface. + */ + public void addInterface(int interfaceConstantIndex) + { + int interfacesCount = targetClass.u2interfacesCount; + int[] interfaces = targetClass.u2interfaces; + + // Make sure there is enough space for the new interface. + if (interfaces.length <= interfacesCount) + { + targetClass.u2interfaces = new int[interfacesCount+1]; + System.arraycopy(interfaces, 0, + targetClass.u2interfaces, 0, + interfacesCount); + interfaces = targetClass.u2interfaces; + } + + if (DEBUG) + { + System.out.println(targetClass.getName()+": adding interface ["+targetClass.getClassName(interfaceConstantIndex)+"]"); + } + + // Add the interface. + interfaces[targetClass.u2interfacesCount++] = interfaceConstantIndex; + } + + /** + * Removes the given interface. + */ + public void removeInterface(int interfaceConstantIndex) + { + int interfacesCount = targetClass.u2interfacesCount; + int[] interfaces = targetClass.u2interfaces; + + int interfaceIndex = findInterfaceIndex(interfaceConstantIndex); + + // Shift the interface entries. + System.arraycopy(interfaces, interfaceIndex+1, + interfaces, interfaceIndex, + interfacesCount - interfaceIndex - 1); + + // Clear the last entry. + interfaces[--targetClass.u2interfacesCount] = 0; + } + + + /** + * Finds the index of the given interface in the target class. + */ + + private int findInterfaceIndex(int interfaceConstantIndex) + { + int interfacesCount = targetClass.u2interfacesCount; + int[] interfaces = targetClass.u2interfaces; + + for (int index = 0; index < interfacesCount; index++) + { + if (interfaces[index] == interfaceConstantIndex) + { + return index; + } + } + + return interfacesCount; + } + + + /** + * Adds the given field. + */ + public void addField(Field field) + { + int fieldsCount = targetClass.u2fieldsCount; + Field[] fields = targetClass.fields; + + // Make sure there is enough space for the new field. + if (fields.length <= fieldsCount) + { + targetClass.fields = new ProgramField[fieldsCount+1]; + System.arraycopy(fields, 0, + targetClass.fields, 0, + fieldsCount); + fields = targetClass.fields; + } + + if (DEBUG) + { + System.out.println(targetClass.getName()+": adding field ["+field.getName(targetClass)+" "+field.getDescriptor(targetClass)+"]"); + } + + // Add the field. + fields[targetClass.u2fieldsCount++] = field; + } + + + /** + * Removes the given field. Note that removing a field that is still being + * referenced can cause unpredictable effects. + */ + public void removeField(Field field) + { + int fieldsCount = targetClass.u2fieldsCount; + Field[] fields = targetClass.fields; + + int fieldIndex = findFieldIndex(field); + + // Shift the field entries. + System.arraycopy(fields, fieldIndex+1, + fields, fieldIndex, + fieldsCount - fieldIndex - 1); + + // Clear the last entry. + fields[--targetClass.u2fieldsCount] = null; + } + + + /** + * Finds the index of the given field in the target class. + */ + + private int findFieldIndex(Field field) + { + int fieldsCount = targetClass.u2fieldsCount; + Field[] fields = targetClass.fields; + + for (int index = 0; index < fieldsCount; index++) + { + if (fields[index].equals(field)) + { + return index; + } + } + + return fieldsCount; + } + + + /** + * Adds the given method. + */ + public void addMethod(Method method) + { + int methodsCount = targetClass.u2methodsCount; + Method[] methods = targetClass.methods; + + // Make sure there is enough space for the new method. + if (methods.length <= methodsCount) + { + targetClass.methods = new ProgramMethod[methodsCount+1]; + System.arraycopy(methods, 0, + targetClass.methods, 0, + methodsCount); + methods = targetClass.methods; + } + + if (DEBUG) + { + System.out.println(targetClass.getName()+": adding method ["+method.getName(targetClass)+method.getDescriptor(targetClass)+"]"); + } + + // Add the method. + methods[targetClass.u2methodsCount++] = method; + } + + + /** + * Removes the given method. Note that removing a method that is still being + * referenced can cause unpredictable effects. + */ + public void removeMethod(Method method) + { + int methodsCount = targetClass.u2methodsCount; + Method[] methods = targetClass.methods; + + int methodIndex = findMethodIndex(method); + + // Shift the method entries. + System.arraycopy(methods, methodIndex+1, + methods, methodIndex, + methodsCount - methodIndex - 1); + + // Clear the last entry. + methods[--targetClass.u2methodsCount] = null; + } + + + /** + * Finds the index of the given method in the target class. + */ + + private int findMethodIndex(Method method) + { + int methodsCount = targetClass.u2methodsCount; + Method[] methods = targetClass.methods; + + for (int index = 0; index < methodsCount; index++) + { + if (methods[index].equals(method)) + { + return index; + } + } + + return methodsCount; + } +} diff --git a/src/proguard/classfile/editor/ClassElementSorter.java b/src/proguard/classfile/editor/ClassElementSorter.java new file mode 100644 index 0000000..3256c88 --- /dev/null +++ b/src/proguard/classfile/editor/ClassElementSorter.java @@ -0,0 +1,52 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.ProgramClass; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor sorts the various elements of the classes that it visits: + * interfaces, constants, fields, methods, and attributes. + * + * @author Eric Lafortune + */ +public class ClassElementSorter +extends SimplifiedVisitor +implements ClassVisitor +{ + private final ClassVisitor interfaceSorter = new InterfaceSorter(); + private final ClassVisitor constantPoolSorter = new ConstantPoolSorter(); +// private ClassVisitor classMemberSorter = new ClassMemberSorter(); + private final ClassVisitor attributeSorter = new AttributeSorter(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.accept(constantPoolSorter); + programClass.accept(interfaceSorter); +// programClass.accept(classMemberSorter); + programClass.accept(attributeSorter); + } +} diff --git a/src/proguard/classfile/editor/ClassMemberSorter.java b/src/proguard/classfile/editor/ClassMemberSorter.java new file mode 100644 index 0000000..f31fcd0 --- /dev/null +++ b/src/proguard/classfile/editor/ClassMemberSorter.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +import java.util.*; + +/** + * This ClassVisitor sorts the class members of the classes that it visits. + * The sorting order is based on the access flags, the names, and the + * descriptors. + * + * @author Eric Lafortune + */ +public class ClassMemberSorter implements ClassVisitor, Comparator +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Sort the fields. + Arrays.sort(programClass.fields, 0, programClass.u2fieldsCount, this); + + // Sort the methods. + Arrays.sort(programClass.methods, 0, programClass.u2methodsCount, this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Implementations for Comparator. + + public int compare(Object object1, Object object2) + { + ProgramMember member1 = (ProgramMember)object1; + ProgramMember member2 = (ProgramMember)object2; + + return member1.u2accessFlags < member2.u2accessFlags ? -1 : + member1.u2accessFlags > member2.u2accessFlags ? 1 : + member1.u2nameIndex < member2.u2nameIndex ? -1 : + member1.u2nameIndex > member2.u2nameIndex ? 1 : + member1.u2descriptorIndex < member2.u2descriptorIndex ? -1 : + member1.u2descriptorIndex > member2.u2descriptorIndex ? 1 : + 0; + } +} diff --git a/src/proguard/classfile/editor/ClassReferenceFixer.java b/src/proguard/classfile/editor/ClassReferenceFixer.java new file mode 100644 index 0000000..9857903 --- /dev/null +++ b/src/proguard/classfile/editor/ClassReferenceFixer.java @@ -0,0 +1,546 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor fixes references of constant pool entries, fields, + * methods, and attributes to classes whose names have changed. Descriptors + * of member references are not updated yet. + * + * @see MemberReferenceFixer + * @author Eric Lafortune + */ +public class ClassReferenceFixer +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private final boolean ensureUniqueMemberNames; + + + /** + * Creates a new ClassReferenceFixer. + * @param ensureUniqueMemberNames specifies whether class members whose + * descriptor changes should get new, unique + * names, in order to avoid naming conflicts + * with similar methods. + */ + public ClassReferenceFixer(boolean ensureUniqueMemberNames) + { + this.ensureUniqueMemberNames = ensureUniqueMemberNames; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Fix the constant pool. + programClass.constantPoolEntriesAccept(this); + + // Fix class members. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + // Fix the attributes. + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Fix class members. + libraryClass.fieldsAccept(this); + libraryClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Has the descriptor changed? + String descriptor = programField.getDescriptor(programClass); + String newDescriptor = newDescriptor(descriptor, + programField.referencedClass); + + if (!descriptor.equals(newDescriptor)) + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor(programClass); + + // Update the descriptor. + programField.u2descriptorIndex = + constantPoolEditor.addUtf8Constant(newDescriptor); + + // Update the name, if requested. + if (ensureUniqueMemberNames) + { + String name = programField.getName(programClass); + String newName = newUniqueMemberName(name, descriptor); + programField.u2nameIndex = + constantPoolEditor.addUtf8Constant(newName); + } + } + + // Fix the attributes. + programField.attributesAccept(programClass, this); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Has the descriptor changed? + String descriptor = programMethod.getDescriptor(programClass); + String newDescriptor = newDescriptor(descriptor, + programMethod.referencedClasses); + + if (!descriptor.equals(newDescriptor)) + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor(programClass); + + // Update the descriptor. + programMethod.u2descriptorIndex = + constantPoolEditor.addUtf8Constant(newDescriptor); + + // Update the name, if requested. + if (ensureUniqueMemberNames) + { + String name = programMethod.getName(programClass); + String newName = newUniqueMemberName(name, descriptor); + programMethod.u2nameIndex = + constantPoolEditor.addUtf8Constant(newName); + } + } + + // Fix the attributes. + programMethod.attributesAccept(programClass, this); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + // Has the descriptor changed? + String descriptor = libraryField.getDescriptor(libraryClass); + String newDescriptor = newDescriptor(descriptor, + libraryField.referencedClass); + + // Update the descriptor. + libraryField.descriptor = newDescriptor; + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Has the descriptor changed? + String descriptor = libraryMethod.getDescriptor(libraryClass); + String newDescriptor = newDescriptor(descriptor, + libraryMethod.referencedClasses); + + // Update the descriptor. + libraryMethod.descriptor = newDescriptor; + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Does the string refer to a class, due to a Class.forName construct? + Clazz referencedClass = stringConstant.referencedClass; + Member referencedMember = stringConstant.referencedMember; + if (referencedClass != null && + referencedMember == null) + { + // Reconstruct the new class name. + String externalClassName = stringConstant.getString(clazz); + String internalClassName = ClassUtil.internalClassName(externalClassName); + String newInternalClassName = newClassName(internalClassName, + referencedClass); + + // Update the String entry if required. + if (!newInternalClassName.equals(internalClassName)) + { + String newExternalClassName = ClassUtil.externalClassName(newInternalClassName); + + // Refer to a new Utf8 entry. + stringConstant.u2stringIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newExternalClassName); + } + } + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Do we know the referenced class? + Clazz referencedClass = classConstant.referencedClass; + if (referencedClass != null) + { + // Has the class name changed? + String className = classConstant.getName(clazz); + String newClassName = newClassName(className, referencedClass); + if (!className.equals(newClassName)) + { + // Refer to a new Utf8 entry. + classConstant.u2nameIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newClassName); + } + } + } + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Fix the inner class names. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Fix the attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Fix the types of the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Fix the signatures of the local variables. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + // Compute the new signature. + String signature = clazz.getString(signatureAttribute.u2signatureIndex); + String newSignature = newDescriptor(signature, + signatureAttribute.referencedClasses); + + if (!signature.equals(newSignature)) + { + signatureAttribute.u2signatureIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newSignature); + } + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Fix the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Fix the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Fix the annotation. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + // Fix the inner class name. + int innerClassIndex = innerClassesInfo.u2innerClassIndex; + int innerNameIndex = innerClassesInfo.u2innerNameIndex; + if (innerClassIndex != 0 && + innerNameIndex != 0) + { + String newInnerName = clazz.getClassName(innerClassIndex); + int index = newInnerName.lastIndexOf(ClassConstants.INTERNAL_INNER_CLASS_SEPARATOR); + if (index >= 0) + { + innerClassesInfo.u2innerNameIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newInnerName.substring(index + 1)); + } + } + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + // Has the descriptor changed? + String descriptor = clazz.getString(localVariableInfo.u2descriptorIndex); + String newDescriptor = newDescriptor(descriptor, + localVariableInfo.referencedClass); + + if (!descriptor.equals(newDescriptor)) + { + // Refer to a new Utf8 entry. + localVariableInfo.u2descriptorIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newDescriptor); + } + } + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + // Has the signature changed? + String signature = clazz.getString(localVariableTypeInfo.u2signatureIndex); + String newSignature = newDescriptor(signature, + localVariableTypeInfo.referencedClasses); + + if (!signature.equals(newSignature)) + { + localVariableTypeInfo.u2signatureIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newSignature); + } + } + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Compute the new type name. + String typeName = clazz.getString(annotation.u2typeIndex); + String newTypeName = newDescriptor(typeName, + annotation.referencedClasses); + + if (!typeName.equals(newTypeName)) + { + // Refer to a new Utf8 entry. + annotation.u2typeIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newTypeName); + } + + // Fix the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + // Compute the new type name. + String typeName = clazz.getString(enumConstantElementValue.u2typeNameIndex); + String newTypeName = newDescriptor(typeName, + enumConstantElementValue.referencedClasses); + + if (!typeName.equals(newTypeName)) + { + // Refer to a new Utf8 entry. + enumConstantElementValue.u2typeNameIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newTypeName); + } + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + // Compute the new class name. + String className = clazz.getString(classElementValue.u2classInfoIndex); + String newClassName = newDescriptor(className, + classElementValue.referencedClasses); + + if (!className.equals(newClassName)) + { + // Refer to a new Utf8 entry. + classElementValue.u2classInfoIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newClassName); + } + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + // Fix the annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Fix the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + // Small utility methods. + + private static String newDescriptor(String descriptor, + Clazz referencedClass) + { + // If there is no referenced class, the descriptor won't change. + if (referencedClass == null) + { + return descriptor; + } + + // Unravel and reconstruct the class element of the descriptor. + DescriptorClassEnumeration descriptorClassEnumeration = + new DescriptorClassEnumeration(descriptor); + + StringBuffer newDescriptorBuffer = new StringBuffer(descriptor.length()); + newDescriptorBuffer.append(descriptorClassEnumeration.nextFluff()); + + // Only if the descriptor contains a class name (e.g. with an array of + // primitive types), the descriptor can change. + if (descriptorClassEnumeration.hasMoreClassNames()) + { + String className = descriptorClassEnumeration.nextClassName(); + String fluff = descriptorClassEnumeration.nextFluff(); + + String newClassName = newClassName(className, + referencedClass); + + newDescriptorBuffer.append(newClassName); + newDescriptorBuffer.append(fluff); + } + + return newDescriptorBuffer.toString(); + } + + + private static String newDescriptor(String descriptor, + Clazz[] referencedClasses) + { + // If there are no referenced classes, the descriptor won't change. + if (referencedClasses == null || + referencedClasses.length == 0) + { + return descriptor; + } + + // Unravel and reconstruct the class elements of the descriptor. + DescriptorClassEnumeration descriptorClassEnumeration = + new DescriptorClassEnumeration(descriptor); + + StringBuffer newDescriptorBuffer = new StringBuffer(descriptor.length()); + newDescriptorBuffer.append(descriptorClassEnumeration.nextFluff()); + + int index = 0; + while (descriptorClassEnumeration.hasMoreClassNames()) + { + String className = descriptorClassEnumeration.nextClassName(); + boolean isInnerClassName = descriptorClassEnumeration.isInnerClassName(); + String fluff = descriptorClassEnumeration.nextFluff(); + + String newClassName = newClassName(className, + referencedClasses[index++]); + + // Strip the outer class name again, if it's an inner class. + if (isInnerClassName) + { + newClassName = + newClassName.substring(newClassName.lastIndexOf(ClassConstants.INTERNAL_INNER_CLASS_SEPARATOR)+1); + } + + newDescriptorBuffer.append(newClassName); + newDescriptorBuffer.append(fluff); + } + + return newDescriptorBuffer.toString(); + } + + + /** + * Returns a unique class member name, based on the given name and descriptor. + */ + private String newUniqueMemberName(String name, String descriptor) + { + return name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) ? + ClassConstants.INTERNAL_METHOD_NAME_INIT : + name + ClassConstants.SPECIAL_MEMBER_SEPARATOR + Long.toHexString(Math.abs((descriptor).hashCode())); + } + + + /** + * Returns the new class name based on the given class name and the new + * name of the given referenced class. Class names of array types + * are handled properly. + */ + private static String newClassName(String className, + Clazz referencedClass) + { + // If there is no referenced class, the class name won't change. + if (referencedClass == null) + { + return className; + } + + // Reconstruct the class name. + String newClassName = referencedClass.getName(); + + // Is it an array type? + if (className.charAt(0) == ClassConstants.INTERNAL_TYPE_ARRAY) + { + // Add the array prefixes and suffix "[L...;". + newClassName = + className.substring(0, className.indexOf(ClassConstants.INTERNAL_TYPE_CLASS_START)+1) + + newClassName + + ClassConstants.INTERNAL_TYPE_CLASS_END; + } + + return newClassName; + } +} diff --git a/src/proguard/classfile/editor/CodeAttributeComposer.java b/src/proguard/classfile/editor/CodeAttributeComposer.java new file mode 100644 index 0000000..e783203 --- /dev/null +++ b/src/proguard/classfile/editor/CodeAttributeComposer.java @@ -0,0 +1,845 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor accumulates instructions and exceptions, and then + * copies them into code attributes that it visits. + * + * @author Eric Lafortune + */ +public class CodeAttributeComposer +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LineNumberInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + public static boolean DEBUG = true; + //*/ + + + private static final int MAXIMUM_LEVELS = 32; + private static final int INVALID = -1; + + + private boolean allowExternalExceptionHandlers; + + private int maximumCodeLength; + private int codeLength; + private int exceptionTableLength; + private int level = -1; + + private byte[] code = new byte[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] oldInstructionOffsets = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + + private final int[] codeFragmentOffsets = new int[MAXIMUM_LEVELS]; + private final int[] codeFragmentLengths = new int[MAXIMUM_LEVELS]; + private final int[][] instructionOffsetMap = new int[MAXIMUM_LEVELS][ClassConstants.TYPICAL_CODE_LENGTH + 1]; + + private ExceptionInfo[] exceptionTable = new ExceptionInfo[ClassConstants.TYPICAL_EXCEPTION_TABLE_LENGTH]; + + private int expectedStackMapFrameOffset; + + private final StackSizeUpdater stackSizeUpdater = new StackSizeUpdater(); + private final VariableSizeUpdater variableSizeUpdater = new VariableSizeUpdater(); +// private final InstructionWriter instructionWriter = new InstructionWriter(); + + + /** + * Creates a new CodeAttributeComposer that doesn't allow external exception + * handlers. + */ + public CodeAttributeComposer() + { + this(false); + } + + + /** + * Creates a new CodeAttributeComposer that optionally allows external + * exception handlers. + */ + public CodeAttributeComposer(boolean allowExternalExceptionHandlers) + { + this.allowExternalExceptionHandlers = allowExternalExceptionHandlers; + } + + + /** + * Starts a new code definition. + */ + public void reset() + { + maximumCodeLength = 0; + codeLength = 0; + exceptionTableLength = 0; + level = -1; + } + + + /** + * Starts a new code fragment. Branch instructions that are added are + * assumed to be relative within such code fragments. + * @param maximumCodeFragmentLength the maximum length of the code that will + * be added as part of this fragment. + */ + public void beginCodeFragment(int maximumCodeFragmentLength) + { + level++; + + if (level >= MAXIMUM_LEVELS) + { + throw new IllegalArgumentException("Maximum number of code fragment levels exceeded ["+level+"]"); + } + +// // TODO: Figure out some length. +// if (level == 0) +// { +// // Prepare for possible widening of instructions. +// instructionWriter.reset(2 * maximumCodeFragmentLength); +// } + + // Make sure there is sufficient space for adding the code fragment. + maximumCodeLength += maximumCodeFragmentLength; + + ensureCodeLength(maximumCodeLength); + + // Try to reuse the previous array for this code fragment. + if (instructionOffsetMap[level].length <= maximumCodeFragmentLength) + { + instructionOffsetMap[level] = new int[maximumCodeFragmentLength + 1]; + } + + // Initialize the offset map. + for (int index = 0; index <= maximumCodeFragmentLength; index++) + { + instructionOffsetMap[level][index] = INVALID; + } + + // Remember the location of the code fragment. + codeFragmentOffsets[level] = codeLength; + codeFragmentLengths[level] = maximumCodeFragmentLength; + } + + + /** + * Appends the given instruction with the given old offset. + * @param oldInstructionOffset the old offset of the instruction, to which + * branches and other references in the current + * code fragment are pointing. + * @param instruction the instruction to be appended. + */ + public void appendInstruction(int oldInstructionOffset, + Instruction instruction) + { + if (DEBUG) + { + println("["+codeLength+"] <- ", instruction.toString(oldInstructionOffset)); + } + + // Make sure the code array is large enough. + int newCodeLength = codeLength + instruction.length(codeLength); + + ensureCodeLength(newCodeLength); + + // Remember the old offset of the appended instruction. + oldInstructionOffsets[codeLength] = oldInstructionOffset; + + // Write the instruction. +// instruction.accept(null, +// null, +// new CodeAttribute(0, 0, 0, 0, code, 0, null, 0, null), +// codeLength, +// instructionWriter); + instruction.write(code, codeLength); + + // Fill out the new offset of the appended instruction. + instructionOffsetMap[level][oldInstructionOffset] = codeLength; + + // Continue appending at the next instruction offset. + codeLength = newCodeLength; + } + + + /** + * Appends the given label with the given old offset. + * @param oldInstructionOffset the old offset of the label, to which + * branches and other references in the current + * code fragment are pointing. + */ + public void appendLabel(int oldInstructionOffset) + { + if (DEBUG) + { + println("["+codeLength+"] <- ", "[" + oldInstructionOffset + "] (label)"); + } + + // Fill out the new offset of the appended instruction. + instructionOffsetMap[level][oldInstructionOffset] = codeLength; + } + + + /** + * Appends the given exception to the exception table. + * @param exceptionInfo the exception to be appended. + */ + public void appendException(ExceptionInfo exceptionInfo) + { + if (DEBUG) + { + print(" ", "Exception ["+exceptionInfo.u2startPC+" -> "+exceptionInfo.u2endPC+": "+exceptionInfo.u2handlerPC+"]"); + } + + // Remap the exception right away. + visitExceptionInfo(null, null, null, exceptionInfo); + + if (DEBUG) + { + System.out.println(" -> ["+exceptionInfo.u2startPC+" -> "+exceptionInfo.u2endPC+": "+exceptionInfo.u2handlerPC+"]"); + } + + // Don't add the exception if its instruction range is empty. + if (exceptionInfo.u2startPC == exceptionInfo.u2endPC) + { + if (DEBUG) + { + println(" ", " (not added because of empty instruction range)"); + } + + return; + } + + // Make sure there is sufficient space in the exception table. + if (exceptionTable.length <= exceptionTableLength) + { + ExceptionInfo[] newExceptionTable = new ExceptionInfo[exceptionTableLength+1]; + System.arraycopy(exceptionTable, 0, newExceptionTable, 0, exceptionTableLength); + exceptionTable = newExceptionTable; + } + + // Add the exception. + exceptionTable[exceptionTableLength++] = exceptionInfo; + } + + + /** + * Wraps up the current code fragment, continuing with the previous one on + * the stack. + */ + public void endCodeFragment() + { + if (level < 0) + { + throw new IllegalArgumentException("Code fragment not begun ["+level+"]"); + } + + // Remap the instructions of the code fragment. + int instructionOffset = codeFragmentOffsets[level]; + while (instructionOffset < codeLength) + { + // Get the next instruction. + Instruction instruction = InstructionFactory.create(code, instructionOffset); + + // Does this instruction still have to be remapped? + if (oldInstructionOffsets[instructionOffset] >= 0) + { + // Adapt the instruction for its new offset. + instruction.accept(null, null, null, instructionOffset, this); + + // Write the instruction back. +// instruction.accept(null, +// null, +// new CodeAttribute(0, 0, 0, 0, code, 0, null, 0, null), +// instructionOffset, +// instructionWriter); + instruction.write(code, instructionOffset); + + // Don't remap this instruction again. + oldInstructionOffsets[instructionOffset] = -1; + } + + // Continue remapping at the next instruction offset. + instructionOffset += instruction.length(instructionOffset); + } + + // Correct the estimated maximum code length, now that we know the + // actual length of this code fragment. + maximumCodeLength += codeLength - codeFragmentOffsets[level] - + codeFragmentLengths[level]; + + // Try to remap the exception handlers that couldn't be remapped before. + if (allowExternalExceptionHandlers) + { + for (int index = 0; index < exceptionTableLength; index++) + { + ExceptionInfo exceptionInfo = exceptionTable[index]; + + // Unmapped exception handlers are still negated. + int handlerPC = -exceptionInfo.u2handlerPC; + if (handlerPC > 0) + { + if (remappableInstructionOffset(handlerPC)) + { + exceptionInfo.u2handlerPC = remapInstructionOffset(handlerPC); + } + else if (level == 0) + { + throw new IllegalStateException("Couldn't remap exception handler offset ["+handlerPC+"]"); + } + } + } + } + + level--; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (DEBUG) + { + System.out.println("CodeAttributeComposer: putting results in ["+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + } + + if (level != -1) + { + throw new IllegalArgumentException("Code fragment not ended ["+level+"]"); + } + + level++; + + // Make sure the code attribute has sufficient space for the composed + // code. + if (codeAttribute.u4codeLength < codeLength) + { + codeAttribute.code = new byte[codeLength]; + } + + // Copy the composed code over into the code attribute. + codeAttribute.u4codeLength = codeLength; + System.arraycopy(code, 0, codeAttribute.code, 0, codeLength); + + // Remove exceptions with empty code blocks (done before). + //exceptionTableLength = + // removeEmptyExceptions(exceptionTable, exceptionTableLength); + + // Make sure the exception table has sufficient space for the composed + // exceptions. + if (codeAttribute.exceptionTable.length < exceptionTableLength) + { + codeAttribute.exceptionTable = new ExceptionInfo[exceptionTableLength]; + } + + // Copy the exception table. + codeAttribute.u2exceptionTableLength = exceptionTableLength; + System.arraycopy(exceptionTable, 0, codeAttribute.exceptionTable, 0, exceptionTableLength); + + // Update the maximum stack size and local variable frame size. + stackSizeUpdater.visitCodeAttribute(clazz, method, codeAttribute); + variableSizeUpdater.visitCodeAttribute(clazz, method, codeAttribute); + + // Remap the line number table and the local variable table. + codeAttribute.attributesAccept(clazz, method, this); + + // Remap the exception table. + //codeAttribute.exceptionsAccept(clazz, method, this); + + // Remove exceptions with empty code blocks (done before). + //codeAttribute.u2exceptionTableLength = + // removeEmptyExceptions(codeAttribute.exceptionTable, + // codeAttribute.u2exceptionTableLength); + +// // Make sure instructions are widened if necessary. +// instructionWriter.visitCodeAttribute(clazz, method, codeAttribute); + + level--; + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + // Remap all stack map entries. + expectedStackMapFrameOffset = -1; + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + // Remap all stack map table entries. + expectedStackMapFrameOffset = 0; + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + // Remap all line number table entries. + lineNumberTableAttribute.lineNumbersAccept(clazz, method, codeAttribute, this); + + // Remove line numbers with empty code blocks. + lineNumberTableAttribute.u2lineNumberTableLength = + removeEmptyLineNumbers(lineNumberTableAttribute.lineNumberTable, + lineNumberTableAttribute.u2lineNumberTableLength, + codeAttribute.u4codeLength); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Remap all local variable table entries. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + + // Remove local variables with empty code blocks. + localVariableTableAttribute.u2localVariableTableLength = + removeEmptyLocalVariables(localVariableTableAttribute.localVariableTable, + localVariableTableAttribute.u2localVariableTableLength, + codeAttribute.u2maxLocals); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Remap all local variable table entries. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + + // Remove local variables with empty code blocks. + localVariableTypeTableAttribute.u2localVariableTypeTableLength = + removeEmptyLocalVariableTypes(localVariableTypeTableAttribute.localVariableTypeTable, + localVariableTypeTableAttribute.u2localVariableTypeTableLength, + codeAttribute.u2maxLocals); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Adjust the branch offset. + branchInstruction.branchOffset = remapBranchOffset(offset, + branchInstruction.branchOffset); + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + // Adjust the default jump offset. + switchInstruction.defaultOffset = remapBranchOffset(offset, + switchInstruction.defaultOffset); + + // Adjust the jump offsets. + remapJumpOffsets(offset, + switchInstruction.jumpOffsets); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + // Remap the code offsets. Note that the instruction offset map also has + // an entry for the first offset after the code, for u2endPC. + exceptionInfo.u2startPC = remapInstructionOffset(exceptionInfo.u2startPC); + exceptionInfo.u2endPC = remapInstructionOffset(exceptionInfo.u2endPC); + + // See if we can remap the handler right away. Unmapped exception + // handlers are negated, in order to mark them as external. + int handlerPC = exceptionInfo.u2handlerPC; + exceptionInfo.u2handlerPC = + !allowExternalExceptionHandlers || + remappableInstructionOffset(handlerPC) ? + remapInstructionOffset(handlerPC) : + -handlerPC; + } + + + // Implementations for StackMapFrameVisitor. + + public void visitAnyStackMapFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrame stackMapFrame) + { + // Remap the stack map frame offset. + int stackMapFrameOffset = remapInstructionOffset(offset); + + int offsetDelta = stackMapFrameOffset; + + // Compute the offset delta if the frame is part of a stack map frame + // table (for JDK 6.0) instead of a stack map (for Java Micro Edition). + if (expectedStackMapFrameOffset >= 0) + { + offsetDelta -= expectedStackMapFrameOffset; + + expectedStackMapFrameOffset = stackMapFrameOffset + 1; + } + + stackMapFrame.u2offsetDelta = offsetDelta; + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + // Remap the stack map frame offset. + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, sameOneFrame); + + // Remap the verification type offset. + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + // Remap the stack map frame offset. + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, moreZeroFrame); + + // Remap the verification type offsets. + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + // Remap the stack map frame offset. + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, fullFrame); + + // Remap the verification type offsets. + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) {} + + + public void visitUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType) + { + // Remap the offset of the 'new' instruction. + uninitializedType.u2newInstructionOffset = remapInstructionOffset(uninitializedType.u2newInstructionOffset); + } + + + // Implementations for LineNumberInfoVisitor. + + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo) + { + // Remap the code offset. + lineNumberInfo.u2startPC = remapInstructionOffset(lineNumberInfo.u2startPC); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + // Remap the code offset and length. + // TODO: The local variable frame might not be strictly preserved. + int startPC = remapInstructionOffset(localVariableInfo.u2startPC); + int endPC = remapInstructionOffset(localVariableInfo.u2startPC + localVariableInfo.u2length); + + localVariableInfo.u2startPC = startPC; + localVariableInfo.u2length = endPC - startPC; + } + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + // Remap the code offset and length. + // TODO: The local variable frame might not be strictly preserved. + int startPC = remapInstructionOffset(localVariableTypeInfo.u2startPC); + int endPC = remapInstructionOffset(localVariableTypeInfo.u2startPC + localVariableTypeInfo.u2length); + + localVariableTypeInfo.u2startPC = startPC; + localVariableTypeInfo.u2length = endPC - startPC; + } + + + // Small utility methods. + + /** + * Make sure the code arrays have at least the given size. + */ + private void ensureCodeLength(int newCodeLength) + { + if (code.length < newCodeLength) + { + // Add 20% to avoid extending the arrays too often. + newCodeLength = newCodeLength * 6 / 5; + + byte[] newCode = new byte[newCodeLength]; + System.arraycopy(code, 0, newCode, 0, codeLength); + code = newCode; + + int[] newOldInstructionOffsets = new int[newCodeLength]; + System.arraycopy(oldInstructionOffsets, 0, newOldInstructionOffsets, 0, codeLength); + oldInstructionOffsets = newOldInstructionOffsets; + } + } + + + /** + * Adjusts the given jump offsets for the instruction at the given offset. + */ + private void remapJumpOffsets(int offset, int[] jumpOffsets) + { + for (int index = 0; index < jumpOffsets.length; index++) + { + jumpOffsets[index] = remapBranchOffset(offset, jumpOffsets[index]); + } + } + + + /** + * Computes the new branch offset for the instruction at the given new offset + * with the given old branch offset. + */ + private int remapBranchOffset(int newInstructionOffset, int branchOffset) + { + if (newInstructionOffset < 0 || + newInstructionOffset > codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+newInstructionOffset +"] in code with length ["+codeLength+"]"); + } + + int oldInstructionOffset = oldInstructionOffsets[newInstructionOffset]; + + return remapInstructionOffset(oldInstructionOffset + branchOffset) - + remapInstructionOffset(oldInstructionOffset); + } + + + /** + * Computes the new instruction offset for the instruction at the given old + * offset. + */ + private int remapInstructionOffset(int oldInstructionOffset) + { + if (oldInstructionOffset < 0 || + oldInstructionOffset > codeFragmentLengths[level]) + { + throw new IllegalArgumentException("Instruction offset ["+oldInstructionOffset +"] out of range in code fragment with length ["+codeFragmentLengths[level]+"] at level "+level); + } + + int newInstructionOffset = instructionOffsetMap[level][oldInstructionOffset]; + if (newInstructionOffset == INVALID) + { + throw new IllegalArgumentException("Invalid instruction offset ["+oldInstructionOffset +"] in code fragment at level "+level); + } + + return newInstructionOffset; + } + + + /** + * Returns whether the given old instruction offset can be remapped at the + */ + private boolean remappableInstructionOffset(int oldInstructionOffset) + { + return + oldInstructionOffset <= codeFragmentLengths[level] && + instructionOffsetMap[level][oldInstructionOffset] > INVALID; + } + + + /** + * Returns the given list of exceptions, without the ones that have empty + * code blocks. + */ + private int removeEmptyExceptions(ExceptionInfo[] exceptionInfos, + int exceptionInfoCount) + { + // Overwrite all empty exceptions. + int newIndex = 0; + for (int index = 0; index < exceptionInfoCount; index++) + { + ExceptionInfo exceptionInfo = exceptionInfos[index]; + if (exceptionInfo.u2startPC < exceptionInfo.u2endPC) + { + exceptionInfos[newIndex++] = exceptionInfo; + } + } + + // Clear the unused array entries. + for (int index = newIndex; index < exceptionInfoCount; index++) + { + exceptionInfos[index] = null; + } + + return newIndex; + } + + + /** + * Returns the given list of line numbers, without the ones that have empty + * code blocks or that exceed the code size. + */ + private int removeEmptyLineNumbers(LineNumberInfo[] lineNumberInfos, + int lineNumberInfoCount, + int codeLength) + { + // Overwrite all empty line number entries. + int newIndex = 0; + for (int index = 0; index < lineNumberInfoCount; index++) + { + LineNumberInfo lineNumberInfo = lineNumberInfos[index]; + int startPC = lineNumberInfo.u2startPC; + if (startPC < codeLength && + (index == 0 || startPC > lineNumberInfos[index-1].u2startPC)) + { + lineNumberInfos[newIndex++] = lineNumberInfo; + } + } + + // Clear the unused array entries. + for (int index = newIndex; index < lineNumberInfoCount; index++) + { + lineNumberInfos[index] = null; + } + + return newIndex; + } + + + /** + * Returns the given list of local variables, without the ones that have empty + * code blocks or that exceed the actual number of local variables. + */ + private int removeEmptyLocalVariables(LocalVariableInfo[] localVariableInfos, + int localVariableInfoCount, + int maxLocals) + { + // Overwrite all empty local variable entries. + int newIndex = 0; + for (int index = 0; index < localVariableInfoCount; index++) + { + LocalVariableInfo localVariableInfo = localVariableInfos[index]; + if (localVariableInfo.u2length > 0 && + localVariableInfo.u2index < maxLocals) + { + localVariableInfos[newIndex++] = localVariableInfo; + } + } + + // Clear the unused array entries. + for (int index = newIndex; index < localVariableInfoCount; index++) + { + localVariableInfos[index] = null; + } + + return newIndex; + } + + + /** + * Returns the given list of local variable types, without the ones that + * have empty code blocks or that exceed the actual number of local variables. + */ + private int removeEmptyLocalVariableTypes(LocalVariableTypeInfo[] localVariableTypeInfos, + int localVariableTypeInfoCount, + int maxLocals) + { + // Overwrite all empty local variable type entries. + int newIndex = 0; + for (int index = 0; index < localVariableTypeInfoCount; index++) + { + LocalVariableTypeInfo localVariableTypeInfo = localVariableTypeInfos[index]; + if (localVariableTypeInfo.u2length > 0 && + localVariableTypeInfo.u2index < maxLocals) + { + localVariableTypeInfos[newIndex++] = localVariableTypeInfo; + } + } + + // Clear the unused array entries. + for (int index = newIndex; index < localVariableTypeInfoCount; index++) + { + localVariableTypeInfos[index] = null; + } + + return newIndex; + } + + + private void println(String string1, String string2) + { + print(string1, string2); + + System.out.println(); + } + + private void print(String string1, String string2) + { + System.out.print(string1); + + for (int index = 0; index < level; index++) + { + System.out.print(" "); + } + + System.out.print(string2); + } + + + public static void main(String[] args) + { + CodeAttributeComposer composer = new CodeAttributeComposer(); + + composer.beginCodeFragment(4); + composer.appendInstruction(0, new SimpleInstruction(InstructionConstants.OP_ICONST_0)); + composer.appendInstruction(1, new VariableInstruction(InstructionConstants.OP_ISTORE, 0)); + composer.appendInstruction(2, new BranchInstruction(InstructionConstants.OP_GOTO, 1)); + + composer.beginCodeFragment(4); + composer.appendInstruction(0, new VariableInstruction(InstructionConstants.OP_IINC, 0, 1)); + composer.appendInstruction(1, new VariableInstruction(InstructionConstants.OP_ILOAD, 0)); + composer.appendInstruction(2, new SimpleInstruction(InstructionConstants.OP_ICONST_5)); + composer.appendInstruction(3, new BranchInstruction(InstructionConstants.OP_IFICMPLT, -3)); + composer.endCodeFragment(); + + composer.appendInstruction(3, new SimpleInstruction(InstructionConstants.OP_RETURN)); + composer.endCodeFragment(); + } +} diff --git a/src/proguard/classfile/editor/CodeAttributeEditor.java b/src/proguard/classfile/editor/CodeAttributeEditor.java new file mode 100644 index 0000000..9658c98 --- /dev/null +++ b/src/proguard/classfile/editor/CodeAttributeEditor.java @@ -0,0 +1,1163 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassPrinter; + +/** + * This AttributeVisitor accumulates specified changes to code, and then applies + * these accumulated changes to the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class CodeAttributeEditor +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LineNumberInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + private boolean updateFrameSizes; + + private int codeLength; + private boolean modified; + private boolean simple; + + /*private*/public Instruction[] preInsertions = new Instruction[ClassConstants.TYPICAL_CODE_LENGTH]; + /*private*/public Instruction[] replacements = new Instruction[ClassConstants.TYPICAL_CODE_LENGTH]; + /*private*/public Instruction[] postInsertions = new Instruction[ClassConstants.TYPICAL_CODE_LENGTH]; + /*private*/public boolean[] deleted = new boolean[ClassConstants.TYPICAL_CODE_LENGTH]; + + private int[] instructionOffsetMap = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private int newOffset; + private boolean lengthIncreased; + + private int expectedStackMapFrameOffset; + + private final StackSizeUpdater stackSizeUpdater = new StackSizeUpdater(); + private final VariableSizeUpdater variableSizeUpdater = new VariableSizeUpdater(); + private final InstructionWriter instructionWriter = new InstructionWriter(); + + + public CodeAttributeEditor() + { + this(true); + } + + + public CodeAttributeEditor(boolean updateFrameSizes) + { + this.updateFrameSizes = updateFrameSizes; + } + + + /** + * Resets the accumulated code changes. + * @param codeLength the length of the code that will be edited next. + */ + public void reset(int codeLength) + { + this.codeLength = codeLength; + + // Try to reuse the previous arrays. + if (preInsertions.length < codeLength) + { + preInsertions = new Instruction[codeLength]; + replacements = new Instruction[codeLength]; + postInsertions = new Instruction[codeLength]; + deleted = new boolean[codeLength]; + } + else + { + for (int index = 0; index < codeLength; index++) + { + preInsertions[index] = null; + replacements[index] = null; + postInsertions[index] = null; + deleted[index] = false; + } + } + + modified = false; + simple = true; + + } + + + /** + * Remembers to place the given instruction right before the instruction + * at the given offset. + * @param instructionOffset the offset of the instruction. + * @param instruction the new instruction. + */ + public void insertBeforeInstruction(int instructionOffset, Instruction instruction) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + preInsertions[instructionOffset] = instruction; + + modified = true; + simple = false; + + } + + + /** + * Remembers to place the given instructions right before the instruction + * at the given offset. + * @param instructionOffset the offset of the instruction. + * @param instructions the new instructions. + */ + public void insertBeforeInstruction(int instructionOffset, Instruction[] instructions) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + preInsertions[instructionOffset] = new CompositeInstruction(instructions); + + modified = true; + simple = false; + + } + + + /** + * Remembers to replace the instruction at the given offset by the given + * instruction. + * @param instructionOffset the offset of the instruction to be replaced. + * @param instruction the new instruction. + */ + public void replaceInstruction(int instructionOffset, Instruction instruction) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + replacements[instructionOffset] = instruction; + + modified = true; + } + + + /** + * Remembers to replace the instruction at the given offset by the given + * instructions. + * @param instructionOffset the offset of the instruction to be replaced. + * @param instructions the new instructions. + */ + public void replaceInstruction(int instructionOffset, Instruction[] instructions) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + replacements[instructionOffset] = new CompositeInstruction(instructions); + + modified = true; + } + + + /** + * Remembers to place the given instruction right after the instruction + * at the given offset. + * @param instructionOffset the offset of the instruction. + * @param instruction the new instruction. + */ + public void insertAfterInstruction(int instructionOffset, Instruction instruction) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + postInsertions[instructionOffset] = instruction; + + modified = true; + simple = false; + } + + + /** + * Remembers to place the given instructions right after the instruction + * at the given offset. + * @param instructionOffset the offset of the instruction. + * @param instructions the new instructions. + */ + public void insertAfterInstruction(int instructionOffset, Instruction[] instructions) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + postInsertions[instructionOffset] = new CompositeInstruction(instructions); + + modified = true; + simple = false; + } + + + /** + * Remembers to delete the instruction at the given offset. + * @param instructionOffset the offset of the instruction to be deleted. + */ + public void deleteInstruction(int instructionOffset) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + deleted[instructionOffset] = true; + + modified = true; + simple = false; + } + + + /** + * Remembers not to delete the instruction at the given offset. + * @param instructionOffset the offset of the instruction not to be deleted. + */ + public void undeleteInstruction(int instructionOffset) + { + if (instructionOffset < 0 || + instructionOffset >= codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+instructionOffset+"] in code with length ["+codeLength+"]"); + } + + deleted[instructionOffset] = false; + } + + + /** + * Returns whether the instruction at the given offset has been modified + * in any way. + */ + public boolean isModified(int instructionOffset) + { + return preInsertions[instructionOffset] != null || + replacements[instructionOffset] != null || + postInsertions[instructionOffset] != null || + deleted[instructionOffset]; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the code has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while editing code:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + throw ex; + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (DEBUG) + { + System.out.println("CodeAttributeEditor: ["+clazz.getName()+"."+method.getName(clazz)+"]"); + } + + // Avoid doing any work if nothing is changing anyway. + if (!modified) + { + return; + } + + // Check if we can perform a faster simple replacement of instructions. + if (canPerformSimpleReplacements(codeAttribute)) + { + // Simply overwrite the instructions. + performSimpleReplacements(codeAttribute); + + // Update the maximum stack size and local variable frame size. + updateFrameSizes(clazz, method, codeAttribute); + } + else + { + // Move and remap the instructions. + codeAttribute.u4codeLength = + updateInstructions(clazz, method, codeAttribute); + + // Remap the exception table. + codeAttribute.exceptionsAccept(clazz, method, this); + + // Remove exceptions with empty code blocks. + codeAttribute.u2exceptionTableLength = + removeEmptyExceptions(codeAttribute.exceptionTable, + codeAttribute.u2exceptionTableLength); + + // Update the maximum stack size and local variable frame size. + updateFrameSizes(clazz, method, codeAttribute); + + // Remap the line number table and the local variable table. + codeAttribute.attributesAccept(clazz, method, this); + + // Make sure instructions are widened if necessary. + instructionWriter.visitCodeAttribute(clazz, method, codeAttribute); + } + } + + + private void updateFrameSizes(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (updateFrameSizes) + { + stackSizeUpdater.visitCodeAttribute(clazz, method, codeAttribute); + variableSizeUpdater.visitCodeAttribute(clazz, method, codeAttribute); + } + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + // Remap all stack map entries. + expectedStackMapFrameOffset = -1; + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + // Remap all stack map table entries. + expectedStackMapFrameOffset = 0; + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + // Remap all line number table entries. + lineNumberTableAttribute.lineNumbersAccept(clazz, method, codeAttribute, this); + + // Remove line numbers with empty code blocks. + lineNumberTableAttribute.u2lineNumberTableLength = + removeEmptyLineNumbers(lineNumberTableAttribute.lineNumberTable, + lineNumberTableAttribute.u2lineNumberTableLength, + codeAttribute.u4codeLength); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Remap all local variable table entries. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + + // Remove local variables with empty code blocks. + localVariableTableAttribute.u2localVariableTableLength = + removeEmptyLocalVariables(localVariableTableAttribute.localVariableTable, + localVariableTableAttribute.u2localVariableTableLength, + codeAttribute.u2maxLocals); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Remap all local variable table entries. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + + // Remove local variables with empty code blocks. + localVariableTypeTableAttribute.u2localVariableTypeTableLength = + removeEmptyLocalVariableTypes(localVariableTypeTableAttribute.localVariableTypeTable, + localVariableTypeTableAttribute.u2localVariableTypeTableLength, + codeAttribute.u2maxLocals); + } + + + /** + * Checks if it is possible to modifies the given code without having to + * update any offsets. + * @param codeAttribute the code to be changed. + * @return the new code length. + */ + private boolean canPerformSimpleReplacements(CodeAttribute codeAttribute) + { + if (!simple) + { + return false; + } + + byte[] code = codeAttribute.code; + int codeLength = codeAttribute.u4codeLength; + + // Go over all replacement instructions. + for (int offset = 0; offset < codeLength; offset++) + { + // Check if the replacement instruction, if any, has a different + // length than the original instruction. + Instruction replacementInstruction = replacements[offset]; + if (replacementInstruction != null && + replacementInstruction.length(offset) != + InstructionFactory.create(code, offset).length(offset)) + { + return false; + } + } + + return true; + } + + + /** + * Modifies the given code without updating any offsets. + * @param codeAttribute the code to be changed. + */ + private void performSimpleReplacements(CodeAttribute codeAttribute) + { + int codeLength = codeAttribute.u4codeLength; + + // Go over all replacement instructions. + for (int offset = 0; offset < codeLength; offset++) + { + // Overwrite the original instruction with the replacement + // instruction if any. + Instruction replacementInstruction = replacements[offset]; + if (replacementInstruction != null) + { + replacementInstruction.write(codeAttribute, offset); + + if (DEBUG) + { + System.out.println(" Replaced "+replacementInstruction.toString(newOffset)); + } + } + } + } + + + /** + * Modifies the given code based on the previously specified changes. + * @param clazz the class file of the code to be changed. + * @param method the method of the code to be changed. + * @param codeAttribute the code to be changed. + * @return the new code length. + */ + private int updateInstructions(Clazz clazz, + Method method, + CodeAttribute codeAttribute) + { + byte[] oldCode = codeAttribute.code; + int oldLength = codeAttribute.u4codeLength; + + // Make sure there is a sufficiently large instruction offset map. + if (instructionOffsetMap.length < oldLength + 1) + { + instructionOffsetMap = new int[oldLength + 1]; + } + + // Fill out the instruction offset map. + int newLength = mapInstructions(oldCode, + oldLength); + + // Create a new code array if necessary. + if (lengthIncreased) + { + codeAttribute.code = new byte[newLength]; + } + + // Prepare for possible widening of instructions. + instructionWriter.reset(newLength); + + // Move the instructions into the new code array. + moveInstructions(clazz, + method, + codeAttribute, + oldCode, + oldLength); + + // We can return the new length. + return newLength; + } + + + /** + * Fills out the instruction offset map for the given code block. + * @param oldCode the instructions to be moved. + * @param oldLength the code length. + * @return the new code length. + */ + private int mapInstructions(byte[] oldCode, int oldLength) + { + // Start mapping instructions at the beginning. + newOffset = 0; + lengthIncreased = false; + + int oldOffset = 0; + do + { + // Get the next instruction. + Instruction instruction = InstructionFactory.create(oldCode, oldOffset); + + // Compute the mapping of the instruction. + mapInstruction(oldOffset, instruction); + + oldOffset += instruction.length(oldOffset); + + if (newOffset > oldOffset) + { + lengthIncreased = true; + } + } + while (oldOffset < oldLength); + + // Also add an entry for the first offset after the code. + instructionOffsetMap[oldOffset] = newOffset; + + return newOffset; + } + + + /** + * Fills out the instruction offset map for the given instruction. + * @param oldOffset the instruction's old offset. + * @param instruction the instruction to be moved. + */ + private void mapInstruction(int oldOffset, + Instruction instruction) + { + instructionOffsetMap[oldOffset] = newOffset; + + // Account for the pre-inserted instruction, if any. + Instruction preInstruction = preInsertions[oldOffset]; + if (preInstruction != null) + { + newOffset += preInstruction.length(newOffset); + } + + // Account for the replacement instruction, or for the current + // instruction, if it shouldn't be deleted. + Instruction replacementInstruction = replacements[oldOffset]; + if (replacementInstruction != null) + { + newOffset += replacementInstruction.length(newOffset); + } + else if (!deleted[oldOffset]) + { + // Note that the instruction's length may change at its new offset, + // e.g. if it is a switch instruction. + newOffset += instruction.length(newOffset); + } + + // Account for the post-inserted instruction, if any. + Instruction postInstruction = postInsertions[oldOffset]; + if (postInstruction != null) + { + newOffset += postInstruction.length(newOffset); + } + } + + + /** + * Moves the given code block to the new offsets. + * @param clazz the class file of the code to be changed. + * @param method the method of the code to be changed. + * @param codeAttribute the code to be changed. + * @param oldCode the original code to be moved. + * @param oldLength the original code length. + */ + private void moveInstructions(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + byte[] oldCode, + int oldLength) + { + // Start writing instructions at the beginning. + newOffset = 0; + + int oldOffset = 0; + do + { + // Get the next instruction. + Instruction instruction = InstructionFactory.create(oldCode, oldOffset); + + // Move the instruction to its new offset. + moveInstruction(clazz, + method, + codeAttribute, + oldOffset, + instruction); + + oldOffset += instruction.length(oldOffset); + } + while (oldOffset < oldLength); + } + + + /** + * Moves the given instruction to its new offset. + * @param clazz the class file of the code to be changed. + * @param method the method of the code to be changed. + * @param codeAttribute the code to be changed. + * @param oldOffset the original instruction offset. + * @param instruction the original instruction. + */ + private void moveInstruction(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int oldOffset, + Instruction instruction) + { + // Remap and insert the pre-inserted instruction, if any. + Instruction preInstruction = preInsertions[oldOffset]; + if (preInstruction != null) + { + if (DEBUG) + { + System.out.println(" Pre-inserted "+preInstruction.toString(newOffset)); + } + + // Remap the instruction. + preInstruction.accept(clazz, method, codeAttribute, oldOffset, this); + } + + // Remap and insert the replacement instruction, or the current + // instruction, if it shouldn't be deleted. + Instruction replacementInstruction = replacements[oldOffset]; + if (replacementInstruction != null) + { + if (DEBUG) + { + System.out.println(" Replaced "+replacementInstruction.toString(newOffset)); + } + // Remap the instruction. + replacementInstruction.accept(clazz, method, codeAttribute, oldOffset, this); + } + else if (!deleted[oldOffset]) + { + if (DEBUG) + { + System.out.println(" Copied "+instruction.toString(newOffset)); + } + + // Remap the instruction. + instruction.accept(clazz, method, codeAttribute, oldOffset, this); + } + + // Remap and insert the post-inserted instruction, if any. + Instruction postInstruction = postInsertions[oldOffset]; + if (postInstruction != null) + { + if (DEBUG) + { + System.out.println(" Post-inserted "+postInstruction.toString(newOffset)); + } + + // Remap the instruction. + postInstruction.accept(clazz, method, codeAttribute, oldOffset, this); + } + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + // Write out the instruction. + instructionWriter.visitSimpleInstruction(clazz, + method, + codeAttribute, + newOffset, + simpleInstruction); + + newOffset += simpleInstruction.length(newOffset); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Write out the instruction. + instructionWriter.visitConstantInstruction(clazz, + method, + codeAttribute, + newOffset, + constantInstruction); + + newOffset += constantInstruction.length(newOffset); + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + // Write out the instruction. + instructionWriter.visitVariableInstruction(clazz, + method, + codeAttribute, + newOffset, + variableInstruction); + + newOffset += variableInstruction.length(newOffset); + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Adjust the branch offset. + branchInstruction.branchOffset = remapBranchOffset(offset, + branchInstruction.branchOffset); + + // Write out the instruction. + instructionWriter.visitBranchInstruction(clazz, + method, + codeAttribute, + newOffset, + branchInstruction); + + newOffset += branchInstruction.length(newOffset); + } + + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + // Adjust the default jump offset. + tableSwitchInstruction.defaultOffset = remapBranchOffset(offset, + tableSwitchInstruction.defaultOffset); + + // Adjust the jump offsets. + remapJumpOffsets(offset, + tableSwitchInstruction.jumpOffsets); + + // Write out the instruction. + instructionWriter.visitTableSwitchInstruction(clazz, + method, + codeAttribute, + newOffset, + tableSwitchInstruction); + + newOffset += tableSwitchInstruction.length(newOffset); + } + + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + // Adjust the default jump offset. + lookUpSwitchInstruction.defaultOffset = remapBranchOffset(offset, + lookUpSwitchInstruction.defaultOffset); + + // Adjust the jump offsets. + remapJumpOffsets(offset, + lookUpSwitchInstruction.jumpOffsets); + + // Write out the instruction. + instructionWriter.visitLookUpSwitchInstruction(clazz, + method, + codeAttribute, + newOffset, + lookUpSwitchInstruction); + + newOffset += lookUpSwitchInstruction.length(newOffset); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + // Remap the code offsets. Note that the instruction offset map also has + // an entry for the first offset after the code, for u2endPC. + exceptionInfo.u2startPC = remapInstructionOffset(exceptionInfo.u2startPC); + exceptionInfo.u2endPC = remapInstructionOffset(exceptionInfo.u2endPC); + exceptionInfo.u2handlerPC = remapInstructionOffset(exceptionInfo.u2handlerPC); + } + + + // Implementations for StackMapFrameVisitor. + + public void visitAnyStackMapFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrame stackMapFrame) + { + // Remap the stack map frame offset. + int stackMapFrameOffset = remapInstructionOffset(offset); + + int offsetDelta = stackMapFrameOffset; + + // Compute the offset delta if the frame is part of a stack map frame + // table (for JDK 6.0) instead of a stack map (for Java Micro Edition). + if (expectedStackMapFrameOffset >= 0) + { + offsetDelta -= expectedStackMapFrameOffset; + + expectedStackMapFrameOffset = stackMapFrameOffset + 1; + } + + stackMapFrame.u2offsetDelta = offsetDelta; + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + // Remap the stack map frame offset. + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, sameOneFrame); + + // Remap the verification type offset. + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + // Remap the stack map frame offset. + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, moreZeroFrame); + + // Remap the verification type offsets. + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + // Remap the stack map frame offset. + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, fullFrame); + + // Remap the verification type offsets. + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) {} + + + public void visitUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType) + { + // Remap the offset of the 'new' instruction. + uninitializedType.u2newInstructionOffset = remapInstructionOffset(uninitializedType.u2newInstructionOffset); + } + + + // Implementations for LineNumberInfoVisitor. + + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo) + { + // Remap the code offset. + lineNumberInfo.u2startPC = remapInstructionOffset(lineNumberInfo.u2startPC); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + // Remap the code offset and length. + // TODO: The local variable frame might not be strictly preserved. + localVariableInfo.u2length = remapBranchOffset(localVariableInfo.u2startPC, + localVariableInfo.u2length); + localVariableInfo.u2startPC = remapInstructionOffset(localVariableInfo.u2startPC); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + // Remap the code offset and length. + // TODO: The local variable frame might not be strictly preserved. + localVariableTypeInfo.u2length = remapBranchOffset(localVariableTypeInfo.u2startPC, + localVariableTypeInfo.u2length); + localVariableTypeInfo.u2startPC = remapInstructionOffset(localVariableTypeInfo.u2startPC); + } + + + // Small utility methods. + + /** + * Adjusts the given jump offsets for the instruction at the given offset. + */ + private void remapJumpOffsets(int offset, int[] jumpOffsets) + { + for (int index = 0; index < jumpOffsets.length; index++) + { + jumpOffsets[index] = remapBranchOffset(offset, jumpOffsets[index]); + } + } + + + /** + * Computes the new branch offset for the instruction at the given offset + * with the given branch offset. + */ + private int remapBranchOffset(int offset, int branchOffset) + { + return remapInstructionOffset(offset + branchOffset) - newOffset; + } + + + /** + * Computes the new instruction offset for the instruction at the given offset. + */ + private int remapInstructionOffset(int offset) + { + if (offset < 0 || + offset > codeLength) + { + throw new IllegalArgumentException("Invalid instruction offset ["+offset+"] in code with length ["+codeLength+"]"); + } + + return instructionOffsetMap[offset]; + } + + + /** + * Returns the given list of exceptions, without the ones that have empty + * code blocks. + */ + private int removeEmptyExceptions(ExceptionInfo[] exceptionInfos, + int exceptionInfoCount) + { + // Overwrite all empty exceptions. + int newIndex = 0; + for (int index = 0; index < exceptionInfoCount; index++) + { + ExceptionInfo exceptionInfo = exceptionInfos[index]; + if (exceptionInfo.u2startPC < exceptionInfo.u2endPC) + { + exceptionInfos[newIndex++] = exceptionInfo; + } + } + + return newIndex; + } + + + /** + * Returns the given list of line numbers, without the ones that have empty + * code blocks or that exceed the code size. + */ + private int removeEmptyLineNumbers(LineNumberInfo[] lineNumberInfos, + int lineNumberInfoCount, + int codeLength) + { + // Overwrite all empty line number entries. + int newIndex = 0; + for (int index = 0; index < lineNumberInfoCount; index++) + { + LineNumberInfo lineNumberInfo = lineNumberInfos[index]; + int startPC = lineNumberInfo.u2startPC; + if (startPC < codeLength && + (index == 0 || startPC > lineNumberInfos[index-1].u2startPC)) + { + lineNumberInfos[newIndex++] = lineNumberInfo; + } + } + + return newIndex; + } + + + /** + * Returns the given list of local variables, without the ones that have empty + * code blocks or that exceed the actual number of local variables. + */ + private int removeEmptyLocalVariables(LocalVariableInfo[] localVariableInfos, + int localVariableInfoCount, + int maxLocals) + { + // Overwrite all empty local variable entries. + int newIndex = 0; + for (int index = 0; index < localVariableInfoCount; index++) + { + LocalVariableInfo localVariableInfo = localVariableInfos[index]; + if (localVariableInfo.u2length > 0 && + localVariableInfo.u2index < maxLocals) + { + localVariableInfos[newIndex++] = localVariableInfo; + } + } + + return newIndex; + } + + + /** + * Returns the given list of local variable types, without the ones that + * have empty code blocks or that exceed the actual number of local variables. + */ + private int removeEmptyLocalVariableTypes(LocalVariableTypeInfo[] localVariableTypeInfos, + int localVariableTypeInfoCount, + int maxLocals) + { + // Overwrite all empty local variable type entries. + int newIndex = 0; + for (int index = 0; index < localVariableTypeInfoCount; index++) + { + LocalVariableTypeInfo localVariableTypeInfo = localVariableTypeInfos[index]; + if (localVariableTypeInfo.u2length > 0 && + localVariableTypeInfo.u2index < maxLocals) + { + localVariableTypeInfos[newIndex++] = localVariableTypeInfo; + } + } + + return newIndex; + } + + + private class CompositeInstruction + extends Instruction + { + private Instruction[] instructions; + + + private CompositeInstruction(Instruction[] instructions) + { + this.instructions = instructions; + } + + + // Implementations for Instruction. + + public Instruction shrink() + { + for (int index = 0; index < instructions.length; index++) + { + instructions[index] = instructions[index].shrink(); + } + + return this; + } + + + public void write(byte[] code, int offset) + { + for (int index = 0; index < instructions.length; index++) + { + Instruction instruction = instructions[index]; + + instruction.write(code, offset); + + offset += instruction.length(offset); + } + } + + + protected void readInfo(byte[] code, int offset) + { + throw new UnsupportedOperationException("Can't read composite instruction"); + } + + + protected void writeInfo(byte[] code, int offset) + { + throw new UnsupportedOperationException("Can't write composite instruction"); + } + + + public int length(int offset) + { + int newOffset = offset; + + for (int index = 0; index < instructions.length; index++) + { + newOffset += instructions[index].length(newOffset); + } + + return newOffset - offset; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + if (instructionVisitor != CodeAttributeEditor.this) + { + throw new UnsupportedOperationException("Unexpected visitor ["+instructionVisitor+"]"); + } + + for (int index = 0; index < instructions.length; index++) + { + Instruction instruction = instructions[index]; + + instruction.accept(clazz, method, codeAttribute, offset, CodeAttributeEditor.this); + + offset += instruction.length(offset); + } + } + + + // Implementations for Object. + + public String toString() + { + StringBuffer stringBuffer = new StringBuffer(); + + for (int index = 0; index < instructions.length; index++) + { + stringBuffer.append(instructions[index].toString()).append("; "); + } + + return stringBuffer.toString(); + } + } +} diff --git a/src/proguard/classfile/editor/CodeAttributeEditorResetter.java b/src/proguard/classfile/editor/CodeAttributeEditorResetter.java new file mode 100644 index 0000000..9962ea5 --- /dev/null +++ b/src/proguard/classfile/editor/CodeAttributeEditorResetter.java @@ -0,0 +1,60 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor resets it CodeAttributeEditor whenever it visits a + * code attribute. + * + * @author Eric Lafortune + */ +public class CodeAttributeEditorResetter +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final CodeAttributeEditor codeAttributeEditor; + + + /** + * Creates a new CodeAttributeEditorResetter. + * @param codeAttributeEditor the code attribute editor that will be reset. + */ + public CodeAttributeEditorResetter(CodeAttributeEditor codeAttributeEditor) + { + this.codeAttributeEditor = codeAttributeEditor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + codeAttributeEditor.reset(codeAttribute.u4codeLength); + } +} diff --git a/src/proguard/classfile/editor/ComparableConstant.java b/src/proguard/classfile/editor/ComparableConstant.java new file mode 100644 index 0000000..bb81221 --- /dev/null +++ b/src/proguard/classfile/editor/ComparableConstant.java @@ -0,0 +1,200 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + + +/** + * This class is a Comparable wrapper of Constant + * objects. It can store an index, in order to identify the constant pool + * entry after it has been sorted. The comparison is primarily based on the + * types of the constant pool entries, and secondarily on the contents of + * the constant pool entries. + * + * @author Eric Lafortune + */ +class ComparableConstant +extends SimplifiedVisitor +implements Comparable, ConstantVisitor +{ + private static final int[] PRIORITIES = new int[13]; + static + { + PRIORITIES[ClassConstants.CONSTANT_Integer] = 0; // Possibly byte index (ldc). + PRIORITIES[ClassConstants.CONSTANT_Float] = 1; + PRIORITIES[ClassConstants.CONSTANT_String] = 2; + PRIORITIES[ClassConstants.CONSTANT_Class] = 3; + PRIORITIES[ClassConstants.CONSTANT_Long] = 4; // Always wide index (ldc2_w). + PRIORITIES[ClassConstants.CONSTANT_Double] = 5; + PRIORITIES[ClassConstants.CONSTANT_Fieldref] = 6; // Always wide index. + PRIORITIES[ClassConstants.CONSTANT_Methodref] = 7; + PRIORITIES[ClassConstants.CONSTANT_InterfaceMethodref] = 8; + PRIORITIES[ClassConstants.CONSTANT_NameAndType] = 9; + PRIORITIES[ClassConstants.CONSTANT_Utf8] = 10; + } + + private final Clazz clazz; + private final int thisIndex; + private final Constant thisConstant; + + private Constant otherConstant; + private int result; + + + public ComparableConstant(Clazz clazz, int index, Constant constant) + { + this.clazz = clazz; + this.thisIndex = index; + this.thisConstant = constant; + } + + + public int getIndex() + { + return thisIndex; + } + + + public Constant getConstant() + { + return thisConstant; + } + + + // Implementations for Comparable. + + public int compareTo(Object other) + { + ComparableConstant otherComparableConstant = (ComparableConstant)other; + + otherConstant = otherComparableConstant.thisConstant; + + // Compare based on the original indices, if the actual constant pool + // entries are the same. + if (thisConstant == otherConstant) + { + int otherIndex = otherComparableConstant.thisIndex; + + return thisIndex < otherIndex ? -1 : + thisIndex == otherIndex ? 0 : + 1; + } + + // Compare based on the tags, if they are different. + int thisTag = thisConstant.getTag(); + int otherTag = otherConstant.getTag(); + + if (thisTag != otherTag) + { + return PRIORITIES[thisTag] < PRIORITIES[otherTag] ? -1 : 1; + } + + // Otherwise compare based on the contents of the Constant objects. + thisConstant.accept(clazz, this); + + return result; + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + // In JDK 1.4, we can use Integer.compare(a,b). + result = new Integer(integerConstant.getValue()).compareTo(new Integer(((IntegerConstant)otherConstant).getValue())); + } + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + // In JDK 1.4, we can use Long.compare(a,b). + result = new Long(longConstant.getValue()).compareTo(new Long(((LongConstant)otherConstant).getValue())); + } + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + // In JDK 1.4, we can use Float.compare(a,b). + result = new Float(floatConstant.getValue()).compareTo(new Float(((FloatConstant)otherConstant).getValue())); + } + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + // In JDK 1.4, we can use Double.compare(a,b). + result = new Double(doubleConstant.getValue()).compareTo(new Double(((DoubleConstant)otherConstant).getValue())); + } + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + result = stringConstant.getString(clazz).compareTo(((StringConstant)otherConstant).getString(clazz)); + } + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + result = utf8Constant.getString().compareTo(((Utf8Constant)otherConstant).getString()); + } + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + RefConstant otherRefConstant = (RefConstant)otherConstant; + result = (refConstant.getClassName(clazz) + ' ' + + refConstant.getName(clazz) + ' ' + + refConstant.getType(clazz)) + .compareTo + (otherRefConstant.getClassName(clazz) + ' ' + + otherRefConstant.getName(clazz) + ' ' + + otherRefConstant.getType(clazz)); + } + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + result = classConstant.getName(clazz).compareTo(((ClassConstant)otherConstant).getName(clazz)); + } + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + NameAndTypeConstant otherNameAndTypeConstant = (NameAndTypeConstant)otherConstant; + result = (nameAndTypeConstant.getName(clazz) + ' ' + + nameAndTypeConstant.getType(clazz)) + .compareTo + (otherNameAndTypeConstant.getName(clazz) + ' ' + + otherNameAndTypeConstant.getType(clazz)); + } + + + // Implementations for Object. + + public boolean equals(Object other) + { + return other != null && + this.getClass().equals(other.getClass()) && + this.getConstant().getClass().equals(((ComparableConstant)other).getConstant().getClass()) && + this.compareTo(other) == 0; + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } +} diff --git a/src/proguard/classfile/editor/ConstantAdder.java b/src/proguard/classfile/editor/ConstantAdder.java new file mode 100644 index 0000000..2b74f5f --- /dev/null +++ b/src/proguard/classfile/editor/ConstantAdder.java @@ -0,0 +1,194 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This ConstantVisitor adds all constants that it visits to the constant pool + * of a given target class. + * + * @author Eric Lafortune + */ +public class ConstantAdder +implements ConstantVisitor +{ + private final ConstantPoolEditor constantPoolEditor; + + private int constantIndex; + + + /** + * Creates a new ConstantAdder that will copy constants into the given + * target class. + */ + public ConstantAdder(ProgramClass targetClass) + { + constantPoolEditor = new ConstantPoolEditor(targetClass); + } + + + /** + * Adds a copy of the specified constant in the given class and returns + * its index. If the specified index is 0, the returned value is 0 too. + */ + public int addConstant(Clazz clazz, int constantIndex) + { + clazz.constantPoolEntryAccept(constantIndex, this); + + return this.constantIndex; + } + + + /** + * Adds a copy of the given constant in the given class and returns + * its index. + */ + public int addConstant(Clazz clazz, Constant constant) + { + constant.accept(clazz, this); + + return this.constantIndex; + } + + + /** + * Returns the index of the most recently created constant in the constant + * pool of the target class. + */ + public int getConstantIndex() + { + return constantIndex; + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + constantIndex = + constantPoolEditor.addIntegerConstant(integerConstant.getValue()); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + constantIndex = + constantPoolEditor.addLongConstant(longConstant.getValue()); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + constantIndex = + constantPoolEditor.addFloatConstant(floatConstant.getValue()); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + constantIndex = + constantPoolEditor.addDoubleConstant(doubleConstant.getValue()); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + constantIndex = + constantPoolEditor.addStringConstant(stringConstant.getString(clazz), + stringConstant.referencedClass, + stringConstant.referencedMember); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + constantIndex = + constantPoolEditor.addUtf8Constant(utf8Constant.getString()); + } + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + // First add the referenced class constant, with its own referenced class. + clazz.constantPoolEntryAccept(fieldrefConstant.u2classIndex, this); + + // Then add the actual field reference constant, with its referenced + // class and class member. + constantIndex = + constantPoolEditor.addFieldrefConstant(constantIndex, + fieldrefConstant.getName(clazz), + fieldrefConstant.getType(clazz), + fieldrefConstant.referencedClass, + fieldrefConstant.referencedMember); + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + // First add the referenced class constant, with its own referenced class. + clazz.constantPoolEntryAccept(interfaceMethodrefConstant.u2classIndex, this); + + // Then add the actual interface method reference constant, with its + // referenced class and class member. + constantIndex = + constantPoolEditor.addInterfaceMethodrefConstant(constantIndex, + interfaceMethodrefConstant.getName(clazz), + interfaceMethodrefConstant.getType(clazz), + interfaceMethodrefConstant.referencedClass, + interfaceMethodrefConstant.referencedMember); + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + // First add the referenced class constant, with its own referenced class. + clazz.constantPoolEntryAccept(methodrefConstant.u2classIndex, this); + + // Then add the actual method reference constant, with its referenced + // class and class member. + constantIndex = + constantPoolEditor.addMethodrefConstant(constantIndex, + methodrefConstant.getName(clazz), + methodrefConstant.getType(clazz), + methodrefConstant.referencedClass, + methodrefConstant.referencedMember); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Add the class constant, with its referenced class.. + constantIndex = + constantPoolEditor.addClassConstant(classConstant.getName(clazz), + classConstant.referencedClass); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + constantIndex = + constantPoolEditor.addNameAndTypeConstant(nameAndTypeConstant.getName(clazz), + nameAndTypeConstant.getType(clazz)); + } +} diff --git a/src/proguard/classfile/editor/ConstantPoolEditor.java b/src/proguard/classfile/editor/ConstantPoolEditor.java new file mode 100644 index 0000000..8663dee --- /dev/null +++ b/src/proguard/classfile/editor/ConstantPoolEditor.java @@ -0,0 +1,665 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.constant.*; + +/** + * This class can add constant pool entries to a given class. + * + * @author Eric Lafortune + */ +public class ConstantPoolEditor +{ + private static final boolean DEBUG = false; + + private ProgramClass targetClass; + + + /** + * Creates a new ConstantPoolEditor that will edit constants in the given + * target class. + */ + public ConstantPoolEditor(ProgramClass targetClass) + { + this.targetClass = targetClass; + } + + + /** + * Finds or creates a IntegerConstant constant pool entry with the given + * value. + * @return the constant pool index of the Utf8Constant. + */ + public int addIntegerConstant(int value) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Integer) + { + IntegerConstant integerConstant = (IntegerConstant)constant; + if (integerConstant.getValue() == value) + { + return index; + } + } + } + + return addConstant(new IntegerConstant(value)); + } + + + /** + * Finds or creates a LongConstant constant pool entry with the given value. + * @return the constant pool index of the LongConstant. + */ + public int addLongConstant(long value) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Long) + { + LongConstant longConstant = (LongConstant)constant; + if (longConstant.getValue() == value) + { + return index; + } + } + } + + return addConstant(new LongConstant(value)); + } + + + /** + * Finds or creates a FloatConstant constant pool entry with the given + * value. + * @return the constant pool index of the FloatConstant. + */ + public int addFloatConstant(float value) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Float) + { + FloatConstant floatConstant = (FloatConstant)constant; + if (floatConstant.getValue() == value) + { + return index; + } + } + } + + return addConstant(new FloatConstant(value)); + } + + + /** + * Finds or creates a DoubleConstant constant pool entry with the given + * value. + * @return the constant pool index of the DoubleConstant. + */ + public int addDoubleConstant(double value) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Double) + { + DoubleConstant doubleConstant = (DoubleConstant)constant; + if (doubleConstant.getValue() == value) + { + return index; + } + } + } + + return addConstant(new DoubleConstant(value)); + } + + + /** + * Finds or creates a StringConstant constant pool entry with the given + * value. + * @return the constant pool index of the StringConstant. + */ + public int addStringConstant(String string, + Clazz referencedClass, + Member referencedMember) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_String) + { + StringConstant stringConstant = (StringConstant)constant; + if (stringConstant.getString(targetClass).equals(string)) + { + return index; + } + } + } + + return addConstant(new StringConstant(addUtf8Constant(string), + referencedClass, + referencedMember)); + } + + + /** + * Finds or creates a FieldrefConstant constant pool entry for the given + * class and field. + * @return the constant pool index of the FieldrefConstant. + */ + public int addFieldrefConstant(Clazz referencedClass, + Member referencedMember) + { + return addFieldrefConstant(referencedClass.getName(), + referencedMember.getName(referencedClass), + referencedMember.getDescriptor(referencedClass), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a FieldrefConstant constant pool entry with the given + * class name, field name, and descriptor. + * @return the constant pool index of the FieldrefConstant. + */ + public int addFieldrefConstant(String className, + String name, + String descriptor, + Clazz referencedClass, + Member referencedMember) + { + return addFieldrefConstant(className, + addNameAndTypeConstant(name, descriptor), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a FieldrefConstant constant pool entry with the given + * class name, field name, and descriptor. + * @return the constant pool index of the FieldrefConstant. + */ + public int addFieldrefConstant(String className, + int nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + return addFieldrefConstant(addClassConstant(className, referencedClass), + nameAndTypeIndex, + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a FieldrefConstant constant pool entry with the given + * class constant pool entry index, field name, and descriptor. + * @return the constant pool index of the FieldrefConstant. + */ + public int addFieldrefConstant(int classIndex, + String name, + String descriptor, + Clazz referencedClass, + Member referencedMember) + { + return addFieldrefConstant(classIndex, + addNameAndTypeConstant(name, descriptor), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a FieldrefConstant constant pool entry with the given + * class constant pool entry index and name and type constant pool entry + * index. + * @return the constant pool index of the FieldrefConstant. + */ + public int addFieldrefConstant(int classIndex, + int nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Fieldref) + { + FieldrefConstant fieldrefConstant = (FieldrefConstant)constant; + if (fieldrefConstant.u2classIndex == classIndex && + fieldrefConstant.u2nameAndTypeIndex == nameAndTypeIndex) + { + return index; + } + } + } + + return addConstant(new FieldrefConstant(classIndex, + nameAndTypeIndex, + referencedClass, + referencedMember)); + } + + + /** + * Finds or creates a InterfaceMethodrefConstant constant pool entry with the + * given class name, method name, and descriptor. + * @return the constant pool index of the InterfaceMethodrefConstant. + */ + public int addInterfaceMethodrefConstant(String className, + String name, + String descriptor, + Clazz referencedClass, + Member referencedMember) + { + return addInterfaceMethodrefConstant(className, + addNameAndTypeConstant(name, descriptor), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a InterfaceMethodrefConstant constant pool entry with the + * given class name, method name, and descriptor. + * @return the constant pool index of the InterfaceMethodrefConstant. + */ + public int addInterfaceMethodrefConstant(String className, + int nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + return addInterfaceMethodrefConstant(addClassConstant(className, referencedClass), + nameAndTypeIndex, + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a InterfaceMethodrefConstant constant pool entry for the + * given class and method. + * @return the constant pool index of the InterfaceMethodrefConstant. + */ + public int addInterfaceMethodrefConstant(Clazz referencedClass, + Member referencedMember) + { + return addInterfaceMethodrefConstant(referencedClass.getName(), + referencedMember.getName(referencedClass), + referencedMember.getDescriptor(referencedClass), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a InterfaceMethodrefConstant constant pool entry with the + * given class constant pool entry index, method name, and descriptor. + * @return the constant pool index of the InterfaceMethodrefConstant. + */ + public int addInterfaceMethodrefConstant(int classIndex, + String name, + String descriptor, + Clazz referencedClass, + Member referencedMember) + { + return addInterfaceMethodrefConstant(classIndex, + addNameAndTypeConstant(name, descriptor), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a InterfaceMethodrefConstant constant pool entry with the + * given class constant pool entry index and name and type constant pool + * entry index. + * @return the constant pool index of the InterfaceMethodrefConstant. + */ + public int addInterfaceMethodrefConstant(int classIndex, + int nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_InterfaceMethodref) + { + InterfaceMethodrefConstant methodrefConstant = (InterfaceMethodrefConstant)constant; + if (methodrefConstant.u2classIndex == classIndex && + methodrefConstant.u2nameAndTypeIndex == nameAndTypeIndex) + { + return index; + } + } + } + + return addConstant(new InterfaceMethodrefConstant(classIndex, + nameAndTypeIndex, + referencedClass, + referencedMember)); + } + + + /** + * Finds or creates a MethodrefConstant constant pool entry for the given + * class and method. + * @return the constant pool index of the MethodrefConstant. + */ + public int addMethodrefConstant(Clazz referencedClass, + Member referencedMember) + { + return addMethodrefConstant(referencedClass.getName(), + referencedMember.getName(referencedClass), + referencedMember.getDescriptor(referencedClass), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a MethodrefConstant constant pool entry with the given + * class name, method name, and descriptor. + * @return the constant pool index of the MethodrefConstant. + */ + public int addMethodrefConstant(String className, + String name, + String descriptor, + Clazz referencedClass, + Member referencedMember) + { + return addMethodrefConstant(className, + addNameAndTypeConstant(name, descriptor), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a MethodrefConstant constant pool entry with the given + * class name, method name, and descriptor. + * @return the constant pool index of the MethodrefConstant. + */ + public int addMethodrefConstant(String className, + int nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + return addMethodrefConstant(addClassConstant(className, referencedClass), + nameAndTypeIndex, + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a MethodrefConstant constant pool entry with the given + * class constant pool entry index, method name, and descriptor. + * @return the constant pool index of the MethodrefConstant. + */ + public int addMethodrefConstant(int classIndex, + String name, + String descriptor, + Clazz referencedClass, + Member referencedMember) + { + return addMethodrefConstant(classIndex, + addNameAndTypeConstant(name, descriptor), + referencedClass, + referencedMember); + } + + + /** + * Finds or creates a MethodrefConstant constant pool entry with the given + * class constant pool entry index and name and type constant pool entry + * index. + * @return the constant pool index of the MethodrefConstant. + */ + public int addMethodrefConstant(int classIndex, + int nameAndTypeIndex, + Clazz referencedClass, + Member referencedMember) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Methodref) + { + MethodrefConstant methodrefConstant = (MethodrefConstant)constant; + if (methodrefConstant.u2classIndex == classIndex && + methodrefConstant.u2nameAndTypeIndex == nameAndTypeIndex) + { + return index; + } + } + } + + return addConstant(new MethodrefConstant(classIndex, + nameAndTypeIndex, + referencedClass, + referencedMember)); + } + + + /** + * Finds or creates a ClassConstant constant pool entry for the given class. + * @return the constant pool index of the ClassConstant. + */ + public int addClassConstant(Clazz referencedClass) + { + return addClassConstant(referencedClass.getName(), + referencedClass); + } + + + /** + * Finds or creates a ClassConstant constant pool entry with the given name. + * @return the constant pool index of the ClassConstant. + */ + public int addClassConstant(String name, + Clazz referencedClass) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Class) + { + ClassConstant classConstant = (ClassConstant)constant; + if (classConstant.getName(targetClass).equals(name)) + { + return index; + } + } + } + + int nameIndex = addUtf8Constant(name); + + return addConstant(new ClassConstant(nameIndex, referencedClass)); + } + + + /** + * Finds or creates a NameAndTypeConstant constant pool entry with the given + * name and type. + * @return the constant pool index of the NameAndTypeConstant. + */ + public int addNameAndTypeConstant(String name, + String type) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_NameAndType) + { + NameAndTypeConstant nameAndTypeConstant = (NameAndTypeConstant)constant; + if (nameAndTypeConstant.getName(targetClass).equals(name) && + nameAndTypeConstant.getType(targetClass).equals(type)) + { + return index; + } + } + } + + return addConstant(new NameAndTypeConstant(addUtf8Constant(name), + addUtf8Constant(type))); + } + + + /** + * Finds or creates a Utf8Constant constant pool entry for the given string. + * @return the constant pool index of the Utf8Constant. + */ + public int addUtf8Constant(String string) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Check if the entry already exists. + for (int index = 1; index < constantPoolCount; index++) + { + Constant constant = constantPool[index]; + + if (constant != null && + constant.getTag() == ClassConstants.CONSTANT_Utf8) + { + Utf8Constant utf8Constant = (Utf8Constant)constant; + if (utf8Constant.getString().equals(string)) + { + return index; + } + } + } + + return addConstant(new Utf8Constant(string)); + } + + + /** + * Adds a given constant pool entry to the end of the constant pool/ + * @return the constant pool index for the added entry. + */ + public int addConstant(Constant constant) + { + int constantPoolCount = targetClass.u2constantPoolCount; + Constant[] constantPool = targetClass.constantPool; + + // Make sure there is enough space for another constant pool entry. + if (constantPool.length < constantPoolCount+2) + { + targetClass.constantPool = new Constant[constantPoolCount+2]; + System.arraycopy(constantPool, 0, + targetClass.constantPool, 0, + constantPoolCount); + constantPool = targetClass.constantPool; + } + + if (DEBUG) + { + System.out.println(targetClass.getName()+": adding ["+constant.getClass().getName()+"] at index "+targetClass.u2constantPoolCount); + } + + // Create a new Utf8Constant for the given string. + constantPool[targetClass.u2constantPoolCount++] = constant; + + // Long constants and double constants take up two entries in the + // constant pool. + int tag = constant.getTag(); + if (tag == ClassConstants.CONSTANT_Long || + tag == ClassConstants.CONSTANT_Double) + { + constantPool[targetClass.u2constantPoolCount++] = null; + } + + return constantPoolCount; + } +} diff --git a/src/proguard/classfile/editor/ConstantPoolRemapper.java b/src/proguard/classfile/editor/ConstantPoolRemapper.java new file mode 100644 index 0000000..7430d3d --- /dev/null +++ b/src/proguard/classfile/editor/ConstantPoolRemapper.java @@ -0,0 +1,617 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor remaps all possible references to constant pool entries + * of the classes that it visits, based on a given index map. It is assumed that + * the constant pool entries themselves have already been remapped. + * + * @author Eric Lafortune + */ +public class ConstantPoolRemapper +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor, + AttributeVisitor, + InstructionVisitor, + InnerClassesInfoVisitor, + ExceptionInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + private int[] constantIndexMap; + + + /** + * Sets the given mapping of old constant pool entry indexes to their new + * indexes. + */ + public void setConstantIndexMap(int[] constantIndexMap) + { + this.constantIndexMap = constantIndexMap; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Remap the local constant pool references. + programClass.u2thisClass = remapConstantIndex(programClass.u2thisClass); + programClass.u2superClass = remapConstantIndex(programClass.u2superClass); + + remapConstantIndexArray(programClass.u2interfaces, + programClass.u2interfacesCount); + + // Remap the references of the contant pool entries themselves. + programClass.constantPoolEntriesAccept(this); + + // Remap the references in all fields, methods, and attributes. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.u2nameIndex = + remapConstantIndex(classConstant.u2nameIndex); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + // Nothing to do. + } + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + fieldrefConstant.u2classIndex = + remapConstantIndex(fieldrefConstant.u2classIndex); + fieldrefConstant.u2nameAndTypeIndex = + remapConstantIndex(fieldrefConstant.u2nameAndTypeIndex); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + // Nothing to do. + } + + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + // Nothing to do. + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + interfaceMethodrefConstant.u2classIndex = + remapConstantIndex(interfaceMethodrefConstant.u2classIndex); + interfaceMethodrefConstant.u2nameAndTypeIndex = + remapConstantIndex(interfaceMethodrefConstant.u2nameAndTypeIndex); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + // Nothing to do. + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + methodrefConstant.u2classIndex = + remapConstantIndex(methodrefConstant.u2classIndex); + methodrefConstant.u2nameAndTypeIndex = + remapConstantIndex(methodrefConstant.u2nameAndTypeIndex); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + nameAndTypeConstant.u2nameIndex = + remapConstantIndex(nameAndTypeConstant.u2nameIndex); + nameAndTypeConstant.u2descriptorIndex = + remapConstantIndex(nameAndTypeConstant.u2descriptorIndex); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + stringConstant.u2stringIndex = + remapConstantIndex(stringConstant.u2stringIndex); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + // Nothing to do. + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + visitMember(programClass, programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + visitMember(programClass, programMethod); + } + + + private void visitMember(ProgramClass programClass, ProgramMember programMember) + { + // Remap the local constant pool references. + programMember.u2nameIndex = + remapConstantIndex(programMember.u2nameIndex); + programMember.u2descriptorIndex = + remapConstantIndex(programMember.u2descriptorIndex); + + // Remap the constant pool references of the remaining attributes. + programMember.attributesAccept(programClass, this); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + // Library classes are left unchanged. + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Library classes are left unchanged. + } + + + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + unknownAttribute.u2attributeNameIndex = + remapConstantIndex(unknownAttribute.u2attributeNameIndex); + + // There's not much else we can do with unknown attributes. + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + sourceFileAttribute.u2attributeNameIndex = + remapConstantIndex(sourceFileAttribute.u2attributeNameIndex); + sourceFileAttribute.u2sourceFileIndex = + remapConstantIndex(sourceFileAttribute.u2sourceFileIndex); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + sourceDirAttribute.u2attributeNameIndex = + remapConstantIndex(sourceDirAttribute.u2attributeNameIndex); + sourceDirAttribute.u2sourceDirIndex = + remapConstantIndex(sourceDirAttribute.u2sourceDirIndex); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + innerClassesAttribute.u2attributeNameIndex = + remapConstantIndex(innerClassesAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the inner classes. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + enclosingMethodAttribute.u2attributeNameIndex = + remapConstantIndex(enclosingMethodAttribute.u2attributeNameIndex); + enclosingMethodAttribute.u2classIndex = + remapConstantIndex(enclosingMethodAttribute.u2classIndex); + enclosingMethodAttribute.u2nameAndTypeIndex = + remapConstantIndex(enclosingMethodAttribute.u2nameAndTypeIndex); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + deprecatedAttribute.u2attributeNameIndex = + remapConstantIndex(deprecatedAttribute.u2attributeNameIndex); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + syntheticAttribute.u2attributeNameIndex = + remapConstantIndex(syntheticAttribute.u2attributeNameIndex); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + signatureAttribute.u2attributeNameIndex = + remapConstantIndex(signatureAttribute.u2attributeNameIndex); + signatureAttribute.u2signatureIndex = + remapConstantIndex(signatureAttribute.u2signatureIndex); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + constantValueAttribute.u2attributeNameIndex = + remapConstantIndex(constantValueAttribute.u2attributeNameIndex); + constantValueAttribute.u2constantValueIndex = + remapConstantIndex(constantValueAttribute.u2constantValueIndex); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + exceptionsAttribute.u2attributeNameIndex = + remapConstantIndex(exceptionsAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the exceptions. + remapConstantIndexArray(exceptionsAttribute.u2exceptionIndexTable, + exceptionsAttribute.u2exceptionIndexTableLength); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + codeAttribute.u2attributeNameIndex = + remapConstantIndex(codeAttribute.u2attributeNameIndex); + + // Initially, the code attribute editor doesn't contain any changes. + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + // Remap the constant pool references of the instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Apply the code atribute editor. It will only contain any changes if + // the code length is changing at any point. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + + // Remap the constant pool references of the exceptions and attributes. + codeAttribute.exceptionsAccept(clazz, method, this); + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + stackMapAttribute.u2attributeNameIndex = + remapConstantIndex(stackMapAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the stack map frames. + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + stackMapTableAttribute.u2attributeNameIndex = + remapConstantIndex(stackMapTableAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the stack map frames. + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + lineNumberTableAttribute.u2attributeNameIndex = + remapConstantIndex(lineNumberTableAttribute.u2attributeNameIndex); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + localVariableTableAttribute.u2attributeNameIndex = + remapConstantIndex(localVariableTableAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + localVariableTypeTableAttribute.u2attributeNameIndex = + remapConstantIndex(localVariableTypeTableAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the local variables. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + annotationsAttribute.u2attributeNameIndex = + remapConstantIndex(annotationsAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + parameterAnnotationsAttribute.u2attributeNameIndex = + remapConstantIndex(parameterAnnotationsAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + annotationDefaultAttribute.u2attributeNameIndex = + remapConstantIndex(annotationDefaultAttribute.u2attributeNameIndex); + + // Remap the constant pool references of the annotations. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + if (innerClassesInfo.u2innerClassIndex != 0) + { + innerClassesInfo.u2innerClassIndex = + remapConstantIndex(innerClassesInfo.u2innerClassIndex); + } + + if (innerClassesInfo.u2outerClassIndex != 0) + { + innerClassesInfo.u2outerClassIndex = + remapConstantIndex(innerClassesInfo.u2outerClassIndex); + } + + if (innerClassesInfo.u2innerNameIndex != 0) + { + innerClassesInfo.u2innerNameIndex = + remapConstantIndex(innerClassesInfo.u2innerNameIndex); + } + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + if (exceptionInfo.u2catchType != 0) + { + exceptionInfo.u2catchType = + remapConstantIndex(exceptionInfo.u2catchType); + } + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Is the new constant pool index different from the original one? + int newConstantIndex = remapConstantIndex(constantInstruction.constantIndex); + if (newConstantIndex != constantInstruction.constantIndex) + { + // Replace the instruction. + Instruction replacementInstruction = + new ConstantInstruction(constantInstruction.opcode, + newConstantIndex, + constantInstruction.constant).shrink(); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + } + } + + + // Implementations for StackMapFrameVisitor. + + public void visitAnyStackMapFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrame stackMapFrame) {} + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + // Remap the constant pool references of the verification types. + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + // Remap the constant pool references of the verification types. + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + // Remap the constant pool references of the verification types. + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) {} + + + public void visitObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType) + { + objectType.u2classIndex = + remapConstantIndex(objectType.u2classIndex); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + localVariableInfo.u2nameIndex = + remapConstantIndex(localVariableInfo.u2nameIndex); + localVariableInfo.u2descriptorIndex = + remapConstantIndex(localVariableInfo.u2descriptorIndex); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + localVariableTypeInfo.u2nameIndex = + remapConstantIndex(localVariableTypeInfo.u2nameIndex); + localVariableTypeInfo.u2signatureIndex = + remapConstantIndex(localVariableTypeInfo.u2signatureIndex); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + annotation.u2typeIndex = + remapConstantIndex(annotation.u2typeIndex); + + // Remap the constant pool references of the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + constantElementValue.u2elementNameIndex = + remapConstantIndex(constantElementValue.u2elementNameIndex); + constantElementValue.u2constantValueIndex = + remapConstantIndex(constantElementValue.u2constantValueIndex); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + enumConstantElementValue.u2elementNameIndex = + remapConstantIndex(enumConstantElementValue.u2elementNameIndex); + enumConstantElementValue.u2typeNameIndex = + remapConstantIndex(enumConstantElementValue.u2typeNameIndex); + enumConstantElementValue.u2constantNameIndex = + remapConstantIndex(enumConstantElementValue.u2constantNameIndex); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + classElementValue.u2elementNameIndex = + remapConstantIndex(classElementValue.u2elementNameIndex); + classElementValue.u2classInfoIndex = + remapConstantIndex(classElementValue.u2classInfoIndex); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + annotationElementValue.u2elementNameIndex = + remapConstantIndex(annotationElementValue.u2elementNameIndex); + + // Remap the constant pool references of the annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + arrayElementValue.u2elementNameIndex = + remapConstantIndex(arrayElementValue.u2elementNameIndex); + + // Remap the constant pool references of the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + // Small utility methods. + + /** + * Remaps all constant pool indices in the given array. + */ + private void remapConstantIndexArray(int[] array, int length) + { + for (int index = 0; index < length; index++) + { + array[index] = remapConstantIndex(array[index]); + } + } + + + /** + * Returns the new constant pool index of the entry at the + * given index. + */ + private int remapConstantIndex(int constantIndex) + { + return constantIndexMap[constantIndex]; + } +} diff --git a/src/proguard/classfile/editor/ConstantPoolSorter.java b/src/proguard/classfile/editor/ConstantPoolSorter.java new file mode 100644 index 0000000..faae318 --- /dev/null +++ b/src/proguard/classfile/editor/ConstantPoolSorter.java @@ -0,0 +1,126 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.constant.Constant; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +import java.util.Arrays; + +/** + * This ClassVisitor sorts the constant pool entries of the program classes + * that it visits. The sorting order is based on the types of the constant pool + * entries in the first place, and on their contents in the second place. + * + * @author Eric Lafortune + */ +public class ConstantPoolSorter +extends SimplifiedVisitor +implements ClassVisitor +{ + private int[] constantIndexMap = new int[ClassConstants.TYPICAL_CONSTANT_POOL_SIZE]; + private ComparableConstant[] comparableConstantPool = new ComparableConstant[ClassConstants.TYPICAL_CONSTANT_POOL_SIZE]; + private Constant[] newConstantPool = new Constant[ClassConstants.TYPICAL_CONSTANT_POOL_SIZE]; + + private final ConstantPoolRemapper constantPoolRemapper = new ConstantPoolRemapper(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + int constantPoolCount = programClass.u2constantPoolCount; + + // Sort the constant pool and set up an index map. + if (constantIndexMap.length < constantPoolCount) + { + constantIndexMap = new int[constantPoolCount]; + comparableConstantPool = new ComparableConstant[constantPoolCount]; + newConstantPool = new Constant[constantPoolCount]; + } + + // Initialize an array whose elements can be compared. + int sortLength = 0; + for (int oldIndex = 1; oldIndex < constantPoolCount; oldIndex++) + { + Constant constant = programClass.constantPool[oldIndex]; + if (constant != null) + { + comparableConstantPool[sortLength++] = + new ComparableConstant(programClass, oldIndex, constant); + } + } + + // Sort the array. + Arrays.sort(comparableConstantPool, 0, sortLength); + + // Save the sorted elements. + int newLength = 1; + int newIndex = 1; + ComparableConstant previousComparableConstant = null; + for (int sortIndex = 0; sortIndex < sortLength; sortIndex++) + { + ComparableConstant comparableConstant = comparableConstantPool[sortIndex]; + + // Isn't this a duplicate of the previous constant? + if (!comparableConstant.equals(previousComparableConstant)) + { + // Remember the index of the new entry. + newIndex = newLength; + + // Copy the sorted constant pool entry over to the constant pool. + Constant constant = comparableConstant.getConstant(); + + newConstantPool[newLength++] = constant; + + // Long entries take up two slots, the second of which is null. + int tag = constant.getTag(); + if (tag == ClassConstants.CONSTANT_Long || + tag == ClassConstants.CONSTANT_Double) + { + newConstantPool[newLength++] = null; + } + + previousComparableConstant = comparableConstant; + } + + // Fill out the map array. + constantIndexMap[comparableConstant.getIndex()] = newIndex; + } + + // Copy the new constant pool over. + System.arraycopy(newConstantPool, 0, programClass.constantPool, 0, newLength); + + // Clear any remaining entries. + for (int index = newLength; index < constantPoolCount; index++) + { + programClass.constantPool[index] = null; + } + + programClass.u2constantPoolCount = newLength; + + // Remap all constant pool references. + constantPoolRemapper.setConstantIndexMap(constantIndexMap); + constantPoolRemapper.visitProgramClass(programClass); + } +} diff --git a/src/proguard/classfile/editor/ElementValueAdder.java b/src/proguard/classfile/editor/ElementValueAdder.java new file mode 100644 index 0000000..8cbd11d --- /dev/null +++ b/src/proguard/classfile/editor/ElementValueAdder.java @@ -0,0 +1,217 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; + +/** + * This AnnotationVisitor adds all element values that it visits to the given + * target annotation default attribute, annotation, or element value. + * + * @author Eric Lafortune + */ +public class ElementValueAdder +implements ElementValueVisitor +{ + private static final ElementValue[] EMPTY_ELEMENT_VALUES = new ElementValue[0]; + + + private final ProgramClass targetClass; + private final AnnotationDefaultAttribute targetAnnotationDefaultAttribute; + + private final ConstantAdder constantAdder; + private final ElementValuesEditor elementValuesEditor; + + + /** + * Creates a new ElementValueAdder that will copy element values into the + * given target annotation default attribute value. + */ + public ElementValueAdder(ProgramClass targetClass, + AnnotationDefaultAttribute targetAnnotationDefaultAttribute, + boolean replaceElementValues) + { + this.targetClass = targetClass; + this.targetAnnotationDefaultAttribute = targetAnnotationDefaultAttribute; + + constantAdder = new ConstantAdder(targetClass); + elementValuesEditor = null; + } + + + /** + * Creates a new ElementValueAdder that will copy element values into the + * given target annotation. + */ + public ElementValueAdder(ProgramClass targetClass, + Annotation targetAnnotation, + boolean replaceElementValues) + { + this.targetClass = targetClass; + this.targetAnnotationDefaultAttribute = null; + + constantAdder = new ConstantAdder(targetClass); + elementValuesEditor = new ElementValuesEditor(targetClass, + targetAnnotation, + replaceElementValues); + } + + + /** + * Creates a new ElementValueAdder that will copy element values into the + * given target element value. + */ + public ElementValueAdder(ProgramClass targetClass, + ArrayElementValue targetArrayElementValue, + boolean replaceElementValues) + { + this.targetClass = targetClass; + this.targetAnnotationDefaultAttribute = null; + + constantAdder = new ConstantAdder(targetClass); + elementValuesEditor = new ElementValuesEditor(targetClass, + targetArrayElementValue, + replaceElementValues); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + // Create a copy of the element value. + ConstantElementValue newConstantElementValue = + new ConstantElementValue(constantElementValue.u1tag, + constantElementValue.u2elementNameIndex == 0 ? 0 : + constantAdder.addConstant(clazz, constantElementValue.u2elementNameIndex), + constantAdder.addConstant(clazz, constantElementValue.u2constantValueIndex)); + + newConstantElementValue.referencedClass = constantElementValue.referencedClass; + newConstantElementValue.referencedMethod = constantElementValue.referencedMethod; + + // Add it to the target. + addElementValue(newConstantElementValue); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + // Create a copy of the element value. + EnumConstantElementValue newEnumConstantElementValue = + new EnumConstantElementValue(enumConstantElementValue.u2elementNameIndex == 0 ? 0 : + constantAdder.addConstant(clazz, enumConstantElementValue.u2elementNameIndex), + constantAdder.addConstant(clazz, enumConstantElementValue.u2typeNameIndex), + constantAdder.addConstant(clazz, enumConstantElementValue.u2constantNameIndex)); + + newEnumConstantElementValue.referencedClass = enumConstantElementValue.referencedClass; + newEnumConstantElementValue.referencedMethod = enumConstantElementValue.referencedMethod; + + // TODO: Clone array. + newEnumConstantElementValue.referencedClasses = enumConstantElementValue.referencedClasses; + + // Add it to the target. + addElementValue(newEnumConstantElementValue); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + // Create a copy of the element value. + ClassElementValue newClassElementValue = + new ClassElementValue(classElementValue.u2elementNameIndex == 0 ? 0 : + constantAdder.addConstant(clazz, classElementValue.u2elementNameIndex), + constantAdder.addConstant(clazz, classElementValue.u2classInfoIndex)); + + newClassElementValue.referencedClass = classElementValue.referencedClass; + newClassElementValue.referencedMethod = classElementValue.referencedMethod; + + // TODO: Clone array. + newClassElementValue.referencedClasses = classElementValue.referencedClasses; + + // Add it to the target. + addElementValue(newClassElementValue); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + // Create a copy of the element value. + AnnotationElementValue newAnnotationElementValue = + new AnnotationElementValue(annotationElementValue.u2elementNameIndex == 0 ? 0 : + constantAdder.addConstant(clazz, annotationElementValue.u2elementNameIndex), + new Annotation()); + + newAnnotationElementValue.referencedClass = annotationElementValue.referencedClass; + newAnnotationElementValue.referencedMethod = annotationElementValue.referencedMethod; + + annotationElementValue.annotationAccept(clazz, + new AnnotationAdder(targetClass, + newAnnotationElementValue)); + + // Add it to the target. + addElementValue(newAnnotationElementValue); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Create a copy of the element value. + ArrayElementValue newArrayElementValue = + new ArrayElementValue(arrayElementValue.u2elementNameIndex == 0 ? 0 : + constantAdder.addConstant(clazz, arrayElementValue.u2elementNameIndex), + 0, + arrayElementValue.u2elementValuesCount > 0 ? + new ElementValue[arrayElementValue.u2elementValuesCount] : + EMPTY_ELEMENT_VALUES); + + newArrayElementValue.referencedClass = arrayElementValue.referencedClass; + newArrayElementValue.referencedMethod = arrayElementValue.referencedMethod; + + arrayElementValue.elementValuesAccept(clazz, + annotation, + new ElementValueAdder(targetClass, + newArrayElementValue, + false)); + + // Add it to the target. + addElementValue(newArrayElementValue); + } + + + // Small utility methods. + + private void addElementValue(ElementValue newElementValue) + { + // What's the target? + if (targetAnnotationDefaultAttribute != null) + { + // Simply set the completed element value. + targetAnnotationDefaultAttribute.defaultValue = newElementValue; + } + else + { + // Add it to the target. + elementValuesEditor.addElementValue(newElementValue); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/ElementValuesEditor.java b/src/proguard/classfile/editor/ElementValuesEditor.java new file mode 100644 index 0000000..bfc4e9f --- /dev/null +++ b/src/proguard/classfile/editor/ElementValuesEditor.java @@ -0,0 +1,238 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.annotation.*; + +/** + * This class can add and delete element values to and from a given target + * annotation default attribute, annotation, or array element value. Element + * values to be added must be filled out beforehand, including their references + * to the constant pool. + * + * @author Eric Lafortune + */ +public class ElementValuesEditor +{ + private final ProgramClass targetClass; + private final Annotation targetAnnotation; + private final ArrayElementValue targetArrayElementValue; + private final boolean replaceElementValues; + + + /** + * Creates a new ElementValuesEditor that will edit element values in the + * given target annotation. + */ + public ElementValuesEditor(ProgramClass targetClass, + Annotation targetAnnotation, + boolean replaceElementValues) + { + this.targetClass = targetClass; + this.targetAnnotation = targetAnnotation; + this.targetArrayElementValue = null; + this.replaceElementValues = replaceElementValues; + } + + + /** + * Creates a new ElementValuesEditor that will edit element values in the + * given target array element value. + */ + public ElementValuesEditor(ProgramClass targetClass, + ArrayElementValue targetArrayElementValue, + boolean replaceElementValues) + { + this.targetClass = targetClass; + this.targetAnnotation = null; + this.targetArrayElementValue = targetArrayElementValue; + this.replaceElementValues = replaceElementValues; + } + + + /** + * Adds the given elementValue to the target. + */ + public void addElementValue(ElementValue elementValue) + { + // What's the target? + if (targetAnnotation != null) + { + // Try to replace an existing element value. + if (!replaceElementValues || + !replaceElementValue(targetAnnotation.u2elementValuesCount, + targetAnnotation.elementValues, + elementValue)) + { + // Otherwise append the element value. + targetAnnotation.elementValues = + addElementValue(targetAnnotation.u2elementValuesCount, + targetAnnotation.elementValues, + elementValue); + + targetAnnotation.u2elementValuesCount++; + } + } + else + { + // Try to replace an existing element value. + if (!replaceElementValues || + !replaceElementValue(targetArrayElementValue.u2elementValuesCount, + targetArrayElementValue.elementValues, + elementValue)) + { + // Otherwise append the element value. + targetArrayElementValue.elementValues = + addElementValue(targetArrayElementValue.u2elementValuesCount, + targetArrayElementValue.elementValues, + elementValue); + + targetArrayElementValue.u2elementValuesCount++; + } + } + } + + + /** + * Deletes the given elementValue to the target. + */ + public void deleteElementValue(String elementValueMethodName) + { + // What's the target? + if (targetAnnotation != null) + { + // Delete the element value to the target annotation. + targetAnnotation.u2elementValuesCount = + deleteElementValue(targetAnnotation.u2elementValuesCount, + targetAnnotation.elementValues, + elementValueMethodName); + } + else + { + // Delete the element value to the target array element value. + targetArrayElementValue.u2elementValuesCount = + deleteElementValue(targetArrayElementValue.u2elementValuesCount, + targetArrayElementValue.elementValues, + elementValueMethodName); + } + } + + + // Small utility methods. + + /** + * Tries put the given element value in place of an existing element value + * of the same name, returning whether it was present. + */ + private boolean replaceElementValue(int elementValuesCount, + ElementValue[] elementValues, + ElementValue elementValue) + { + // Find the element value with the same name. + int index = findElementValue(elementValuesCount, + elementValues, + elementValue.getMethodName(targetClass)); + if (index < 0) + { + return false; + } + + elementValues[index] = elementValue; + + return true; + } + + + /** + * Appends the given element value to the given array of element values, + * creating a new array if necessary. + */ + private ElementValue[] addElementValue(int elementValuesCount, + ElementValue[] elementValues, + ElementValue elementValue) + { + // Is the array too small to contain the additional elementValue? + if (elementValues.length <= elementValuesCount) + { + // Create a new array and copy the elementValues into it. + ElementValue[] newElementValues = new ElementValue[elementValuesCount + 1]; + System.arraycopy(elementValues, 0, + newElementValues, 0, + elementValuesCount); + elementValues = newElementValues; + } + + // Append the elementValue. + elementValues[elementValuesCount] = elementValue; + + return elementValues; + } + + + /** + * Deletes the element values with the given name from the given array of + * element values, returning the new number of element values. + */ + private int deleteElementValue(int elementValuesCount, + ElementValue[] elementValues, + String elementValueMethodName) + { + // Find the element value. + int index = findElementValue(elementValuesCount, + elementValues, + elementValueMethodName); + if (index < 0) + { + return elementValuesCount; + } + + // Shift the other element values in the array. + System.arraycopy(elementValues, index + 1, + elementValues, index, + elementValuesCount - index - 1); + + // Clear the last entry in the array. + elementValues[--elementValuesCount] = null; + + return elementValuesCount; + } + + + /** + * Finds the index of the element value with the given name in the given + * array of element values. + */ + private int findElementValue(int elementValuesCount, + ElementValue[] elementValues, + String elementValueName) + { + for (int index = 0; index < elementValuesCount; index++) + { + if (elementValues[index].getMethodName(targetClass).equals(elementValueName)) + { + return index; + } + } + + return -1; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/ExceptionAdder.java b/src/proguard/classfile/editor/ExceptionAdder.java new file mode 100644 index 0000000..1ccb1a6 --- /dev/null +++ b/src/proguard/classfile/editor/ExceptionAdder.java @@ -0,0 +1,65 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.ExceptionsAttribute; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor adds all class constants that it visits to the given + * target exceptions attribute. + * + * @author Eric Lafortune + */ +public class ExceptionAdder +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final ConstantAdder constantAdder; + private final ExceptionsAttributeEditor exceptionsAttributeEditor; + + + /** + * Creates a new ExceptionAdder that will copy classes into the given + * target exceptions attribute. + */ + public ExceptionAdder(ProgramClass targetClass, + ExceptionsAttribute targetExceptionsAttribute) + { + constantAdder = new ConstantAdder(targetClass); + exceptionsAttributeEditor = new ExceptionsAttributeEditor(targetExceptionsAttribute); + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Add a class constant to the constant pool. + constantAdder.visitClassConstant(clazz, classConstant); + + // Add the index of the class constant to the list of exceptions. + exceptionsAttributeEditor.addException(constantAdder.getConstantIndex()); + } +} diff --git a/src/proguard/classfile/editor/ExceptionInfoAdder.java b/src/proguard/classfile/editor/ExceptionInfoAdder.java new file mode 100644 index 0000000..e0cc9c5 --- /dev/null +++ b/src/proguard/classfile/editor/ExceptionInfoAdder.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor adds all exception information that it visits to + * the given target code attribute. + * + * @author Eric Lafortune + */ +public class ExceptionInfoAdder +implements ExceptionInfoVisitor +{ + private final ConstantAdder constantAdder; + private final CodeAttributeComposer codeAttributeComposer; + + + /** + * Creates a new ExceptionAdder that will copy exceptions into the given + * target code attribute. + */ + public ExceptionInfoAdder(ProgramClass targetClass, + CodeAttributeComposer targetComposer) + { + constantAdder = new ConstantAdder(targetClass); + codeAttributeComposer = targetComposer; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + // Create a copy of the exception info. + ExceptionInfo newExceptionInfo = + new ExceptionInfo(exceptionInfo.u2startPC, + exceptionInfo.u2endPC, + exceptionInfo.u2handlerPC, + exceptionInfo.u2catchType == 0 ? 0 : + constantAdder.addConstant(clazz, exceptionInfo.u2catchType)); + + // Add the completed exception info. + codeAttributeComposer.appendException(newExceptionInfo); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/ExceptionsAttributeEditor.java b/src/proguard/classfile/editor/ExceptionsAttributeEditor.java new file mode 100644 index 0000000..4509a9a --- /dev/null +++ b/src/proguard/classfile/editor/ExceptionsAttributeEditor.java @@ -0,0 +1,68 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.ExceptionsAttribute; + +/** + * This class can add exceptions to a given exceptions attribute. + * Exceptions to be added must have been added to the constant pool and filled + * out beforehand. + * + * @author Eric Lafortune + */ +public class ExceptionsAttributeEditor +{ + private ExceptionsAttribute targetExceptionsAttribute; + + + /** + * Creates a new ExceptionsAttributeEditor that will edit exceptions in the + * given exceptions attribute. + */ + public ExceptionsAttributeEditor(ExceptionsAttribute targetExceptionsAttribute) + { + this.targetExceptionsAttribute = targetExceptionsAttribute; + } + + + /** + * Adds a given exception to the exceptions attribute. + */ + public void addException(int exceptionIndex) + { + int exceptionIndexTableLength = targetExceptionsAttribute.u2exceptionIndexTableLength; + int[] exceptionIndexTable = targetExceptionsAttribute.u2exceptionIndexTable; + + // Make sure there is enough space for the new exception. + if (exceptionIndexTable.length <= exceptionIndexTableLength) + { + targetExceptionsAttribute.u2exceptionIndexTable = new int[exceptionIndexTableLength+1]; + System.arraycopy(exceptionIndexTable, 0, + targetExceptionsAttribute.u2exceptionIndexTable, 0, + exceptionIndexTableLength); + exceptionIndexTable = targetExceptionsAttribute.u2exceptionIndexTable; + } + + // Add the exception. + exceptionIndexTable[targetExceptionsAttribute.u2exceptionIndexTableLength++] = exceptionIndex; + } +} diff --git a/src/proguard/classfile/editor/InstructionAdder.java b/src/proguard/classfile/editor/InstructionAdder.java new file mode 100644 index 0000000..60fde6d --- /dev/null +++ b/src/proguard/classfile/editor/InstructionAdder.java @@ -0,0 +1,76 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor adds all instructions that it visits to the given + * target code attribute. + * + * @author Eric Lafortune + */ +public class InstructionAdder +extends SimplifiedVisitor +implements InstructionVisitor +{ + private final ConstantAdder constantAdder; + private final CodeAttributeComposer codeAttributeComposer; + + + /** + * Creates a new InstructionAdder that will copy classes into the given + * target code attribute. + */ + public InstructionAdder(ProgramClass targetClass, + CodeAttributeComposer targetComposer) + { + constantAdder = new ConstantAdder(targetClass); + codeAttributeComposer = targetComposer; + } + + + // Implementations for InstructionVisitor. + + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Add the instruction. + codeAttributeComposer.appendInstruction(offset, instruction); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Create a copy of the instruction. + Instruction newConstantInstruction = + new ConstantInstruction(constantInstruction.opcode, + constantAdder.addConstant(clazz, constantInstruction.constantIndex), + constantInstruction.constant).shrink(); + + // Add the instruction. + codeAttributeComposer.appendInstruction(offset, newConstantInstruction); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/InstructionWriter.java b/src/proguard/classfile/editor/InstructionWriter.java new file mode 100644 index 0000000..d842358 --- /dev/null +++ b/src/proguard/classfile/editor/InstructionWriter.java @@ -0,0 +1,278 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor writes out the instructions that it visits, + * collecting instructions that have to be widened. As an AttributeVisitor, + * it then applies the collected changes. The process will be repeated + * recursively, if necessary. + * + * @author Eric Lafortune + */ +public class InstructionWriter +extends SimplifiedVisitor +implements InstructionVisitor, + AttributeVisitor +{ + private int codeLength; + + private CodeAttributeEditor codeAttributeEditor; + + + /** + * Resets the accumulated code changes. + * @param codeLength the length of the code that will be edited next. + */ + public void reset(int codeLength) + { + this.codeLength = codeLength; + + // The code attribute editor has to be created lazily. + if (codeAttributeEditor != null) + { + codeAttributeEditor.reset(codeLength); + } + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + // Try to write out the instruction. + // Simple instructions should always fit. + simpleInstruction.write(codeAttribute, offset); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + try + { + // Try to write out the instruction. + constantInstruction.write(codeAttribute, offset); + } + catch (IllegalArgumentException exception) + { + // Create a new constant instruction that will fit. + Instruction replacementInstruction = + new ConstantInstruction(constantInstruction.opcode, + constantInstruction.constantIndex, + constantInstruction.constant).shrink(); + + replaceInstruction(offset, replacementInstruction); + + // Write out a dummy constant instruction for now. + constantInstruction.constantIndex = 0; + constantInstruction.constant = 0; + constantInstruction.write(codeAttribute, offset); + } + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + try + { + // Try to write out the instruction. + variableInstruction.write(codeAttribute, offset); + } + catch (IllegalArgumentException exception) + { + // Create a new variable instruction that will fit. + Instruction replacementInstruction = + new VariableInstruction(variableInstruction.opcode, + variableInstruction.variableIndex, + variableInstruction.constant).shrink(); + + replaceInstruction(offset, replacementInstruction); + + // Write out a dummy variable instruction for now. + variableInstruction.variableIndex = 0; + variableInstruction.constant = 0; + variableInstruction.write(codeAttribute, offset); + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + try + { + // Try to write out the instruction. + branchInstruction.write(codeAttribute, offset); + } + catch (IllegalArgumentException exception) + { + // Create a new unconditional branch that will fit. + Instruction replacementInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO_W, + branchInstruction.branchOffset); + + // Create a new instruction that will fit. + switch (branchInstruction.opcode) + { + default: + { + // Create a new branch instruction that will fit. + replacementInstruction = + new BranchInstruction(branchInstruction.opcode, + branchInstruction.branchOffset).shrink(); + + break; + } + + // Some special cases, for which a wide branch doesn't exist. + case InstructionConstants.OP_IFEQ: + case InstructionConstants.OP_IFNE: + case InstructionConstants.OP_IFLT: + case InstructionConstants.OP_IFGE: + case InstructionConstants.OP_IFGT: + case InstructionConstants.OP_IFLE: + case InstructionConstants.OP_IFICMPEQ: + case InstructionConstants.OP_IFICMPNE: + case InstructionConstants.OP_IFICMPLT: + case InstructionConstants.OP_IFICMPGE: + case InstructionConstants.OP_IFICMPGT: + case InstructionConstants.OP_IFICMPLE: + case InstructionConstants.OP_IFACMPEQ: + case InstructionConstants.OP_IFACMPNE: + { + // Insert the complementary conditional branch. + Instruction complementaryConditionalBranch = + new BranchInstruction((byte)(((branchInstruction.opcode+1) ^ 1) - 1), + (1+2) + (1+4)); + + insertBeforeInstruction(offset, complementaryConditionalBranch); + + // Create a new unconditional branch that will fit. + break; + } + + case InstructionConstants.OP_IFNULL: + case InstructionConstants.OP_IFNONNULL: + { + // Insert the complementary conditional branch. + Instruction complementaryConditionalBranch = + new BranchInstruction((byte)(branchInstruction.opcode ^ 1), + (1+2) + (1+4)); + + insertBeforeInstruction(offset, complementaryConditionalBranch); + + // Create a new unconditional branch that will fit. + break; + } + } + + replaceInstruction(offset, replacementInstruction); + + // Write out a dummy branch instruction for now. + branchInstruction.branchOffset = 0; + branchInstruction.write(codeAttribute, offset); + } + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + // Try to write out the instruction. + // Switch instructions should always fit. + switchInstruction.write(codeAttribute, offset); + } + + + // Implementations for AttributeVisitor. + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Avoid doing any work if nothing is changing anyway. + if (codeAttributeEditor != null) + { + // Apply the collected expansions. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + + // Clear the modifications for the next run. + codeAttributeEditor = null; + } + } + + + // Small utility methods. + + /** + * Remembers to place the given instruction right before the instruction + * at the given offset. + */ + private void insertBeforeInstruction(int instructionOffset, Instruction instruction) + { + ensureCodeAttributeEditor(); + + // Replace the instruction. + codeAttributeEditor.insertBeforeInstruction(instructionOffset, instruction); + } + + + /** + * Remembers to replace the instruction at the given offset by the given + * instruction. + */ + private void replaceInstruction(int instructionOffset, Instruction instruction) + { + ensureCodeAttributeEditor(); + + // Replace the instruction. + codeAttributeEditor.replaceInstruction(instructionOffset, instruction); + } + + + /** + * Remembers to place the given instruction right after the instruction + * at the given offset. + */ + private void insertAfterInstruction(int instructionOffset, Instruction instruction) + { + ensureCodeAttributeEditor(); + + // Replace the instruction. + codeAttributeEditor.insertAfterInstruction(instructionOffset, instruction); + } + + + /** + * Makes sure there is a code attribute editor for the given code attribute. + */ + private void ensureCodeAttributeEditor() + { + if (codeAttributeEditor == null) + { + codeAttributeEditor = new CodeAttributeEditor(); + codeAttributeEditor.reset(codeLength); + } + } +} diff --git a/src/proguard/classfile/editor/InterfaceAdder.java b/src/proguard/classfile/editor/InterfaceAdder.java new file mode 100644 index 0000000..e095af6 --- /dev/null +++ b/src/proguard/classfile/editor/InterfaceAdder.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor adds all interfaces that it visits to the given + * target class. + * + * @author Eric Lafortune + */ +public class InterfaceAdder +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final ConstantAdder constantAdder; + private final InterfacesEditor interfacesEditor; + + + /** + * Creates a new InterfaceAdder that will add interfaces to the given + * target class. + */ + public InterfaceAdder(ProgramClass targetClass) + { + constantAdder = new ConstantAdder(targetClass); + interfacesEditor = new InterfacesEditor(targetClass); + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + interfacesEditor.addInterface(constantAdder.addConstant(clazz, classConstant)); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/InterfaceSorter.java b/src/proguard/classfile/editor/InterfaceSorter.java new file mode 100644 index 0000000..6521369 --- /dev/null +++ b/src/proguard/classfile/editor/InterfaceSorter.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +import java.util.Arrays; + +/** + * This ClassVisitor sorts the interfaces of the program classes that it visits. + * + * @author Eric Lafortune + */ +public class InterfaceSorter +extends SimplifiedVisitor +implements ClassVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + int[] interfaces = programClass.u2interfaces; + int interfacesCount = programClass.u2interfacesCount; + + // Sort the interfaces. + Arrays.sort(interfaces, 0, interfacesCount); + + // Remove any duplicate entries. + int newInterfacesCount = 0; + int previousInterfaceIndex = 0; + for (int index = 0; index < interfacesCount; index++) + { + int interfaceIndex = interfaces[index]; + + // Isn't this a duplicate of the previous interface? + if (interfaceIndex != previousInterfaceIndex) + { + interfaces[newInterfacesCount++] = interfaceIndex; + + // Remember the interface. + previousInterfaceIndex = interfaceIndex; + } + } + + programClass.u2interfacesCount = newInterfacesCount; + } +} diff --git a/src/proguard/classfile/editor/InterfacesEditor.java b/src/proguard/classfile/editor/InterfacesEditor.java new file mode 100644 index 0000000..d3170e1 --- /dev/null +++ b/src/proguard/classfile/editor/InterfacesEditor.java @@ -0,0 +1,122 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; + +import java.util.Arrays; + +/** + * This class can add and delete interfaces to and from classes. References to + * the constant pool must be filled out beforehand. + * + * @author Eric Lafortune + */ +public class InterfacesEditor +{ + private final ProgramClass targetClass; + + + /** + * Creates a new InterfacesEditor that will edit interfaces in the given + * target class. + */ + public InterfacesEditor(ProgramClass targetClass) + { + this.targetClass = targetClass; + } + + + /** + * Adds the specified interface to the target class, if it isn't present yet. + */ + public void addInterface(int interfaceConstantIndex) + { + // Is the interface not yet present? + if (findInterfaceIndex(interfaceConstantIndex) < 0) + { + int interfacesCount = targetClass.u2interfacesCount++; + int[] interfaces = targetClass.u2interfaces; + + // Is the array too small to contain the additional interface? + if (interfaces.length <= interfacesCount) + { + // Create a new array and copy the interfaces into it. + int[] newinterfaces = new int[interfacesCount + 1]; + System.arraycopy(interfaces, 0, newinterfaces, 0, interfacesCount); + interfaces = newinterfaces; + + targetClass.u2interfaces = interfaces; + } + + // Append the interface. + interfaces[interfacesCount] = interfaceConstantIndex; + } + } + + + /** + * Deletes the given interface from the target class, if it is present. + */ + public void deleteInterface(int interfaceConstantIndex) + { + // Is the interface already present? + int interfaceIndex = findInterfaceIndex(interfaceConstantIndex); + if (interfaceIndex >= 0) + { + int interfacesCount = --targetClass.u2interfacesCount; + int[] interfaces = targetClass.u2interfaces; + + // Shift the other interfaces in the array. + for (int index = interfaceIndex; index < interfacesCount; index++) + { + interfaces[index] = interfaces[index + 1]; + } + + // Clear the remaining entry in the array. + interfaces[interfacesCount] = 0; + } + } + + + // Small utility methods. + + /** + * Finds the index of the specified interface in the list of interfaces of + * the target class. + */ + private int findInterfaceIndex(int interfaceConstantIndex) + { + int interfacesCount = targetClass.u2interfacesCount; + int[] interfaces = targetClass.u2interfaces; + + for (int index = 0; index < interfacesCount; index++) + { + if (interfaces[index] == interfaceConstantIndex) + { + return index; + } + } + + return -1; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/LineNumberInfoAdder.java b/src/proguard/classfile/editor/LineNumberInfoAdder.java new file mode 100644 index 0000000..aa8c0c4 --- /dev/null +++ b/src/proguard/classfile/editor/LineNumberInfoAdder.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.visitor.LineNumberInfoVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.*; + +/** + * This LineNumberInfoVisitor adds all line numbers that it visits to the given + * target line number attribute. + */ +public class LineNumberInfoAdder +implements LineNumberInfoVisitor +{ + private final LineNumberTableAttributeEditor lineNumberTableAttributeEditor; + + + /** + * Creates a new LineNumberInfoAdder that will copy line numbers into the + * given target line number table. + */ + public LineNumberInfoAdder(LineNumberTableAttribute targetLineNumberTableAttribute) + { + this.lineNumberTableAttributeEditor = new LineNumberTableAttributeEditor(targetLineNumberTableAttribute); + } + + + // Implementations for LineNumberInfoVisitor. + + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo) + { + // Create a new line number. + LineNumberInfo newLineNumberInfo = + new LineNumberInfo(lineNumberInfo.u2startPC, + lineNumberInfo.u2lineNumber); + + // Add it to the target. + lineNumberTableAttributeEditor.addLineNumberInfo(newLineNumberInfo); + } +} diff --git a/src/proguard/classfile/editor/LineNumberTableAttributeEditor.java b/src/proguard/classfile/editor/LineNumberTableAttributeEditor.java new file mode 100644 index 0000000..ab96b38 --- /dev/null +++ b/src/proguard/classfile/editor/LineNumberTableAttributeEditor.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.*; + +/** + * This class can add line numbers to a given line number table attribute. + * Line numbers to be added must have been filled out beforehand. + * + * @author Eric Lafortune + */ +public class LineNumberTableAttributeEditor +{ + private LineNumberTableAttribute targetLineNumberTableAttribute; + + + /** + * Creates a new LineNumberTableAttributeEditor that will edit line numbers + * in the given line number table attribute. + */ + public LineNumberTableAttributeEditor(LineNumberTableAttribute targetLineNumberTableAttribute) + { + this.targetLineNumberTableAttribute = targetLineNumberTableAttribute; + } + + + /** + * Adds a given line number to the line number table attribute. + */ + public void addLineNumberInfo(LineNumberInfo lineNumberInfo) + { + int lineNumberTableLength = targetLineNumberTableAttribute.u2lineNumberTableLength; + LineNumberInfo[] lineNumberTable = targetLineNumberTableAttribute.lineNumberTable; + + // Make sure there is enough space for the new lineNumberInfo. + if (lineNumberTable.length <= lineNumberTableLength) + { + targetLineNumberTableAttribute.lineNumberTable = new LineNumberInfo[lineNumberTableLength+1]; + System.arraycopy(lineNumberTable, 0, + targetLineNumberTableAttribute.lineNumberTable, 0, + lineNumberTableLength); + lineNumberTable = targetLineNumberTableAttribute.lineNumberTable; + } + + // Add the lineNumberInfo. + lineNumberTable[targetLineNumberTableAttribute.u2lineNumberTableLength++] = lineNumberInfo; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/LocalVariableInfoAdder.java b/src/proguard/classfile/editor/LocalVariableInfoAdder.java new file mode 100644 index 0000000..f285e4f --- /dev/null +++ b/src/proguard/classfile/editor/LocalVariableInfoAdder.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.visitor.LocalVariableInfoVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.*; + +/** + * This LocalVariableInfoVisitor adds all line numbers that it visits to the given + * target line number attribute. + */ +public class LocalVariableInfoAdder +implements LocalVariableInfoVisitor +{ + private final ConstantAdder constantAdder; + private final LocalVariableTableAttributeEditor localVariableTableAttributeEditor; + + + /** + * Creates a new LocalVariableInfoAdder that will copy line numbers into the + * given target line number table. + */ + public LocalVariableInfoAdder(ProgramClass targetClass, + LocalVariableTableAttribute targetLocalVariableTableAttribute) + { + this.constantAdder = new ConstantAdder(targetClass); + this.localVariableTableAttributeEditor = new LocalVariableTableAttributeEditor(targetLocalVariableTableAttribute); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + // Create a new line number. + LocalVariableInfo newLocalVariableInfo = + new LocalVariableInfo(localVariableInfo.u2startPC, + localVariableInfo.u2length, + constantAdder.addConstant(clazz, localVariableInfo.u2nameIndex), + constantAdder.addConstant(clazz, localVariableInfo.u2descriptorIndex), + localVariableInfo.u2index); + + newLocalVariableInfo.referencedClass = localVariableInfo.referencedClass; + + // Add it to the target. + localVariableTableAttributeEditor.addLocalVariableInfo(newLocalVariableInfo); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/LocalVariableTableAttributeEditor.java b/src/proguard/classfile/editor/LocalVariableTableAttributeEditor.java new file mode 100644 index 0000000..053b628 --- /dev/null +++ b/src/proguard/classfile/editor/LocalVariableTableAttributeEditor.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.*; + +/** + * This class can add local variables to a given local variable table attribute. + * Local variables to be added must have been filled out beforehand. + * + * @author Eric Lafortune + */ +public class LocalVariableTableAttributeEditor +{ + private LocalVariableTableAttribute targetLocalVariableTableAttribute; + + + /** + * Creates a new LocalVariableTableAttributeEditor that will edit line numbers + * in the given line number table attribute. + */ + public LocalVariableTableAttributeEditor(LocalVariableTableAttribute targetLocalVariableTableAttribute) + { + this.targetLocalVariableTableAttribute = targetLocalVariableTableAttribute; + } + + + /** + * Adds a given line number to the line number table attribute. + */ + public void addLocalVariableInfo(LocalVariableInfo localVariableInfo) + { + int localVariableTableLength = targetLocalVariableTableAttribute.u2localVariableTableLength; + LocalVariableInfo[] localVariableTable = targetLocalVariableTableAttribute.localVariableTable; + + // Make sure there is enough space for the new localVariableInfo. + if (localVariableTable.length <= localVariableTableLength) + { + targetLocalVariableTableAttribute.localVariableTable = new LocalVariableInfo[localVariableTableLength+1]; + System.arraycopy(localVariableTable, 0, + targetLocalVariableTableAttribute.localVariableTable, 0, + localVariableTableLength); + localVariableTable = targetLocalVariableTableAttribute.localVariableTable; + } + + // Add the localVariableInfo. + localVariableTable[targetLocalVariableTableAttribute.u2localVariableTableLength++] = localVariableInfo; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/LocalVariableTypeInfoAdder.java b/src/proguard/classfile/editor/LocalVariableTypeInfoAdder.java new file mode 100644 index 0000000..ca50f3f --- /dev/null +++ b/src/proguard/classfile/editor/LocalVariableTypeInfoAdder.java @@ -0,0 +1,68 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.visitor.LocalVariableTypeInfoVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.*; + +/** + * This LocalVariableTypeInfoVisitor adds all line numbers that it visits to the given + * target line number attribute. + */ +public class LocalVariableTypeInfoAdder +implements LocalVariableTypeInfoVisitor +{ + private final ConstantAdder constantAdder; + private final LocalVariableTypeTableAttributeEditor localVariableTypeTableAttributeEditor; + + + /** + * Creates a new LocalVariableTypeInfoAdder that will copy line numbers into the + * given target line number table. + */ + public LocalVariableTypeInfoAdder(ProgramClass targetClass, + LocalVariableTypeTableAttribute targetLocalVariableTypeTableAttribute) + { + this.constantAdder = new ConstantAdder(targetClass); + this.localVariableTypeTableAttributeEditor = new LocalVariableTypeTableAttributeEditor(targetLocalVariableTypeTableAttribute); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + // Create a new line number. + LocalVariableTypeInfo newLocalVariableTypeInfo = + new LocalVariableTypeInfo(localVariableTypeInfo.u2startPC, + localVariableTypeInfo.u2length, + constantAdder.addConstant(clazz, localVariableTypeInfo.u2nameIndex), + constantAdder.addConstant(clazz, localVariableTypeInfo.u2signatureIndex), + localVariableTypeInfo.u2index); + + // TODO: Clone array. + newLocalVariableTypeInfo.referencedClasses = localVariableTypeInfo.referencedClasses; + + // Add it to the target. + localVariableTypeTableAttributeEditor.addLocalVariableTypeInfo(newLocalVariableTypeInfo); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/LocalVariableTypeTableAttributeEditor.java b/src/proguard/classfile/editor/LocalVariableTypeTableAttributeEditor.java new file mode 100644 index 0000000..fe5a64d --- /dev/null +++ b/src/proguard/classfile/editor/LocalVariableTypeTableAttributeEditor.java @@ -0,0 +1,68 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.*; + +/** + * This class can add local variables to a given local variable type table + * attribute. + * Local variable types to be added must have been filled out beforehand. + * + * @author Eric Lafortune + */ +public class LocalVariableTypeTableAttributeEditor +{ + private LocalVariableTypeTableAttribute targetLocalVariableTypeTableAttribute; + + + /** + * Creates a new LocalVariableTypeTableAttributeEditor that will edit line numbers + * in the given line number table attribute. + */ + public LocalVariableTypeTableAttributeEditor(LocalVariableTypeTableAttribute targetLocalVariableTypeTableAttribute) + { + this.targetLocalVariableTypeTableAttribute = targetLocalVariableTypeTableAttribute; + } + + + /** + * Adds a given line number to the line number table attribute. + */ + public void addLocalVariableTypeInfo(LocalVariableTypeInfo localVariableTypeInfo) + { + int localVariableTypeTableLength = targetLocalVariableTypeTableAttribute.u2localVariableTypeTableLength; + LocalVariableTypeInfo[] localVariableTypeTable = targetLocalVariableTypeTableAttribute.localVariableTypeTable; + + // Make sure there is enough space for the new localVariableTypeInfo. + if (localVariableTypeTable.length <= localVariableTypeTableLength) + { + targetLocalVariableTypeTableAttribute.localVariableTypeTable = new LocalVariableTypeInfo[localVariableTypeTableLength+1]; + System.arraycopy(localVariableTypeTable, 0, + targetLocalVariableTypeTableAttribute.localVariableTypeTable, 0, + localVariableTypeTableLength); + localVariableTypeTable = targetLocalVariableTypeTableAttribute.localVariableTypeTable; + } + + // Add the localVariableTypeInfo. + localVariableTypeTable[targetLocalVariableTypeTableAttribute.u2localVariableTypeTableLength++] = localVariableTypeInfo; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/MemberAdder.java b/src/proguard/classfile/editor/MemberAdder.java new file mode 100644 index 0000000..5f939bb --- /dev/null +++ b/src/proguard/classfile/editor/MemberAdder.java @@ -0,0 +1,257 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This ConstantVisitor adds all class members that it visits to the given + * target class. + * + * @author Eric Lafortune + */ +public class MemberAdder +extends SimplifiedVisitor +implements MemberVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private static final Attribute[] EMPTY_ATTRIBUTES = new Attribute[0]; + + + private final ProgramClass targetClass; +// private final boolean addFields; + + private final ConstantAdder constantAdder; + private final ClassEditor classEditor; + private final ConstantPoolEditor constantPoolEditor; + + + /** + * Creates a new MemberAdder that will copy methods into the given target + * class. + * @param targetClass the class to which all visited class members will be + * added. + */ +// * @param addFields specifies whether fields should be added, or fused +// * with the present fields. + public MemberAdder(ProgramClass targetClass)//), +// boolean addFields) + { + this.targetClass = targetClass; +// this.addFields = addFields; + + constantAdder = new ConstantAdder(targetClass); + classEditor = new ClassEditor(targetClass); + constantPoolEditor = new ConstantPoolEditor(targetClass); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + String name = programField.getName(programClass); + String descriptor = programField.getDescriptor(programClass); + int accessFlags = programField.getAccessFlags(); + + // Does the target class already have such a field? + ProgramField targetField = (ProgramField)targetClass.findField(name, descriptor); + if (targetField != null) + { + // Is the field private or static? + int targetAccessFlags = targetField.getAccessFlags(); + if ((targetAccessFlags & + (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC)) != 0) + { + if (DEBUG) + { + System.out.println("MemberAdder: renaming field ["+targetClass+"."+targetField.getName(targetClass)+" "+targetField.getDescriptor(targetClass)+"]"); + } + + // Rename the private or static field. + targetField.u2nameIndex = + constantPoolEditor.addUtf8Constant(newUniqueMemberName(name, targetClass.getName())); + } +// else +// { +// // Keep the non-private and non-static field, but update its +// // contents, in order to keep any references to it valid. +// if (DEBUG) +// { +// System.out.println("MemberAdder: updating field ["+programClass+"."+programField.getName(programClass)+" "+programField.getDescriptor(programClass)+"] into ["+targetClass.getName()+"]"); +// } +// +// // Combine the access flags. +// targetField.u2accessFlags = accessFlags | targetAccessFlags; +// +// // Add and replace any attributes. +// programField.attributesAccept(programClass, +// new AttributeAdder(targetClass, +// targetField, +// true)); +// +// // Don't add a new field. +// return; +// } + } + + if (DEBUG) + { + System.out.println("MemberAdder: copying field ["+programClass+"."+programField.getName(programClass)+" "+programField.getDescriptor(programClass)+"] into ["+targetClass.getName()+"]"); + } + + // Create a copy of the field. + ProgramField newProgramField = + new ProgramField(accessFlags, + constantAdder.addConstant(programClass, programField.u2nameIndex), + constantAdder.addConstant(programClass, programField.u2descriptorIndex), + 0, + programField.u2attributesCount > 0 ? + new Attribute[programField.u2attributesCount] : + EMPTY_ATTRIBUTES, + programField.referencedClass); + + // Link to its visitor info. + newProgramField.setVisitorInfo(programField); + + // Copy its attributes. + programField.attributesAccept(programClass, + new AttributeAdder(targetClass, + newProgramField, + false)); + + // Add the completed field. + classEditor.addField(newProgramField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + String name = programMethod.getName(programClass); + String descriptor = programMethod.getDescriptor(programClass); + int accessFlags = programMethod.getAccessFlags(); + + // Does the target class already have such a method? + ProgramMethod targetMethod = (ProgramMethod)targetClass.findMethod(name, descriptor); + if (targetMethod != null) + { + // is this source method abstract? + if ((accessFlags & ClassConstants.INTERNAL_ACC_ABSTRACT) != 0) + { + // Keep the target method. + if (DEBUG) + { + System.out.println("MemberAdder: skipping abstract method ["+programClass.getName()+"."+programMethod.getName(programClass)+programMethod.getDescriptor(programClass)+"] into ["+targetClass.getName()+"]"); + } + + // Don't add a new method. + return; + } + + // Is the target method abstract? + int targetAccessFlags = targetMethod.getAccessFlags(); + if ((targetAccessFlags & ClassConstants.INTERNAL_ACC_ABSTRACT) != 0) + { + // Keep the abstract method, but update its contents, in order + // to keep any references to it valid. + if (DEBUG) + { + System.out.println("MemberAdder: updating method ["+programClass.getName()+"."+programMethod.getName(programClass)+programMethod.getDescriptor(programClass)+"] into ["+targetClass.getName()+"]"); + } + + // Replace the access flags. + targetMethod.u2accessFlags = + accessFlags & ~ClassConstants.INTERNAL_ACC_FINAL; + + // Add and replace the attributes. + programMethod.attributesAccept(programClass, + new AttributeAdder(targetClass, + targetMethod, + true)); + + // Don't add a new method. + return; + } + + if (DEBUG) + { + System.out.println("MemberAdder: renaming method ["+targetClass.getName()+"."+targetMethod.getName(targetClass)+targetMethod.getDescriptor(targetClass)+"]"); + } + + // Rename the private (non-abstract) or static method. + targetMethod.u2nameIndex = + constantPoolEditor.addUtf8Constant(newUniqueMemberName(name, descriptor)); + } + + if (DEBUG) + { + System.out.println("MemberAdder: copying method ["+programClass.getName()+"."+programMethod.getName(programClass)+programMethod.getDescriptor(programClass)+"] into ["+targetClass.getName()+"]"); + } + + // Create a copy of the method. + ProgramMethod newProgramMethod = + new ProgramMethod(accessFlags & ~ClassConstants.INTERNAL_ACC_FINAL, + constantAdder.addConstant(programClass, programMethod.u2nameIndex), + constantAdder.addConstant(programClass, programMethod.u2descriptorIndex), + 0, + programMethod.u2attributesCount > 0 ? + new Attribute[programMethod.u2attributesCount] : + EMPTY_ATTRIBUTES, + programMethod.referencedClasses != null ? + (Clazz[])programMethod.referencedClasses.clone() : + null); + + // Link to its visitor info. + newProgramMethod.setVisitorInfo(programMethod); + + // Copy its attributes. + programMethod.attributesAccept(programClass, + new AttributeAdder(targetClass, + newProgramMethod, + false)); + + // Add the completed method. + classEditor.addMethod(newProgramMethod); + } + + + // Small utility methods. + + /** + * Returns a unique class member name, based on the given name and descriptor. + */ + private String newUniqueMemberName(String name, String descriptor) + { + return name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) ? + ClassConstants.INTERNAL_METHOD_NAME_INIT : + name + ClassConstants.SPECIAL_MEMBER_SEPARATOR + Long.toHexString(Math.abs((descriptor).hashCode())); + } +} diff --git a/src/proguard/classfile/editor/MemberReferenceFixer.java b/src/proguard/classfile/editor/MemberReferenceFixer.java new file mode 100644 index 0000000..4bd8af5 --- /dev/null +++ b/src/proguard/classfile/editor/MemberReferenceFixer.java @@ -0,0 +1,456 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor fixes constant pool field and method references to fields + * and methods whose names or descriptors have changed. + * + * @author Eric Lafortune + */ +public class MemberReferenceFixer +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor, + AttributeVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private static final boolean DEBUG = false; + + + private final StackSizeUpdater stackSizeUpdater = new StackSizeUpdater(); + + // Parameter for the visitor methods. + private int constantIndex; + + // Return values for the visitor methods. + private boolean isInterfaceMethod; + private boolean stackSizesMayHaveChanged; + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + stackSizesMayHaveChanged = false; + + // Fix the constant pool entries. + for (int index = 1; index < programClass.u2constantPoolCount; index++) + { + Constant constant = programClass.constantPool[index]; + if (constant != null) + { + // Fix the entry, replacing it entirely if needed. + this.constantIndex = index; + + constant.accept(programClass, this); + } + } + + // Fix the class members. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + // Fix the attributes. + programClass.attributesAccept(this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Does the string refer to a class member, due to a + // Class.get[Declared]{Field,Method} construct? + Member referencedMember = stringConstant.referencedMember; + if (referencedMember != null) + { + Clazz referencedClass = stringConstant.referencedClass; + + // Does it have a new name? + String newName = referencedMember.getName(referencedClass); + + if (!stringConstant.getString(clazz).equals(newName)) + { + if (DEBUG) + { + debug(clazz, stringConstant, referencedClass, referencedMember); + } + + // Update the name. + stringConstant.u2stringIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newName); + } + } + } + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + // Do we know the referenced field? + Member referencedMember = fieldrefConstant.referencedMember; + if (referencedMember != null) + { + Clazz referencedClass = fieldrefConstant.referencedClass; + + // Does it have a new name or type? + String newName = referencedMember.getName(referencedClass); + String newType = referencedMember.getDescriptor(referencedClass); + + if (!fieldrefConstant.getName(clazz).equals(newName) || + !fieldrefConstant.getType(clazz).equals(newType)) + { + if (DEBUG) + { + debug(clazz, fieldrefConstant, referencedClass, referencedMember); + } + + // Update the name and type index. + fieldrefConstant.u2nameAndTypeIndex = + new ConstantPoolEditor((ProgramClass)clazz).addNameAndTypeConstant(newName, newType); + } + } + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + // Do we know the referenced interface method? + Member referencedMember = interfaceMethodrefConstant.referencedMember; + if (referencedMember != null) + { + Clazz referencedClass = interfaceMethodrefConstant.referencedClass; + + // Does it have a new name or type? + String newName = referencedMember.getName(referencedClass); + String newType = referencedMember.getDescriptor(referencedClass); + + if (!interfaceMethodrefConstant.getName(clazz).equals(newName) || + !interfaceMethodrefConstant.getType(clazz).equals(newType)) + { + if (DEBUG) + { + debug(clazz, interfaceMethodrefConstant, referencedClass, referencedMember); + } + + // Update the name and type index. + interfaceMethodrefConstant.u2nameAndTypeIndex = + new ConstantPoolEditor((ProgramClass)clazz).addNameAndTypeConstant(newName, newType); + + // Remember that the stack sizes of the methods in this class + // may have changed. + stackSizesMayHaveChanged = true; + } + + // Check if this is an interface method. + isInterfaceMethod = true; + clazz.constantPoolEntryAccept(interfaceMethodrefConstant.u2classIndex, this); + + // Has the method become a non-interface method? + if (!isInterfaceMethod) + { + if (DEBUG) + { + System.out.println("MemberReferenceFixer:"); + System.out.println(" Class file = "+clazz.getName()); + System.out.println(" Ref class = "+referencedClass.getName()); + System.out.println(" Ref method = "+interfaceMethodrefConstant.getName(clazz)+interfaceMethodrefConstant.getType(clazz)); + System.out.println(" -> ordinary method"); + } + + // Replace the interface method reference by a method reference. + ((ProgramClass)clazz).constantPool[this.constantIndex] = + new MethodrefConstant(interfaceMethodrefConstant.u2classIndex, + interfaceMethodrefConstant.u2nameAndTypeIndex, + referencedClass, + referencedMember); + } + } + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + // Do we know the referenced method? + Member referencedMember = methodrefConstant.referencedMember; + if (referencedMember != null) + { + Clazz referencedClass = methodrefConstant.referencedClass; + + // Does it have a new name or type? + String newName = referencedMember.getName(referencedClass); + String newType = referencedMember.getDescriptor(referencedClass); + + if (!methodrefConstant.getName(clazz).equals(newName) || + !methodrefConstant.getType(clazz).equals(newType)) + { + if (DEBUG) + { + debug(clazz, methodrefConstant, referencedClass, referencedMember); + } + + // Update the name and type index. + methodrefConstant.u2nameAndTypeIndex = + new ConstantPoolEditor((ProgramClass)clazz).addNameAndTypeConstant(newName, newType); + + // Remember that the stack sizes of the methods in this class + // may have changed. + stackSizesMayHaveChanged = true; + } + + // Check if this is an interface method. + isInterfaceMethod = false; + clazz.constantPoolEntryAccept(methodrefConstant.u2classIndex, this); + + // Has the method become an interface method? + if (isInterfaceMethod) + { + if (DEBUG) + { + System.out.println("MemberReferenceFixer:"); + System.out.println(" Class file = "+clazz.getName()); + System.out.println(" Ref class = "+referencedClass.getName()); + System.out.println(" Ref method = "+methodrefConstant.getName(clazz)+methodrefConstant.getType(clazz)); + System.out.println(" -> interface method"); + } + + // Replace the method reference by an interface method reference. + ((ProgramClass)clazz).constantPool[this.constantIndex] = + new InterfaceMethodrefConstant(methodrefConstant.u2classIndex, + methodrefConstant.u2nameAndTypeIndex, + referencedClass, + referencedMember); + } + } + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Check if this class entry is an array type. + if (ClassUtil.isInternalArrayType(classConstant.getName(clazz))) + { + isInterfaceMethod = false; + } + else + { + // Check if this class entry refers to an interface class. + Clazz referencedClass = classConstant.referencedClass; + if (referencedClass != null) + { + isInterfaceMethod = (referencedClass.getAccessFlags() & ClassConstants.INTERNAL_ACC_INTERFACE) != 0; + } + } + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + // Fix the attributes. + programMember.attributesAccept(programClass, this); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + Member referencedMember = enclosingMethodAttribute.referencedMethod; + if (referencedMember != null) + { + Clazz referencedClass = enclosingMethodAttribute.referencedClass; + + // Does it have a new class? + if (!enclosingMethodAttribute.getClassName(clazz).equals(referencedClass.getName())) + { + // Update the class index. + enclosingMethodAttribute.u2classIndex = + new ConstantPoolEditor((ProgramClass)clazz).addClassConstant(referencedClass); + } + + // Does it have a new name or type? + if (!enclosingMethodAttribute.getName(clazz).equals(referencedMember.getName(referencedClass)) || + !enclosingMethodAttribute.getType(clazz).equals(referencedMember.getDescriptor(referencedClass))) + { + // Update the name and type index. + enclosingMethodAttribute.u2nameAndTypeIndex = + new ConstantPoolEditor((ProgramClass)clazz).addNameAndTypeConstant(referencedMember.getName(referencedClass), + referencedMember.getDescriptor(referencedClass)); + } + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Recompute the maximum stack size if necessary. + if (stackSizesMayHaveChanged) + { + stackSizeUpdater.visitCodeAttribute(clazz, method, codeAttribute); + } + + // Fix the nested attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Fix the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Fix the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Fix the annotation. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Fix the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + fixElementValue(clazz, annotation, constantElementValue); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + fixElementValue(clazz, annotation, enumConstantElementValue); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + fixElementValue(clazz, annotation, classElementValue); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + fixElementValue(clazz, annotation, annotationElementValue); + + // Fix the annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + fixElementValue(clazz, annotation, arrayElementValue); + + // Fix the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + // Small utility methods. + + /** + * Fixes the method reference of the element value, if any. + */ + private void fixElementValue(Clazz clazz, + Annotation annotation, + ElementValue elementValue) + { + // Do we know the referenced method? + Member referencedMember = elementValue.referencedMethod; + if (referencedMember != null) + { + // Does it have a new name or type? + String methodName = elementValue.getMethodName(clazz); + String newMethodName = referencedMember.getName(elementValue.referencedClass); + + if (!methodName.equals(newMethodName)) + { + // Update the element name index. + elementValue.u2elementNameIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newMethodName); + } + } + } + + + private void debug(Clazz clazz, + StringConstant stringConstant, + Clazz referencedClass, + Member referencedMember) + { + System.out.println("MemberReferenceFixer:"); + System.out.println(" Class file = "+clazz.getName()); + System.out.println(" Ref class = "+referencedClass.getName()); + System.out.println(" Ref member name = "+stringConstant.getString(clazz)); + System.out.println(" -> "+referencedMember.getName(referencedClass)); + } + + + private void debug(Clazz clazz, + RefConstant refConstant, + Clazz referencedClass, + Member referencedMember) + { + System.out.println("MemberReferenceFixer:"); + System.out.println(" Class file = "+clazz.getName()); + System.out.println(" Ref class = "+referencedClass.getName()); + System.out.println(" Ref member name = "+refConstant.getName(clazz)); + System.out.println(" -> "+referencedMember.getName(referencedClass)); + System.out.println(" Ref descriptor = "+refConstant.getType(clazz)); + System.out.println(" -> "+referencedMember.getDescriptor(referencedClass)); + } +} diff --git a/src/proguard/classfile/editor/MethodInvocationFixer.java b/src/proguard/classfile/editor/MethodInvocationFixer.java new file mode 100644 index 0000000..ef76012 --- /dev/null +++ b/src/proguard/classfile/editor/MethodInvocationFixer.java @@ -0,0 +1,254 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This AttributeVisitor fixes all inappropriate special/virtual/static/interface + * invocations of the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class MethodInvocationFixer +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ConstantVisitor, + ClassVisitor, + MemberVisitor +{ + private static final boolean DEBUG = false; + + + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + // Return values for the visitor methods. + private Clazz referencedClass; + private Clazz referencedMethodClass; + private Member referencedMethod; + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Reset the code attribute editor. + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + // Remap the variables of the instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Apply the code atribute editor. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + int constantIndex = constantInstruction.constantIndex; + + // Get information on the called class and method, if present. + referencedMethod = null; + + clazz.constantPoolEntryAccept(constantIndex, this); + + // Did we find the called class and method? + if (referencedMethod != null) + { + // Do we need to update the opcode? + byte opcode = constantInstruction.opcode; + + // Is the method static? + if ((referencedMethod.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0) + { + // But is it not a static invocation? + if (opcode != InstructionConstants.OP_INVOKESTATIC) + { + // Replace the invocation by an invokestatic instruction. + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, + constantIndex).shrink(); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + + if (DEBUG) + { + debug(clazz, method, offset, constantInstruction, replacementInstruction); + } + } + } + + // Is the method private, or an instance initializer? + else if ((referencedMethod.getAccessFlags() & ClassConstants.INTERNAL_ACC_PRIVATE) != 0 || + referencedMethod.getName(referencedMethodClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + // But is it not a special invocation? + if (opcode != InstructionConstants.OP_INVOKESPECIAL) + { + // Replace the invocation by an invokespecial instruction. + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_INVOKESPECIAL, + constantIndex).shrink(); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + + if (DEBUG) + { + debug(clazz, method, offset, constantInstruction, replacementInstruction); + } + } + } + + // Is the method an interface method? + else if ((referencedClass.getAccessFlags() & ClassConstants.INTERNAL_ACC_INTERFACE) != 0) + { + int invokeinterfaceConstant = + (ClassUtil.internalMethodParameterSize(referencedMethod.getDescriptor(referencedMethodClass), false)) << 8; + + // But is it not an interface invocation, or is the parameter + // size incorrect? + if (opcode != InstructionConstants.OP_INVOKEINTERFACE || + constantInstruction.constant != invokeinterfaceConstant) + { + // Fix the parameter size of the interface invocation. + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_INVOKEINTERFACE, + constantIndex, + invokeinterfaceConstant).shrink(); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + + if (DEBUG) + { + debug(clazz, method, offset, constantInstruction, replacementInstruction); + } + } + } + + // The method is not static, private, an instance initializer, or + // an interface method. + else + { + // But is it not a virtual invocation (or a special invocation, + // but not a super call)? + if (opcode != InstructionConstants.OP_INVOKEVIRTUAL && + (opcode != InstructionConstants.OP_INVOKESPECIAL || + !clazz.extends_(referencedClass))) + { + // Replace the invocation by an invokevirtual instruction. + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, + constantIndex).shrink(); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + + if (DEBUG) + { + debug(clazz, method, offset, constantInstruction, replacementInstruction); + } + } + } + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitAnyMethodrefConstant(Clazz clazz, RefConstant refConstant) + { + // Check if this is an interface method. Note that we're interested in + // the class of the method reference, not in the class in which the + // method was actually found. + //refConstant.referencedClassAccept(this); + clazz.constantPoolEntryAccept(refConstant.u2classIndex, this); + + // Get the referenced access flags and names. + refConstant.referencedMemberAccept(this); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Check if this is an interface class. + classConstant.referencedClassAccept(this); + } + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + // Remember the referenced class. + referencedClass = clazz; + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + // Remember the referenced method. + referencedMethodClass = clazz; + referencedMethod = member; + } + + + // Small utility methods. + + private void debug(Clazz clazz, + Method method, + int offset, + ConstantInstruction constantInstruction, + Instruction replacementInstruction) + { + System.out.println("MethodInvocationFixer:"); + System.out.println(" Class = "+clazz.getName()); + System.out.println(" Method = "+method.getName(clazz)+method.getDescriptor(clazz)); + System.out.println(" Instruction = "+constantInstruction.toString(offset)); + System.out.println(" -> Class = "+referencedClass); + System.out.println(" Method = "+referencedMethod); + if ((referencedClass.getAccessFlags() & ClassConstants.INTERNAL_ACC_INTERFACE) != 0) + { + System.out.println(" Parameter size = "+(ClassUtil.internalMethodParameterSize(referencedMethod.getDescriptor(referencedMethodClass), false))); + } + System.out.println(" Replacement instruction = "+replacementInstruction.toString(offset)); + } +} diff --git a/src/proguard/classfile/editor/NamedAttributeDeleter.java b/src/proguard/classfile/editor/NamedAttributeDeleter.java new file mode 100644 index 0000000..0c4d339 --- /dev/null +++ b/src/proguard/classfile/editor/NamedAttributeDeleter.java @@ -0,0 +1,54 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.visitor.*; +import proguard.util.StringMatcher; + + +/** + * This ClassVisitor deletes attributes with a given name in the program + * classes that it visits. + * + * @author Eric Lafortune + */ +public class NamedAttributeDeleter implements ClassVisitor +{ + private final String attributeName; + + + public NamedAttributeDeleter(String attributeName) + { + this.attributeName = attributeName; + } + + + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) {} + + + public void visitProgramClass(ProgramClass programClass) + { + new AttributesEditor(programClass, false).deleteAttribute(attributeName); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/ParameterAnnotationsAttributeEditor.java b/src/proguard/classfile/editor/ParameterAnnotationsAttributeEditor.java new file mode 100644 index 0000000..4cad6b8 --- /dev/null +++ b/src/proguard/classfile/editor/ParameterAnnotationsAttributeEditor.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.attribute.annotation.*; + +/** + * This class can add annotations to a given parameter annotations attribute. + * Annotations to be added must have been filled out beforehand. + * + * @author Eric Lafortune + */ +public class ParameterAnnotationsAttributeEditor +{ + private ParameterAnnotationsAttribute targetParameterAnnotationsAttribute; + + + /** + * Creates a new ParameterAnnotationsAttributeEditor that will edit + * annotations in the given parameter annotations attribute. + */ + public ParameterAnnotationsAttributeEditor(ParameterAnnotationsAttribute targetParameterAnnotationsAttribute) + { + this.targetParameterAnnotationsAttribute = targetParameterAnnotationsAttribute; + } + + + /** + * Adds a given annotation to the annotations attribute. + */ + public void addAnnotation(int parameterIndex, Annotation annotation) + { + int annotationsCount = targetParameterAnnotationsAttribute.u2parameterAnnotationsCount[parameterIndex]; + Annotation[] annotations = targetParameterAnnotationsAttribute.parameterAnnotations[parameterIndex]; + + // Make sure there is enough space for the new annotation. + if (annotations == null || + annotations.length <= annotationsCount) + { + targetParameterAnnotationsAttribute.parameterAnnotations[parameterIndex] = new Annotation[annotationsCount+1]; + if (annotations != null) + { + System.arraycopy(annotations, 0, + targetParameterAnnotationsAttribute.parameterAnnotations[parameterIndex], 0, + annotationsCount); + } + annotations = targetParameterAnnotationsAttribute.parameterAnnotations[parameterIndex]; + } + + // Add the annotation. + annotations[targetParameterAnnotationsAttribute.u2parameterAnnotationsCount[parameterIndex]++] = annotation; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/StackSizeUpdater.java b/src/proguard/classfile/editor/StackSizeUpdater.java new file mode 100644 index 0000000..94e0519 --- /dev/null +++ b/src/proguard/classfile/editor/StackSizeUpdater.java @@ -0,0 +1,54 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor computes and updates the maximum stack size of the + * code attributes that it visits. + * + * @author Eric Lafortune + */ +public class StackSizeUpdater +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final StackSizeComputer stackSizeComputer = new StackSizeComputer(); + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Compute the stack sizes. + stackSizeComputer.visitCodeAttribute(clazz, method, codeAttribute); + + // Update the maximum stack size. + codeAttribute.u2maxStack = stackSizeComputer.getMaxStackSize(); + } +} diff --git a/src/proguard/classfile/editor/SubclassAdder.java b/src/proguard/classfile/editor/SubclassAdder.java new file mode 100644 index 0000000..6b9fd64 --- /dev/null +++ b/src/proguard/classfile/editor/SubclassAdder.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor adds the given class to the list of subclasses of the + * classes that it visits. + * + * @author Eric Lafortune + */ +public class SubclassAdder +implements ClassVisitor +{ + private final Clazz subclass; + + + /** + * Creates a new SubclassAdder that will add the given subclass. + */ + public SubclassAdder(Clazz subclass) + { + this.subclass = subclass; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.addSubClass(subclass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.addSubClass(subclass); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/SubclassToAdder.java b/src/proguard/classfile/editor/SubclassToAdder.java new file mode 100644 index 0000000..deb242f --- /dev/null +++ b/src/proguard/classfile/editor/SubclassToAdder.java @@ -0,0 +1,60 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor adds all classes that it visits to the list of subclasses + * of the given target class. + * + * @author Eric Lafortune + */ +public class SubclassToAdder +implements ClassVisitor +{ + private final Clazz targetClass; + + + /** + * Creates a new SubclassAdder that will add subclasses to the given + * target class. + */ + public SubclassToAdder(Clazz targetClass) + { + this.targetClass = targetClass; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + targetClass.addSubClass(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + targetClass.addSubClass(libraryClass); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/VariableCleaner.java b/src/proguard/classfile/editor/VariableCleaner.java new file mode 100644 index 0000000..1e93c15 --- /dev/null +++ b/src/proguard/classfile/editor/VariableCleaner.java @@ -0,0 +1,135 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.optimize.info.VariableUsageMarker; + +/** + * This AttributeVisitor cleans up unused variables in all attributes that it + * visits. + * + * @author Eric Lafortune + */ +public class VariableCleaner +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final VariableUsageMarker variableUsageMarker = new VariableUsageMarker(); + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Figure out the local variables that are used by the code. + variableUsageMarker.visitCodeAttribute(clazz, method, codeAttribute); + + // Clean up the variables of the attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Clean up local variables that aren't used. + localVariableTableAttribute.u2localVariableTableLength = + removeEmptyLocalVariables(localVariableTableAttribute.localVariableTable, + localVariableTableAttribute.u2localVariableTableLength, + codeAttribute.u2maxLocals); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Clean up local variables that aren't used. + localVariableTypeTableAttribute.u2localVariableTypeTableLength = + removeEmptyLocalVariableTypes(localVariableTypeTableAttribute.localVariableTypeTable, + localVariableTypeTableAttribute.u2localVariableTypeTableLength, + codeAttribute.u2maxLocals); + } + + + // Small utility methods. + + /** + * Returns the given list of local variables, without the ones that aren't + * used + */ + private int removeEmptyLocalVariables(LocalVariableInfo[] localVariableInfos, + int localVariableInfoCount, + int maxLocals) + { + // Overwrite all empty local variable entries. + int newIndex = 0; + for (int index = 0; index < localVariableInfoCount && index < maxLocals; index++) + { + if (variableUsageMarker.isVariableUsed(index)) + { + localVariableInfos[newIndex++] = localVariableInfos[index]; + } + } + + // Clean up any remaining array elements. + for (int index = newIndex; index < localVariableInfoCount; index++) + { + localVariableInfos[index] = null; + } + + return newIndex; + } + + + /** + * Returns the given list of local variable types, without the ones that + * aren't used + */ + private int removeEmptyLocalVariableTypes(LocalVariableTypeInfo[] localVariableTypeInfos, + int localVariableTypeInfoCount, + int maxLocals) + { + // Overwrite all empty local variable type entries. + int newIndex = 0; + for (int index = 0; index < localVariableTypeInfoCount && index < maxLocals; index++) + { + if (variableUsageMarker.isVariableUsed(index)) + { + localVariableTypeInfos[newIndex++] = localVariableTypeInfos[index]; + } + } + + // Clean up any remaining array elements. + for (int index = newIndex; index < localVariableTypeInfoCount; index++) + { + localVariableTypeInfos[index] = null; + } + + return newIndex; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/editor/VariableEditor.java b/src/proguard/classfile/editor/VariableEditor.java new file mode 100644 index 0000000..a583b49 --- /dev/null +++ b/src/proguard/classfile/editor/VariableEditor.java @@ -0,0 +1,129 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor accumulates specified changes to local variables, and + * then applies these accumulated changes to the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class VariableEditor +extends SimplifiedVisitor +implements AttributeVisitor +{ + private boolean modified; + + private boolean[] deleted = new boolean[ClassConstants.TYPICAL_VARIABLES_SIZE]; + private int[] variableMap = new int[ClassConstants.TYPICAL_VARIABLES_SIZE]; + + private final VariableRemapper variableRemapper = new VariableRemapper(); + + + /** + * Resets the accumulated code changes. + * @param maxLocals the length of the local variable frame that will be + * edited next. + */ + public void reset(int maxLocals) + { + // Try to reuse the previous array. + if (deleted.length < maxLocals) + { + deleted = new boolean[maxLocals]; + } + else + { + for (int index = 0; index < maxLocals; index++) + { + deleted[index] = false; + } + } + + modified = false; + } + + + /** + * Remembers to delete the given variable. + * @param variableIndex the index of the variable to be deleted. + */ + public void deleteVariable(int variableIndex) + { + deleted[variableIndex] = true; + + modified = true; + } + + + /** + * Returns whether the given variable at the given offset has deleted. + */ + public boolean isDeleted(int instructionOffset) + { + return deleted[instructionOffset]; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Avoid doing any work if nothing is changing anyway. + if (!modified) + { + return; + } + + int oldMaxLocals = codeAttribute.u2maxLocals; + + // Make sure there is a sufficiently large variable map. + if (variableMap.length < oldMaxLocals) + { + variableMap = new int[oldMaxLocals]; + } + + // Fill out the variable map. + int newVariableIndex = 0; + for (int oldVariableIndex = 0; oldVariableIndex < oldMaxLocals; oldVariableIndex++) + { + variableMap[oldVariableIndex] = deleted[oldVariableIndex] ? + -1 : newVariableIndex++; + } + + // Set the map. + variableRemapper.setVariableMap(variableMap); + + // Remap the variables. + variableRemapper.visitCodeAttribute(clazz, method, codeAttribute); + + // Update the length of local variable frame. + codeAttribute.u2maxLocals = newVariableIndex; + } +} diff --git a/src/proguard/classfile/editor/VariableRemapper.java b/src/proguard/classfile/editor/VariableRemapper.java new file mode 100644 index 0000000..590cd4e --- /dev/null +++ b/src/proguard/classfile/editor/VariableRemapper.java @@ -0,0 +1,197 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor remaps variable indexes in all attributes that it + * visits, based on a given index map. + * + * @author Eric Lafortune + */ +public class VariableRemapper +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor +{ + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + private int[] variableMap; + + + /** + * Sets the given mapping of old variable indexes to their new indexes. + * Variables that should disappear can be mapped to -1. + */ + public void setVariableMap(int[] variableMap) + { + this.variableMap = variableMap; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Initially, the code attribute editor doesn't contain any changes. + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + // Remap the variables of the instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Apply the code atribute editor. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + + // Remap the variables of the attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Remap the variable references of the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + + // Remove local variables that haven't been mapped. + localVariableTableAttribute.u2localVariableTableLength = + removeEmptyLocalVariables(localVariableTableAttribute.localVariableTable, + localVariableTableAttribute.u2localVariableTableLength); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Remap the variable references of the local variables. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + + // Remove local variables that haven't been mapped. + localVariableTypeTableAttribute.u2localVariableTypeTableLength = + removeEmptyLocalVariableTypes(localVariableTypeTableAttribute.localVariableTypeTable, + localVariableTypeTableAttribute.u2localVariableTypeTableLength); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + localVariableInfo.u2index = + remapVariable(localVariableInfo.u2index); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + localVariableTypeInfo.u2index = + remapVariable(localVariableTypeInfo.u2index); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + // Is the new variable index different from the original one? + int oldVariableIndex = variableInstruction.variableIndex; + int newVariableIndex = remapVariable(oldVariableIndex); + if (newVariableIndex != oldVariableIndex) + { + // Replace the instruction. + Instruction replacementInstruction = + new VariableInstruction(variableInstruction.opcode, + newVariableIndex, + variableInstruction.constant).shrink(); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + } + } + + + // Small utility methods. + + /** + * Returns the new variable index of the given variable. + */ + private int remapVariable(int variableIndex) + { + return variableMap[variableIndex]; + } + + + /** + * Returns the given list of local variables, without the ones that have + * been removed. + */ + private int removeEmptyLocalVariables(LocalVariableInfo[] localVariableInfos, + int localVariableInfoCount) + { + // Overwrite all empty local variable entries. + int newIndex = 0; + for (int index = 0; index < localVariableInfoCount; index++) + { + LocalVariableInfo localVariableInfo = localVariableInfos[index]; + if (localVariableInfo.u2index >= 0) + { + localVariableInfos[newIndex++] = localVariableInfo; + } + } + + return newIndex; + } + + + /** + * Returns the given list of local variable types, without the ones that + * have been removed. + */ + private int removeEmptyLocalVariableTypes(LocalVariableTypeInfo[] localVariableTypeInfos, + int localVariableTypeInfoCount) + { + // Overwrite all empty local variable type entries. + int newIndex = 0; + for (int index = 0; index < localVariableTypeInfoCount; index++) + { + LocalVariableTypeInfo localVariableTypeInfo = localVariableTypeInfos[index]; + if (localVariableTypeInfo.u2index >= 0) + { + localVariableTypeInfos[newIndex++] = localVariableTypeInfo; + } + } + + return newIndex; + } +} diff --git a/src/proguard/classfile/editor/VariableSizeUpdater.java b/src/proguard/classfile/editor/VariableSizeUpdater.java new file mode 100644 index 0000000..18958c5 --- /dev/null +++ b/src/proguard/classfile/editor/VariableSizeUpdater.java @@ -0,0 +1,98 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.editor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; + +/** + * This AttributeVisitor computes and updates the maximum local variable frame + * size of the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class VariableSizeUpdater +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // The minimum variable size is determined by the arguments. + codeAttribute.u2maxLocals = + ClassUtil.internalMethodParameterSize(method.getDescriptor(clazz), + method.getAccessFlags()); + + if (DEBUG) + { + System.out.println("VariableSizeUpdater: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + System.out.println(" Max locals: "+codeAttribute.u2maxLocals+" <- parameters"); + } + + // Go over all instructions. + codeAttribute.instructionsAccept(clazz, method, this); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + int variableSize = variableInstruction.variableIndex + 1; + if (variableInstruction.isCategory2()) + { + variableSize++; + } + + if (codeAttribute.u2maxLocals < variableSize) + { + codeAttribute.u2maxLocals = variableSize; + + if (DEBUG) + { + System.out.println("Max locals: "+codeAttribute.u2maxLocals+" <- "+variableInstruction.toString(offset)); + } + } + } +} diff --git a/src/proguard/classfile/editor/package.html b/src/proguard/classfile/editor/package.html new file mode 100644 index 0000000..d37f541 --- /dev/null +++ b/src/proguard/classfile/editor/package.html @@ -0,0 +1,3 @@ + +This package contains visitors to edit byte code. + diff --git a/src/proguard/classfile/instruction/BranchInstruction.java b/src/proguard/classfile/instruction/BranchInstruction.java new file mode 100644 index 0000000..2baa917 --- /dev/null +++ b/src/proguard/classfile/instruction/BranchInstruction.java @@ -0,0 +1,180 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This interface describes an instruction that branches to a given offset in + * the code. + * + * @author Eric Lafortune + */ +public class BranchInstruction extends Instruction +{ + public int branchOffset; + + + /** + * Creates an uninitialized BranchInstruction. + */ + public BranchInstruction() {} + + + public BranchInstruction(byte opcode, int branchOffset) + { + this.opcode = opcode; + this.branchOffset = branchOffset; + } + + + /** + * Copies the given instruction into this instruction. + * @param branchInstruction the instruction to be copied. + * @return this instruction. + */ + public BranchInstruction copy(BranchInstruction branchInstruction) + { + this.opcode = branchInstruction.opcode; + this.branchOffset = branchInstruction.branchOffset; + + return this; + } + + + // Implementations for Instruction. + + public byte canonicalOpcode() + { + // Remove the _w extension, if any. + switch (opcode) + { + case InstructionConstants.OP_GOTO_W: return InstructionConstants.OP_GOTO; + + case InstructionConstants.OP_JSR_W: return InstructionConstants.OP_JSR; + + default: return opcode; + } + } + + public Instruction shrink() + { + // Do we need an ordinary branch or a wide branch? + if (requiredBranchOffsetSize() == 2) + { + // Can we replace the wide branch by an ordinary branch? + if (opcode == InstructionConstants.OP_GOTO_W) + { + opcode = InstructionConstants.OP_GOTO; + } + else if (opcode == InstructionConstants.OP_JSR_W) + { + opcode = InstructionConstants.OP_JSR; + } + } + else + { + // Should we replace the ordinary branch by a wide branch? + if (opcode == InstructionConstants.OP_GOTO) + { + opcode = InstructionConstants.OP_GOTO_W; + } + else if (opcode == InstructionConstants.OP_JSR) + { + opcode = InstructionConstants.OP_JSR_W; + } + else + { + throw new IllegalArgumentException("Branch instruction can't be widened ("+this.toString()+")"); + } + } + + return this; + } + + protected void readInfo(byte[] code, int offset) + { + branchOffset = readSignedValue(code, offset, branchOffsetSize()); + } + + + protected void writeInfo(byte[] code, int offset) + { + if (requiredBranchOffsetSize() > branchOffsetSize()) + { + throw new IllegalArgumentException("Instruction has invalid branch offset size ("+this.toString(offset)+")"); + } + + writeSignedValue(code, offset, branchOffset, branchOffsetSize()); + } + + + public int length(int offset) + { + return 1 + branchOffsetSize(); + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + instructionVisitor.visitBranchInstruction(clazz, method, codeAttribute, offset, this); + } + + + public String toString(int offset) + { + return "["+offset+"] "+toString()+" (target="+(offset+branchOffset)+")"; + } + + + // Implementations for Object. + + public String toString() + { + return getName()+" "+(branchOffset >= 0 ? "+" : "")+branchOffset; + } + + + // Small utility methods. + + /** + * Returns the branch offset size for this instruction. + */ + private int branchOffsetSize() + { + return opcode == InstructionConstants.OP_GOTO_W || + opcode == InstructionConstants.OP_JSR_W ? 4 : + 2; + } + + + /** + * Computes the required branch offset size for this instruction's branch + * offset. + */ + private int requiredBranchOffsetSize() + { + return branchOffset << 16 >> 16 == branchOffset ? 2 : + 4; + } +} diff --git a/src/proguard/classfile/instruction/ConstantInstruction.java b/src/proguard/classfile/instruction/ConstantInstruction.java new file mode 100644 index 0000000..6c2d1a3 --- /dev/null +++ b/src/proguard/classfile/instruction/ConstantInstruction.java @@ -0,0 +1,303 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.ClassUtil; + +/** + * This Instruction represents an instruction that refers to an entry in the + * constant pool. + * + * @author Eric Lafortune + */ +public class ConstantInstruction extends Instruction +implements ConstantVisitor +{ + public int constantIndex; + public int constant; + + + // Fields acting as return parameters for the ConstantVisitor methods. + private int parameterStackDelta; + private int typeStackDelta; + + + /** + * Creates an uninitialized ConstantInstruction. + */ + public ConstantInstruction() {} + + + /** + * Creates a new ConstantInstruction with the given opcode and constant pool + * index. + */ + public ConstantInstruction(byte opcode, int constantIndex) + { + this(opcode, constantIndex, 0); + } + + + /** + * Creates a new ConstantInstruction with the given opcode, constant pool + * index, and constant. + */ + public ConstantInstruction(byte opcode, int constantIndex, int constant) + { + this.opcode = opcode; + this.constantIndex = constantIndex; + this.constant = constant; + } + + + /** + * Copies the given instruction into this instruction. + * @param constantInstruction the instruction to be copied. + * @return this instruction. + */ + public ConstantInstruction copy(ConstantInstruction constantInstruction) + { + this.opcode = constantInstruction.opcode; + this.constantIndex = constantInstruction.constantIndex; + this.constant = constantInstruction.constant; + + return this; + } + + + // Implementations for Instruction. + + public byte canonicalOpcode() + { + // Remove the _w extension, if any. + switch (opcode) + { + case InstructionConstants.OP_LDC_W: + case InstructionConstants.OP_LDC2_W: return InstructionConstants.OP_LDC; + + default: return opcode; + } + } + + public Instruction shrink() + { + // Do we need a short index or a long index? + if (requiredConstantIndexSize() == 1) + { + // Can we replace the long instruction by a short instruction? + if (opcode == InstructionConstants.OP_LDC_W) + { + opcode = InstructionConstants.OP_LDC; + } + } + else + { + // Should we replace the short instruction by a long instruction? + if (opcode == InstructionConstants.OP_LDC) + { + opcode = InstructionConstants.OP_LDC_W; + } + } + + return this; + } + + protected void readInfo(byte[] code, int offset) + { + int constantIndexSize = constantIndexSize(); + int constantSize = constantSize(); + + constantIndex = readValue(code, offset, constantIndexSize); offset += constantIndexSize; + constant = readValue(code, offset, constantSize); + } + + + protected void writeInfo(byte[] code, int offset) + { + int constantIndexSize = constantIndexSize(); + int constantSize = constantSize(); + + if (requiredConstantIndexSize() > constantIndexSize) + { + throw new IllegalArgumentException("Instruction has invalid constant index size ("+this.toString(offset)+")"); + } + + writeValue(code, offset, constantIndex, constantIndexSize); offset += constantIndexSize; + writeValue(code, offset, constant, constantSize); + } + + + public int length(int offset) + { + return 1 + constantIndexSize() + constantSize(); + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + instructionVisitor.visitConstantInstruction(clazz, method, codeAttribute, offset, this); + } + + + public int stackPopCount(Clazz clazz) + { + int stackPopCount = super.stackPopCount(clazz); + + // Some special cases. + switch (opcode) + { + case InstructionConstants.OP_MULTIANEWARRAY: + // For each dimension, an integer size is popped from the stack. + stackPopCount += constant; + break; + + case InstructionConstants.OP_PUTSTATIC: + case InstructionConstants.OP_PUTFIELD: + // The field value is be popped from the stack. + clazz.constantPoolEntryAccept(constantIndex, this); + stackPopCount += typeStackDelta; + break; + + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + // The some parameters may be popped from the stack. + clazz.constantPoolEntryAccept(constantIndex, this); + stackPopCount += parameterStackDelta; + break; + } + + return stackPopCount; + } + + + public int stackPushCount(Clazz clazz) + { + int stackPushCount = super.stackPushCount(clazz); + + // Some special cases. + switch (opcode) + { + case InstructionConstants.OP_GETSTATIC: + case InstructionConstants.OP_GETFIELD: + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + // The field value or a return value may be pushed onto the stack. + clazz.constantPoolEntryAccept(constantIndex, this); + stackPushCount += typeStackDelta; + break; + } + + return stackPushCount; + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) {} + public void visitLongConstant(Clazz clazz, LongConstant longConstant) {} + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) {} + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) {} + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) {} + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) {} + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) {} + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) {} + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + String type = fieldrefConstant.getType(clazz); + + typeStackDelta = ClassUtil.internalTypeSize(ClassUtil.internalMethodReturnType(type)); + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + visitRefConstant(clazz, interfaceMethodrefConstant); + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + visitRefConstant(clazz, methodrefConstant); + } + + + private void visitRefConstant(Clazz clazz, RefConstant methodrefConstant) + { + String type = methodrefConstant.getType(clazz); + + parameterStackDelta = ClassUtil.internalMethodParameterSize(type); + typeStackDelta = ClassUtil.internalTypeSize(ClassUtil.internalMethodReturnType(type)); + } + + + // Implementations for Object. + + public String toString() + { + return getName()+" #"+constantIndex; + } + + + // Small utility methods. + + /** + * Returns the constant pool index size for this instruction. + */ + private int constantIndexSize() + { + return opcode == InstructionConstants.OP_LDC ? 1 : + 2; + } + + + /** + * Returns the constant size for this instruction. + */ + private int constantSize() + { + return opcode == InstructionConstants.OP_MULTIANEWARRAY ? 1 : + opcode == InstructionConstants.OP_INVOKEINTERFACE ? 2 : + 0; + } + + + /** + * Computes the required constant pool index size for this instruction's + * constant pool index. + */ + private int requiredConstantIndexSize() + { + return (constantIndex & 0xff) == constantIndex ? 1 : + (constantIndex & 0xffff) == constantIndex ? 2 : + 4; + } +} diff --git a/src/proguard/classfile/instruction/Instruction.java b/src/proguard/classfile/instruction/Instruction.java new file mode 100644 index 0000000..8437495 --- /dev/null +++ b/src/proguard/classfile/instruction/Instruction.java @@ -0,0 +1,920 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * Base class for representing instructions. + * + * @author Eric Lafortune + */ +public abstract class Instruction +{ + // An array for marking Category 2 instructions. + private static final boolean[] IS_CATEGORY2 = new boolean[] + { + false, // nop + false, // aconst_null + false, // iconst_m1 + false, // iconst_0 + false, // iconst_1 + false, // iconst_2 + false, // iconst_3 + false, // iconst_4 + false, // iconst_5 + true, // lconst_0 + true, // lconst_1 + false, // fconst_0 + false, // fconst_1 + false, // fconst_2 + true, // dconst_0 + true, // dconst_1 + false, // bipush + false, // sipush + false, // ldc + false, // ldc_w + true, // ldc2_w + false, // iload + true, // lload + false, // fload + true, // dload + false, // aload + false, // iload_0 + false, // iload_1 + false, // iload_2 + false, // iload_3 + true, // lload_0 + true, // lload_1 + true, // lload_2 + true, // lload_3 + false, // fload_0 + false, // fload_1 + false, // fload_2 + false, // fload_3 + true, // dload_0 + true, // dload_1 + true, // dload_2 + true, // dload_3 + false, // aload_0 + false, // aload_1 + false, // aload_2 + false, // aload_3 + false, // iaload + true, // laload + false, // faload + true, // daload + false, // aaload + false, // baload + false, // caload + false, // saload + false, // istore + true, // lstore + false, // fstore + true, // dstore + false, // astore + false, // istore_0 + false, // istore_1 + false, // istore_2 + false, // istore_3 + true, // lstore_0 + true, // lstore_1 + true, // lstore_2 + true, // lstore_3 + false, // fstore_0 + false, // fstore_1 + false, // fstore_2 + false, // fstore_3 + true, // dstore_0 + true, // dstore_1 + true, // dstore_2 + true, // dstore_3 + false, // astore_0 + false, // astore_1 + false, // astore_2 + false, // astore_3 + false, // iastore + true, // lastore + false, // fastore + true, // dastore + false, // aastore + false, // bastore + false, // castore + false, // sastore + false, // pop + true, // pop2 + false, // dup + false, // dup_x1 + false, // dup_x2 + true, // dup2 + true, // dup2_x1 + true, // dup2_x2 + false, // swap + false, // iadd + true, // ladd + false, // fadd + true, // dadd + false, // isub + true, // lsub + false, // fsub + true, // dsub + false, // imul + true, // lmul + false, // fmul + true, // dmul + false, // idiv + true, // ldiv + false, // fdiv + true, // ddiv + false, // irem + true, // lrem + false, // frem + true, // drem + false, // ineg + true, // lneg + false, // fneg + true, // dneg + false, // ishl + true, // lshl + false, // ishr + true, // lshr + false, // iushr + true, // lushr + false, // iand + true, // land + false, // ior + true, // lor + false, // ixor + true, // lxor + false, // iinc + false, // i2l + false, // i2f + false, // i2d + true, // l2i + true, // l2f + true, // l2d + false, // f2i + false, // f2l + false, // f2d + true, // d2i + true, // d2l + true, // d2f + false, // i2b + false, // i2c + false, // i2s + true, // lcmp + false, // fcmpl + false, // fcmpg + true, // dcmpl + true, // dcmpg + false, // ifeq + false, // ifne + false, // iflt + false, // ifge + false, // ifgt + false, // ifle + false, // ificmpeq + false, // ificmpne + false, // ificmplt + false, // ificmpge + false, // ificmpgt + false, // ificmple + false, // ifacmpeq + false, // ifacmpne + false, // goto + false, // jsr + false, // ret + false, // tableswitch + false, // lookupswitch + false, // ireturn + true, // lreturn + false, // freturn + true, // dreturn + false, // areturn + false, // return + false, // getstatic + false, // putstatic + false, // getfield + false, // putfield + false, // invokevirtual + false, // invokespecial + false, // invokestatic + false, // invokeinterface + false, // unused + false, // new + false, // newarray + false, // anewarray + false, // arraylength + false, // athrow + false, // checkcast + false, // instanceof + false, // monitorenter + false, // monitorexit + false, // wide + false, // multianewarray + false, // ifnull + false, // ifnonnull + false, // goto_w + false, // jsr_w + }; + + + // An array containing the fixed number of entries popped from the stack, + // for all instructions. + private static final int[] STACK_POP_COUNTS = new int[] + { + 0, // nop + 0, // aconst_null + 0, // iconst_m1 + 0, // iconst_0 + 0, // iconst_1 + 0, // iconst_2 + 0, // iconst_3 + 0, // iconst_4 + 0, // iconst_5 + 0, // lconst_0 + 0, // lconst_1 + 0, // fconst_0 + 0, // fconst_1 + 0, // fconst_2 + 0, // dconst_0 + 0, // dconst_1 + 0, // bipush + 0, // sipush + 0, // ldc + 0, // ldc_w + 0, // ldc2_w + 0, // iload + 0, // lload + 0, // fload + 0, // dload + 0, // aload + 0, // iload_0 + 0, // iload_1 + 0, // iload_2 + 0, // iload_3 + 0, // lload_0 + 0, // lload_1 + 0, // lload_2 + 0, // lload_3 + 0, // fload_0 + 0, // fload_1 + 0, // fload_2 + 0, // fload_3 + 0, // dload_0 + 0, // dload_1 + 0, // dload_2 + 0, // dload_3 + 0, // aload_0 + 0, // aload_1 + 0, // aload_2 + 0, // aload_3 + 2, // iaload + 2, // laload + 2, // faload + 2, // daload + 2, // aaload + 2, // baload + 2, // caload + 2, // saload + 1, // istore + 2, // lstore + 1, // fstore + 2, // dstore + 1, // astore + 1, // istore_0 + 1, // istore_1 + 1, // istore_2 + 1, // istore_3 + 2, // lstore_0 + 2, // lstore_1 + 2, // lstore_2 + 2, // lstore_3 + 1, // fstore_0 + 1, // fstore_1 + 1, // fstore_2 + 1, // fstore_3 + 2, // dstore_0 + 2, // dstore_1 + 2, // dstore_2 + 2, // dstore_3 + 1, // astore_0 + 1, // astore_1 + 1, // astore_2 + 1, // astore_3 + 3, // iastore + 4, // lastore + 3, // fastore + 4, // dastore + 3, // aastore + 3, // bastore + 3, // castore + 3, // sastore + 1, // pop + 2, // pop2 + 1, // dup + 2, // dup_x1 + 3, // dup_x2 + 2, // dup2 + 3, // dup2_x1 + 4, // dup2_x2 + 2, // swap + 2, // iadd + 4, // ladd + 2, // fadd + 4, // dadd + 2, // isub + 4, // lsub + 2, // fsub + 4, // dsub + 2, // imul + 4, // lmul + 2, // fmul + 4, // dmul + 2, // idiv + 4, // ldiv + 2, // fdiv + 4, // ddiv + 2, // irem + 4, // lrem + 2, // frem + 4, // drem + 1, // ineg + 2, // lneg + 1, // fneg + 2, // dneg + 2, // ishl + 3, // lshl + 2, // ishr + 3, // lshr + 2, // iushr + 3, // lushr + 2, // iand + 4, // land + 2, // ior + 4, // lor + 2, // ixor + 4, // lxor + 0, // iinc + 1, // i2l + 1, // i2f + 1, // i2d + 2, // l2i + 2, // l2f + 2, // l2d + 1, // f2i + 1, // f2l + 1, // f2d + 2, // d2i + 2, // d2l + 2, // d2f + 1, // i2b + 1, // i2c + 1, // i2s + 4, // lcmp + 2, // fcmpl + 2, // fcmpg + 4, // dcmpl + 4, // dcmpg + 1, // ifeq + 1, // ifne + 1, // iflt + 1, // ifge + 1, // ifgt + 1, // ifle + 2, // ificmpeq + 2, // ificmpne + 2, // ificmplt + 2, // ificmpge + 2, // ificmpgt + 2, // ificmple + 2, // ifacmpeq + 2, // ifacmpne + 0, // goto + 0, // jsr + 0, // ret + 1, // tableswitch + 1, // lookupswitch + 1, // ireturn + 2, // lreturn + 1, // freturn + 2, // dreturn + 1, // areturn + 0, // return + 0, // getstatic + 0, // putstatic + 1, // getfield + 1, // putfield + 1, // invokevirtual + 1, // invokespecial + 0, // invokestatic + 1, // invokeinterface + 0, // unused + 0, // new + 1, // newarray + 1, // anewarray + 1, // arraylength + 1, // athrow + 1, // checkcast + 1, // instanceof + 1, // monitorenter + 1, // monitorexit + 0, // wide + 0, // multianewarray + 1, // ifnull + 1, // ifnonnull + 0, // goto_w + 0, // jsr_w + }; + + + // An array containing the fixed number of entries pushed onto the stack, + // for all instructions. + private static final int[] STACK_PUSH_COUNTS = new int[] + { + 0, // nop + 1, // aconst_null + 1, // iconst_m1 + 1, // iconst_0 + 1, // iconst_1 + 1, // iconst_2 + 1, // iconst_3 + 1, // iconst_4 + 1, // iconst_5 + 2, // lconst_0 + 2, // lconst_1 + 1, // fconst_0 + 1, // fconst_1 + 1, // fconst_2 + 2, // dconst_0 + 2, // dconst_1 + 1, // bipush + 1, // sipush + 1, // ldc + 1, // ldc_w + 2, // ldc2_w + 1, // iload + 2, // lload + 1, // fload + 2, // dload + 1, // aload + 1, // iload_0 + 1, // iload_1 + 1, // iload_2 + 1, // iload_3 + 2, // lload_0 + 2, // lload_1 + 2, // lload_2 + 2, // lload_3 + 1, // fload_0 + 1, // fload_1 + 1, // fload_2 + 1, // fload_3 + 2, // dload_0 + 2, // dload_1 + 2, // dload_2 + 2, // dload_3 + 1, // aload_0 + 1, // aload_1 + 1, // aload_2 + 1, // aload_3 + 1, // iaload + 2, // laload + 1, // faload + 2, // daload + 1, // aaload + 1, // baload + 1, // caload + 1, // saload + 0, // istore + 0, // lstore + 0, // fstore + 0, // dstore + 0, // astore + 0, // istore_0 + 0, // istore_1 + 0, // istore_2 + 0, // istore_3 + 0, // lstore_0 + 0, // lstore_1 + 0, // lstore_2 + 0, // lstore_3 + 0, // fstore_0 + 0, // fstore_1 + 0, // fstore_2 + 0, // fstore_3 + 0, // dstore_0 + 0, // dstore_1 + 0, // dstore_2 + 0, // dstore_3 + 0, // astore_0 + 0, // astore_1 + 0, // astore_2 + 0, // astore_3 + 0, // iastore + 0, // lastore + 0, // fastore + 0, // dastore + 0, // aastore + 0, // bastore + 0, // castore + 0, // sastore + 0, // pop + 0, // pop2 + 2, // dup + 3, // dup_x1 + 4, // dup_x2 + 4, // dup2 + 5, // dup2_x1 + 6, // dup2_x2 + 2, // swap + 1, // iadd + 2, // ladd + 1, // fadd + 2, // dadd + 1, // isub + 2, // lsub + 1, // fsub + 2, // dsub + 1, // imul + 2, // lmul + 1, // fmul + 2, // dmul + 1, // idiv + 2, // ldiv + 1, // fdiv + 2, // ddiv + 1, // irem + 2, // lrem + 1, // frem + 2, // drem + 1, // ineg + 2, // lneg + 1, // fneg + 2, // dneg + 1, // ishl + 2, // lshl + 1, // ishr + 2, // lshr + 1, // iushr + 2, // lushr + 1, // iand + 2, // land + 1, // ior + 2, // lor + 1, // ixor + 2, // lxor + 0, // iinc + 2, // i2l + 1, // i2f + 2, // i2d + 1, // l2i + 1, // l2f + 2, // l2d + 1, // f2i + 2, // f2l + 2, // f2d + 1, // d2i + 2, // d2l + 1, // d2f + 1, // i2b + 1, // i2c + 1, // i2s + 1, // lcmp + 1, // fcmpl + 1, // fcmpg + 1, // dcmpl + 1, // dcmpg + 0, // ifeq + 0, // ifne + 0, // iflt + 0, // ifge + 0, // ifgt + 0, // ifle + 0, // ificmpeq + 0, // ificmpne + 0, // ificmplt + 0, // ificmpge + 0, // ificmpgt + 0, // ificmple + 0, // ifacmpeq + 0, // ifacmpne + 0, // goto + 1, // jsr + 0, // ret + 0, // tableswitch + 0, // lookupswitch + 0, // ireturn + 0, // lreturn + 0, // freturn + 0, // dreturn + 0, // areturn + 0, // return + 0, // getstatic + 0, // putstatic + 0, // getfield + 0, // putfield + 0, // invokevirtual + 0, // invokespecial + 0, // invokestatic + 0, // invokeinterface + 0, // unused + 1, // new + 1, // newarray + 1, // anewarray + 1, // arraylength + 0, // athrow + 1, // checkcast + 1, // instanceof + 0, // monitorenter + 0, // monitorexit + 0, // wide + 1, // multianewarray + 0, // ifnull + 0, // ifnonnull + 0, // goto_w + 1, // jsr_w + }; + + + public byte opcode; + + + /** + * Returns the canonical opcode of this instruction, i.e. typically the + * opcode whose extension has been removed. + */ + public byte canonicalOpcode() + { + return opcode; + } + + + /** + * Shrinks this instruction to its shortest possible form. + * @return this instruction. + */ + public abstract Instruction shrink(); + + + + /** + * Writes the Instruction at the given offset in the given code attribute. + */ + public final void write(CodeAttribute codeAttribute, int offset) + { + write(codeAttribute.code, offset); + } + + + /** + * Writes the Instruction at the given offset in the given code array. + */ + public void write(byte[] code, int offset) + { + // Write the wide opcode, if necessary. + if (isWide()) + { + code[offset++] = InstructionConstants.OP_WIDE; + } + + // Write the opcode. + code[offset++] = opcode; + + // Write any additional arguments. + writeInfo(code, offset); + } + + + /** + * Returns whether the instruction is wide, i.e. preceded by a wide opcode. + * With the current specifications, only variable instructions can be wide. + */ + protected boolean isWide() + { + return false; + } + + + /** + * Reads the data following the instruction opcode. + */ + protected abstract void readInfo(byte[] code, int offset); + + + /** + * Writes data following the instruction opcode. + */ + protected abstract void writeInfo(byte[] code, int offset); + + + /** + * Returns the length in bytes of the instruction. + */ + public abstract int length(int offset); + + + /** + * Accepts the given visitor. + */ + public abstract void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor); + + + /** + * Returns a description of the instruction, at the given offset. + */ + public String toString(int offset) + { + return "["+offset+"] "+ this.toString(); + } + + + /** + * Returns the name of the instruction. + */ + public String getName() + { + return InstructionConstants.NAMES[opcode & 0xff]; + } + + + /** + * Returns whether the instruction is a Category 2 instruction. This means + * that it operates on long or double arguments. + */ + public boolean isCategory2() + { + return IS_CATEGORY2[opcode & 0xff]; + } + + + /** + * Returns the number of entries popped from the stack during the execution + * of the instruction. + */ + public int stackPopCount(Clazz clazz) + { + return STACK_POP_COUNTS[opcode & 0xff]; + } + + + /** + * Returns the number of entries pushed onto the stack during the execution + * of the instruction. + */ + public int stackPushCount(Clazz clazz) + { + return STACK_PUSH_COUNTS[opcode & 0xff]; + } + + + // Small utility methods. + + protected static int readByte(byte[] code, int offset) + { + return code[offset] & 0xff; + } + + protected static int readShort(byte[] code, int offset) + { + return ((code[offset++] & 0xff) << 8) | + ( code[offset ] & 0xff ); + } + + protected static int readInt(byte[] code, int offset) + { + return ( code[offset++] << 24) | + ((code[offset++] & 0xff) << 16) | + ((code[offset++] & 0xff) << 8) | + ( code[offset ] & 0xff ); + } + + protected static int readValue(byte[] code, int offset, int valueSize) + { + switch (valueSize) + { + case 0: return 0; + case 1: return readByte( code, offset); + case 2: return readShort(code, offset); + case 4: return readInt( code, offset); + default: throw new IllegalArgumentException("Unsupported value size ["+valueSize+"]"); + } + } + + protected static int readSignedByte(byte[] code, int offset) + { + return code[offset]; + } + + protected static int readSignedShort(byte[] code, int offset) + { + return (code[offset++] << 8) | + (code[offset ] & 0xff); + } + + protected static int readSignedValue(byte[] code, int offset, int valueSize) + { + switch (valueSize) + { + case 0: return 0; + case 1: return readSignedByte( code, offset); + case 2: return readSignedShort(code, offset); + case 4: return readInt( code, offset); + default: throw new IllegalArgumentException("Unsupported value size ["+valueSize+"]"); + } + } + + protected static void writeByte(byte[] code, int offset, int value) + { + if (value > 0xff) + { + throw new IllegalArgumentException("Unsigned byte value larger than 0xff ["+value+"]"); + } + + code[offset] = (byte)value; + } + + protected static void writeShort(byte[] code, int offset, int value) + { + if (value > 0xffff) + { + throw new IllegalArgumentException("Unsigned short value larger than 0xffff ["+value+"]"); + } + + code[offset++] = (byte)(value >> 8); + code[offset ] = (byte)(value ); + } + + protected static void writeInt(byte[] code, int offset, int value) + { + code[offset++] = (byte)(value >> 24); + code[offset++] = (byte)(value >> 16); + code[offset++] = (byte)(value >> 8); + code[offset ] = (byte)(value ); + } + + protected static void writeValue(byte[] code, int offset, int value, int valueSize) + { + switch (valueSize) + { + case 0: break; + case 1: writeByte( code, offset, value); break; + case 2: writeShort(code, offset, value); break; + case 4: writeInt( code, offset, value); break; + default: throw new IllegalArgumentException("Unsupported value size ["+valueSize+"]"); + } + } + + protected static void writeSignedByte(byte[] code, int offset, int value) + { + if (value << 24 >> 24 != value) + { + throw new IllegalArgumentException("Signed byte value out of range ["+value+"]"); + } + + code[offset] = (byte)value; + } + + protected static void writeSignedShort(byte[] code, int offset, int value) + { + if (value << 16 >> 16 != value) + { + throw new IllegalArgumentException("Signed short value out of range ["+value+"]"); + } + + code[offset++] = (byte)(value >> 8); + code[offset ] = (byte)(value ); + } + + protected static void writeSignedValue(byte[] code, int offset, int value, int valueSize) + { + switch (valueSize) + { + case 0: break; + case 1: writeSignedByte( code, offset, value); break; + case 2: writeSignedShort(code, offset, value); break; + case 4: writeInt( code, offset, value); break; + default: throw new IllegalArgumentException("Unsupported value size ["+valueSize+"]"); + } + } +} diff --git a/src/proguard/classfile/instruction/InstructionConstants.java b/src/proguard/classfile/instruction/InstructionConstants.java new file mode 100644 index 0000000..78730b3 --- /dev/null +++ b/src/proguard/classfile/instruction/InstructionConstants.java @@ -0,0 +1,449 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +/** + * Representation of an instruction. + * + * @author Eric Lafortune + */ +public interface InstructionConstants +{ + public static final byte OP_NOP = 0; + public static final byte OP_ACONST_NULL = 1; + public static final byte OP_ICONST_M1 = 2; + public static final byte OP_ICONST_0 = 3; + public static final byte OP_ICONST_1 = 4; + public static final byte OP_ICONST_2 = 5; + public static final byte OP_ICONST_3 = 6; + public static final byte OP_ICONST_4 = 7; + public static final byte OP_ICONST_5 = 8; + public static final byte OP_LCONST_0 = 9; + public static final byte OP_LCONST_1 = 10; + public static final byte OP_FCONST_0 = 11; + public static final byte OP_FCONST_1 = 12; + public static final byte OP_FCONST_2 = 13; + public static final byte OP_DCONST_0 = 14; + public static final byte OP_DCONST_1 = 15; + public static final byte OP_BIPUSH = 16; + public static final byte OP_SIPUSH = 17; + public static final byte OP_LDC = 18; + public static final byte OP_LDC_W = 19; + public static final byte OP_LDC2_W = 20; + public static final byte OP_ILOAD = 21; + public static final byte OP_LLOAD = 22; + public static final byte OP_FLOAD = 23; + public static final byte OP_DLOAD = 24; + public static final byte OP_ALOAD = 25; + public static final byte OP_ILOAD_0 = 26; + public static final byte OP_ILOAD_1 = 27; + public static final byte OP_ILOAD_2 = 28; + public static final byte OP_ILOAD_3 = 29; + public static final byte OP_LLOAD_0 = 30; + public static final byte OP_LLOAD_1 = 31; + public static final byte OP_LLOAD_2 = 32; + public static final byte OP_LLOAD_3 = 33; + public static final byte OP_FLOAD_0 = 34; + public static final byte OP_FLOAD_1 = 35; + public static final byte OP_FLOAD_2 = 36; + public static final byte OP_FLOAD_3 = 37; + public static final byte OP_DLOAD_0 = 38; + public static final byte OP_DLOAD_1 = 39; + public static final byte OP_DLOAD_2 = 40; + public static final byte OP_DLOAD_3 = 41; + public static final byte OP_ALOAD_0 = 42; + public static final byte OP_ALOAD_1 = 43; + public static final byte OP_ALOAD_2 = 44; + public static final byte OP_ALOAD_3 = 45; + public static final byte OP_IALOAD = 46; + public static final byte OP_LALOAD = 47; + public static final byte OP_FALOAD = 48; + public static final byte OP_DALOAD = 49; + public static final byte OP_AALOAD = 50; + public static final byte OP_BALOAD = 51; + public static final byte OP_CALOAD = 52; + public static final byte OP_SALOAD = 53; + public static final byte OP_ISTORE = 54; + public static final byte OP_LSTORE = 55; + public static final byte OP_FSTORE = 56; + public static final byte OP_DSTORE = 57; + public static final byte OP_ASTORE = 58; + public static final byte OP_ISTORE_0 = 59; + public static final byte OP_ISTORE_1 = 60; + public static final byte OP_ISTORE_2 = 61; + public static final byte OP_ISTORE_3 = 62; + public static final byte OP_LSTORE_0 = 63; + public static final byte OP_LSTORE_1 = 64; + public static final byte OP_LSTORE_2 = 65; + public static final byte OP_LSTORE_3 = 66; + public static final byte OP_FSTORE_0 = 67; + public static final byte OP_FSTORE_1 = 68; + public static final byte OP_FSTORE_2 = 69; + public static final byte OP_FSTORE_3 = 70; + public static final byte OP_DSTORE_0 = 71; + public static final byte OP_DSTORE_1 = 72; + public static final byte OP_DSTORE_2 = 73; + public static final byte OP_DSTORE_3 = 74; + public static final byte OP_ASTORE_0 = 75; + public static final byte OP_ASTORE_1 = 76; + public static final byte OP_ASTORE_2 = 77; + public static final byte OP_ASTORE_3 = 78; + public static final byte OP_IASTORE = 79; + public static final byte OP_LASTORE = 80; + public static final byte OP_FASTORE = 81; + public static final byte OP_DASTORE = 82; + public static final byte OP_AASTORE = 83; + public static final byte OP_BASTORE = 84; + public static final byte OP_CASTORE = 85; + public static final byte OP_SASTORE = 86; + public static final byte OP_POP = 87; + public static final byte OP_POP2 = 88; + public static final byte OP_DUP = 89; + public static final byte OP_DUP_X1 = 90; + public static final byte OP_DUP_X2 = 91; + public static final byte OP_DUP2 = 92; + public static final byte OP_DUP2_X1 = 93; + public static final byte OP_DUP2_X2 = 94; + public static final byte OP_SWAP = 95; + public static final byte OP_IADD = 96; + public static final byte OP_LADD = 97; + public static final byte OP_FADD = 98; + public static final byte OP_DADD = 99; + public static final byte OP_ISUB = 100; + public static final byte OP_LSUB = 101; + public static final byte OP_FSUB = 102; + public static final byte OP_DSUB = 103; + public static final byte OP_IMUL = 104; + public static final byte OP_LMUL = 105; + public static final byte OP_FMUL = 106; + public static final byte OP_DMUL = 107; + public static final byte OP_IDIV = 108; + public static final byte OP_LDIV = 109; + public static final byte OP_FDIV = 110; + public static final byte OP_DDIV = 111; + public static final byte OP_IREM = 112; + public static final byte OP_LREM = 113; + public static final byte OP_FREM = 114; + public static final byte OP_DREM = 115; + public static final byte OP_INEG = 116; + public static final byte OP_LNEG = 117; + public static final byte OP_FNEG = 118; + public static final byte OP_DNEG = 119; + public static final byte OP_ISHL = 120; + public static final byte OP_LSHL = 121; + public static final byte OP_ISHR = 122; + public static final byte OP_LSHR = 123; + public static final byte OP_IUSHR = 124; + public static final byte OP_LUSHR = 125; + public static final byte OP_IAND = 126; + public static final byte OP_LAND = 127; + public static final byte OP_IOR = -128; + public static final byte OP_LOR = -127; + public static final byte OP_IXOR = -126; + public static final byte OP_LXOR = -125; + public static final byte OP_IINC = -124; + public static final byte OP_I2L = -123; + public static final byte OP_I2F = -122; + public static final byte OP_I2D = -121; + public static final byte OP_L2I = -120; + public static final byte OP_L2F = -119; + public static final byte OP_L2D = -118; + public static final byte OP_F2I = -117; + public static final byte OP_F2L = -116; + public static final byte OP_F2D = -115; + public static final byte OP_D2I = -114; + public static final byte OP_D2L = -113; + public static final byte OP_D2F = -112; + public static final byte OP_I2B = -111; + public static final byte OP_I2C = -110; + public static final byte OP_I2S = -109; + public static final byte OP_LCMP = -108; + public static final byte OP_FCMPL = -107; + public static final byte OP_FCMPG = -106; + public static final byte OP_DCMPL = -105; + public static final byte OP_DCMPG = -104; + public static final byte OP_IFEQ = -103; + public static final byte OP_IFNE = -102; + public static final byte OP_IFLT = -101; + public static final byte OP_IFGE = -100; + public static final byte OP_IFGT = -99; + public static final byte OP_IFLE = -98; + public static final byte OP_IFICMPEQ = -97; + public static final byte OP_IFICMPNE = -96; + public static final byte OP_IFICMPLT = -95; + public static final byte OP_IFICMPGE = -94; + public static final byte OP_IFICMPGT = -93; + public static final byte OP_IFICMPLE = -92; + public static final byte OP_IFACMPEQ = -91; + public static final byte OP_IFACMPNE = -90; + public static final byte OP_GOTO = -89; + public static final byte OP_JSR = -88; + public static final byte OP_RET = -87; + public static final byte OP_TABLESWITCH = -86; + public static final byte OP_LOOKUPSWITCH = -85; + public static final byte OP_IRETURN = -84; + public static final byte OP_LRETURN = -83; + public static final byte OP_FRETURN = -82; + public static final byte OP_DRETURN = -81; + public static final byte OP_ARETURN = -80; + public static final byte OP_RETURN = -79; + public static final byte OP_GETSTATIC = -78; + public static final byte OP_PUTSTATIC = -77; + public static final byte OP_GETFIELD = -76; + public static final byte OP_PUTFIELD = -75; + public static final byte OP_INVOKEVIRTUAL = -74; + public static final byte OP_INVOKESPECIAL = -73; + public static final byte OP_INVOKESTATIC = -72; + public static final byte OP_INVOKEINTERFACE = -71; +// public static final byte OP_UNUSED = -70; + public static final byte OP_NEW = -69; + public static final byte OP_NEWARRAY = -68; + public static final byte OP_ANEWARRAY = -67; + public static final byte OP_ARRAYLENGTH = -66; + public static final byte OP_ATHROW = -65; + public static final byte OP_CHECKCAST = -64; + public static final byte OP_INSTANCEOF = -63; + public static final byte OP_MONITORENTER = -62; + public static final byte OP_MONITOREXIT = -61; + public static final byte OP_WIDE = -60; + public static final byte OP_MULTIANEWARRAY = -59; + public static final byte OP_IFNULL = -58; + public static final byte OP_IFNONNULL = -57; + public static final byte OP_GOTO_W = -56; + public static final byte OP_JSR_W = -55; + + + public static final String[] NAMES = + { + "nop", + "aconst_null", + "iconst_m1", + "iconst_0", + "iconst_1", + "iconst_2", + "iconst_3", + "iconst_4", + "iconst_5", + "lconst_0", + "lconst_1", + "fconst_0", + "fconst_1", + "fconst_2", + "dconst_0", + "dconst_1", + "bipush", + "sipush", + "ldc", + "ldc_w", + "ldc2_w", + "iload", + "lload", + "fload", + "dload", + "aload", + "iload_0", + "iload_1", + "iload_2", + "iload_3", + "lload_0", + "lload_1", + "lload_2", + "lload_3", + "fload_0", + "fload_1", + "fload_2", + "fload_3", + "dload_0", + "dload_1", + "dload_2", + "dload_3", + "aload_0", + "aload_1", + "aload_2", + "aload_3", + "iaload", + "laload", + "faload", + "daload", + "aaload", + "baload", + "caload", + "saload", + "istore", + "lstore", + "fstore", + "dstore", + "astore", + "istore_0", + "istore_1", + "istore_2", + "istore_3", + "lstore_0", + "lstore_1", + "lstore_2", + "lstore_3", + "fstore_0", + "fstore_1", + "fstore_2", + "fstore_3", + "dstore_0", + "dstore_1", + "dstore_2", + "dstore_3", + "astore_0", + "astore_1", + "astore_2", + "astore_3", + "iastore", + "lastore", + "fastore", + "dastore", + "aastore", + "bastore", + "castore", + "sastore", + "pop", + "pop2", + "dup", + "dup_x1", + "dup_x2", + "dup2", + "dup2_x1", + "dup2_x2", + "swap", + "iadd", + "ladd", + "fadd", + "dadd", + "isub", + "lsub", + "fsub", + "dsub", + "imul", + "lmul", + "fmul", + "dmul", + "idiv", + "ldiv", + "fdiv", + "ddiv", + "irem", + "lrem", + "frem", + "drem", + "ineg", + "lneg", + "fneg", + "dneg", + "ishl", + "lshl", + "ishr", + "lshr", + "iushr", + "lushr", + "iand", + "land", + "ior", + "lor", + "ixor", + "lxor", + "iinc", + "i2l", + "i2f", + "i2d", + "l2i", + "l2f", + "l2d", + "f2i", + "f2l", + "f2d", + "d2i", + "d2l", + "d2f", + "i2b", + "i2c", + "i2s", + "lcmp", + "fcmpl", + "fcmpg", + "dcmpl", + "dcmpg", + "ifeq", + "ifne", + "iflt", + "ifge", + "ifgt", + "ifle", + "ificmpeq", + "ificmpne", + "ificmplt", + "ificmpge", + "ificmpgt", + "ificmple", + "ifacmpeq", + "ifacmpne", + "goto", + "jsr", + "ret", + "tableswitch", + "lookupswitch", + "ireturn", + "lreturn", + "freturn", + "dreturn", + "areturn", + "return", + "getstatic", + "putstatic", + "getfield", + "putfield", + "invokevirtual", + "invokespecial", + "invokestatic", + "invokeinterface", + "unused", + "new", + "newarray", + "anewarray", + "arraylength", + "athrow", + "checkcast", + "instanceof", + "monitorenter", + "monitorexit", + "wide", + "multianewarray", + "ifnull", + "ifnonnull", + "goto_w", + "jsr_w", + }; + + + public static final byte ARRAY_T_BOOLEAN = 4; + public static final byte ARRAY_T_CHAR = 5; + public static final byte ARRAY_T_FLOAT = 6; + public static final byte ARRAY_T_DOUBLE = 7; + public static final byte ARRAY_T_BYTE = 8; + public static final byte ARRAY_T_SHORT = 9; + public static final byte ARRAY_T_INT = 10; + public static final byte ARRAY_T_LONG = 11; +} diff --git a/src/proguard/classfile/instruction/InstructionFactory.java b/src/proguard/classfile/instruction/InstructionFactory.java new file mode 100644 index 0000000..f898471 --- /dev/null +++ b/src/proguard/classfile/instruction/InstructionFactory.java @@ -0,0 +1,299 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +/** + * This class provides methods to create and reuse Instruction objects. + * + * @author Eric Lafortune + */ +public class InstructionFactory +{ + /** + * Creates a new Instruction from the data in the byte array, starting + * at the given index. + */ + public static Instruction create(byte[] code, int offset) + { + Instruction instruction; + + int index = offset; + byte opcode = code[index++]; + + boolean wide = false; + if (opcode == InstructionConstants.OP_WIDE) + { + opcode = code[index++]; + wide = true; + } + + switch (opcode) + { + // Simple instructions. + case InstructionConstants.OP_NOP: + case InstructionConstants.OP_ACONST_NULL: + case InstructionConstants.OP_ICONST_M1: + case InstructionConstants.OP_ICONST_0: + case InstructionConstants.OP_ICONST_1: + case InstructionConstants.OP_ICONST_2: + case InstructionConstants.OP_ICONST_3: + case InstructionConstants.OP_ICONST_4: + case InstructionConstants.OP_ICONST_5: + case InstructionConstants.OP_LCONST_0: + case InstructionConstants.OP_LCONST_1: + case InstructionConstants.OP_FCONST_0: + case InstructionConstants.OP_FCONST_1: + case InstructionConstants.OP_FCONST_2: + case InstructionConstants.OP_DCONST_0: + case InstructionConstants.OP_DCONST_1: + + case InstructionConstants.OP_BIPUSH: + case InstructionConstants.OP_SIPUSH: + + case InstructionConstants.OP_IALOAD: + case InstructionConstants.OP_LALOAD: + case InstructionConstants.OP_FALOAD: + case InstructionConstants.OP_DALOAD: + case InstructionConstants.OP_AALOAD: + case InstructionConstants.OP_BALOAD: + case InstructionConstants.OP_CALOAD: + case InstructionConstants.OP_SALOAD: + + case InstructionConstants.OP_IASTORE: + case InstructionConstants.OP_LASTORE: + case InstructionConstants.OP_FASTORE: + case InstructionConstants.OP_DASTORE: + case InstructionConstants.OP_AASTORE: + case InstructionConstants.OP_BASTORE: + case InstructionConstants.OP_CASTORE: + case InstructionConstants.OP_SASTORE: + case InstructionConstants.OP_POP: + case InstructionConstants.OP_POP2: + case InstructionConstants.OP_DUP: + case InstructionConstants.OP_DUP_X1: + case InstructionConstants.OP_DUP_X2: + case InstructionConstants.OP_DUP2: + case InstructionConstants.OP_DUP2_X1: + case InstructionConstants.OP_DUP2_X2: + case InstructionConstants.OP_SWAP: + case InstructionConstants.OP_IADD: + case InstructionConstants.OP_LADD: + case InstructionConstants.OP_FADD: + case InstructionConstants.OP_DADD: + case InstructionConstants.OP_ISUB: + case InstructionConstants.OP_LSUB: + case InstructionConstants.OP_FSUB: + case InstructionConstants.OP_DSUB: + case InstructionConstants.OP_IMUL: + case InstructionConstants.OP_LMUL: + case InstructionConstants.OP_FMUL: + case InstructionConstants.OP_DMUL: + case InstructionConstants.OP_IDIV: + case InstructionConstants.OP_LDIV: + case InstructionConstants.OP_FDIV: + case InstructionConstants.OP_DDIV: + case InstructionConstants.OP_IREM: + case InstructionConstants.OP_LREM: + case InstructionConstants.OP_FREM: + case InstructionConstants.OP_DREM: + case InstructionConstants.OP_INEG: + case InstructionConstants.OP_LNEG: + case InstructionConstants.OP_FNEG: + case InstructionConstants.OP_DNEG: + case InstructionConstants.OP_ISHL: + case InstructionConstants.OP_LSHL: + case InstructionConstants.OP_ISHR: + case InstructionConstants.OP_LSHR: + case InstructionConstants.OP_IUSHR: + case InstructionConstants.OP_LUSHR: + case InstructionConstants.OP_IAND: + case InstructionConstants.OP_LAND: + case InstructionConstants.OP_IOR: + case InstructionConstants.OP_LOR: + case InstructionConstants.OP_IXOR: + case InstructionConstants.OP_LXOR: + + case InstructionConstants.OP_I2L: + case InstructionConstants.OP_I2F: + case InstructionConstants.OP_I2D: + case InstructionConstants.OP_L2I: + case InstructionConstants.OP_L2F: + case InstructionConstants.OP_L2D: + case InstructionConstants.OP_F2I: + case InstructionConstants.OP_F2L: + case InstructionConstants.OP_F2D: + case InstructionConstants.OP_D2I: + case InstructionConstants.OP_D2L: + case InstructionConstants.OP_D2F: + case InstructionConstants.OP_I2B: + case InstructionConstants.OP_I2C: + case InstructionConstants.OP_I2S: + case InstructionConstants.OP_LCMP: + case InstructionConstants.OP_FCMPL: + case InstructionConstants.OP_FCMPG: + case InstructionConstants.OP_DCMPL: + case InstructionConstants.OP_DCMPG: + + case InstructionConstants.OP_IRETURN: + case InstructionConstants.OP_LRETURN: + case InstructionConstants.OP_FRETURN: + case InstructionConstants.OP_DRETURN: + case InstructionConstants.OP_ARETURN: + case InstructionConstants.OP_RETURN: + + case InstructionConstants.OP_NEWARRAY: + case InstructionConstants.OP_ARRAYLENGTH: + case InstructionConstants.OP_ATHROW: + + case InstructionConstants.OP_MONITORENTER: + case InstructionConstants.OP_MONITOREXIT: + instruction = new SimpleInstruction(); + break; + + // Instructions with a contant pool index. + case InstructionConstants.OP_LDC: + case InstructionConstants.OP_LDC_W: + case InstructionConstants.OP_LDC2_W: + + case InstructionConstants.OP_GETSTATIC: + case InstructionConstants.OP_PUTSTATIC: + case InstructionConstants.OP_GETFIELD: + case InstructionConstants.OP_PUTFIELD: + + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + + case InstructionConstants.OP_NEW: + case InstructionConstants.OP_ANEWARRAY: + case InstructionConstants.OP_CHECKCAST: + case InstructionConstants.OP_INSTANCEOF: + case InstructionConstants.OP_MULTIANEWARRAY: + instruction = new ConstantInstruction(); + break; + + // Instructions with a local variable index. + case InstructionConstants.OP_ILOAD: + case InstructionConstants.OP_LLOAD: + case InstructionConstants.OP_FLOAD: + case InstructionConstants.OP_DLOAD: + case InstructionConstants.OP_ALOAD: + case InstructionConstants.OP_ILOAD_0: + case InstructionConstants.OP_ILOAD_1: + case InstructionConstants.OP_ILOAD_2: + case InstructionConstants.OP_ILOAD_3: + case InstructionConstants.OP_LLOAD_0: + case InstructionConstants.OP_LLOAD_1: + case InstructionConstants.OP_LLOAD_2: + case InstructionConstants.OP_LLOAD_3: + case InstructionConstants.OP_FLOAD_0: + case InstructionConstants.OP_FLOAD_1: + case InstructionConstants.OP_FLOAD_2: + case InstructionConstants.OP_FLOAD_3: + case InstructionConstants.OP_DLOAD_0: + case InstructionConstants.OP_DLOAD_1: + case InstructionConstants.OP_DLOAD_2: + case InstructionConstants.OP_DLOAD_3: + case InstructionConstants.OP_ALOAD_0: + case InstructionConstants.OP_ALOAD_1: + case InstructionConstants.OP_ALOAD_2: + case InstructionConstants.OP_ALOAD_3: + + case InstructionConstants.OP_ISTORE: + case InstructionConstants.OP_LSTORE: + case InstructionConstants.OP_FSTORE: + case InstructionConstants.OP_DSTORE: + case InstructionConstants.OP_ASTORE: + case InstructionConstants.OP_ISTORE_0: + case InstructionConstants.OP_ISTORE_1: + case InstructionConstants.OP_ISTORE_2: + case InstructionConstants.OP_ISTORE_3: + case InstructionConstants.OP_LSTORE_0: + case InstructionConstants.OP_LSTORE_1: + case InstructionConstants.OP_LSTORE_2: + case InstructionConstants.OP_LSTORE_3: + case InstructionConstants.OP_FSTORE_0: + case InstructionConstants.OP_FSTORE_1: + case InstructionConstants.OP_FSTORE_2: + case InstructionConstants.OP_FSTORE_3: + case InstructionConstants.OP_DSTORE_0: + case InstructionConstants.OP_DSTORE_1: + case InstructionConstants.OP_DSTORE_2: + case InstructionConstants.OP_DSTORE_3: + case InstructionConstants.OP_ASTORE_0: + case InstructionConstants.OP_ASTORE_1: + case InstructionConstants.OP_ASTORE_2: + case InstructionConstants.OP_ASTORE_3: + + case InstructionConstants.OP_IINC: + + case InstructionConstants.OP_RET: + instruction = new VariableInstruction(wide); + break; + + // Instructions with a branch offset operand. + case InstructionConstants.OP_IFEQ: + case InstructionConstants.OP_IFNE: + case InstructionConstants.OP_IFLT: + case InstructionConstants.OP_IFGE: + case InstructionConstants.OP_IFGT: + case InstructionConstants.OP_IFLE: + case InstructionConstants.OP_IFICMPEQ: + case InstructionConstants.OP_IFICMPNE: + case InstructionConstants.OP_IFICMPLT: + case InstructionConstants.OP_IFICMPGE: + case InstructionConstants.OP_IFICMPGT: + case InstructionConstants.OP_IFICMPLE: + case InstructionConstants.OP_IFACMPEQ: + case InstructionConstants.OP_IFACMPNE: + case InstructionConstants.OP_GOTO: + case InstructionConstants.OP_JSR: + + case InstructionConstants.OP_IFNULL: + case InstructionConstants.OP_IFNONNULL: + + case InstructionConstants.OP_GOTO_W: + case InstructionConstants.OP_JSR_W: + instruction = new BranchInstruction(); + break; + + // The tableswitch instruction. + case InstructionConstants.OP_TABLESWITCH: + instruction = new TableSwitchInstruction(); + break; + + // The lookupswitch instruction. + case InstructionConstants.OP_LOOKUPSWITCH: + instruction = new LookUpSwitchInstruction(); + break; + + default: + throw new IllegalArgumentException("Unknown instruction opcode ["+opcode+"] at offset "+offset); + } + + instruction.opcode = opcode; + + instruction.readInfo(code, index); + + return instruction; + } +} diff --git a/src/proguard/classfile/instruction/InstructionUtil.java b/src/proguard/classfile/instruction/InstructionUtil.java new file mode 100644 index 0000000..a3a328a --- /dev/null +++ b/src/proguard/classfile/instruction/InstructionUtil.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.ClassConstants; + +/** + * Utility methods for converting between representations of names and + * descriptions. + * + * @author Eric Lafortune + */ +public class InstructionUtil +{ + /** + * Returns the internal type corresponding to the given 'newarray' type. + * @param arrayType InstructionConstants.ARRAY_T_BOOLEAN, + * InstructionConstants.ARRAY_T_BYTE, + * InstructionConstants.ARRAY_T_CHAR, + * InstructionConstants.ARRAY_T_SHORT, + * InstructionConstants.ARRAY_T_INT, + * InstructionConstants.ARRAY_T_LONG, + * InstructionConstants.ARRAY_T_FLOAT, or + * InstructionConstants.ARRAY_T_DOUBLE. + * @return ClassConstants.INTERNAL_TYPE_BOOLEAN, + * ClassConstants.INTERNAL_TYPE_BYTE, + * ClassConstants.INTERNAL_TYPE_CHAR, + * ClassConstants.INTERNAL_TYPE_SHORT, + * ClassConstants.INTERNAL_TYPE_INT, + * ClassConstants.INTERNAL_TYPE_LONG, + * ClassConstants.INTERNAL_TYPE_FLOAT, or + * ClassConstants.INTERNAL_TYPE_DOUBLE. + */ + public static char internalTypeFromArrayType(byte arrayType) + { + switch (arrayType) + { + case InstructionConstants.ARRAY_T_BOOLEAN: return ClassConstants.INTERNAL_TYPE_BOOLEAN; + case InstructionConstants.ARRAY_T_CHAR: return ClassConstants.INTERNAL_TYPE_CHAR; + case InstructionConstants.ARRAY_T_FLOAT: return ClassConstants.INTERNAL_TYPE_FLOAT; + case InstructionConstants.ARRAY_T_DOUBLE: return ClassConstants.INTERNAL_TYPE_DOUBLE; + case InstructionConstants.ARRAY_T_BYTE: return ClassConstants.INTERNAL_TYPE_BYTE; + case InstructionConstants.ARRAY_T_SHORT: return ClassConstants.INTERNAL_TYPE_SHORT; + case InstructionConstants.ARRAY_T_INT: return ClassConstants.INTERNAL_TYPE_INT; + case InstructionConstants.ARRAY_T_LONG: return ClassConstants.INTERNAL_TYPE_LONG; + default: throw new IllegalArgumentException("Unknown array type ["+arrayType+"]"); + } + } +} diff --git a/src/proguard/classfile/instruction/LookUpSwitchInstruction.java b/src/proguard/classfile/instruction/LookUpSwitchInstruction.java new file mode 100644 index 0000000..178cce5 --- /dev/null +++ b/src/proguard/classfile/instruction/LookUpSwitchInstruction.java @@ -0,0 +1,135 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This Instruction represents a simple instruction without variable arguments + * or constant pool references. + * + * @author Eric Lafortune + */ +public class LookUpSwitchInstruction extends SwitchInstruction +{ + public int[] cases; + + + /** + * Creates an uninitialized LookUpSwitchInstruction. + */ + public LookUpSwitchInstruction() {} + + + /** + * Creates a new LookUpSwitchInstruction with the given arguments. + */ + public LookUpSwitchInstruction(byte opcode, + int defaultOffset, + int[] cases, + int[] jumpOffsets) + { + this.opcode = opcode; + this.defaultOffset = defaultOffset; + this.cases = cases; + this.jumpOffsets = jumpOffsets; + } + + + /** + * Copies the given instruction into this instruction. + * @param lookUpSwitchInstruction the instruction to be copied. + * @return this instruction. + */ + public LookUpSwitchInstruction copy(LookUpSwitchInstruction lookUpSwitchInstruction) + { + this.opcode = lookUpSwitchInstruction.opcode; + this.defaultOffset = lookUpSwitchInstruction.defaultOffset; + this.cases = lookUpSwitchInstruction.cases; + this.jumpOffsets = lookUpSwitchInstruction.jumpOffsets; + + return this; + } + + + // Implementations for Instruction. + + public Instruction shrink() + { + // There aren't any ways to shrink this instruction. + return this; + } + + protected void readInfo(byte[] code, int offset) + { + // Skip up to three padding bytes. + offset += -offset & 3; + + // Read the two 32-bit arguments. + defaultOffset = readInt(code, offset); offset += 4; + int jumpOffsetCount = readInt(code, offset); offset += 4; + + // Read the matches-offset pairs. + cases = new int[jumpOffsetCount]; + jumpOffsets = new int[jumpOffsetCount]; + + for (int index = 0; index < jumpOffsetCount; index++) + { + cases[index] = readInt(code, offset); offset += 4; + jumpOffsets[index] = readInt(code, offset); offset += 4; + } + } + + + protected void writeInfo(byte[] code, int offset) + { + // Write up to three padding bytes. + while ((offset & 3) != 0) + { + writeByte(code, offset++, 0); + } + + // Write the two 32-bit arguments. + writeInt(code, offset, defaultOffset); offset += 4; + writeInt(code, offset, cases.length); offset += 4; + + // Write the matches-offset pairs. + for (int index = 0; index < cases.length; index++) + { + writeInt(code, offset, cases[index]); offset += 4; + writeInt(code, offset, jumpOffsets[index]); offset += 4; + } + } + + + public int length(int offset) + { + return 1 + (-(offset+1) & 3) + 8 + cases.length * 8; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + instructionVisitor.visitLookUpSwitchInstruction(clazz, method, codeAttribute, offset, this); + } +} diff --git a/src/proguard/classfile/instruction/SimpleInstruction.java b/src/proguard/classfile/instruction/SimpleInstruction.java new file mode 100644 index 0000000..84e6344 --- /dev/null +++ b/src/proguard/classfile/instruction/SimpleInstruction.java @@ -0,0 +1,255 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This Instruction represents a simple instruction without variable arguments + * or constant pool references. + * + * @author Eric Lafortune + */ +public class SimpleInstruction extends Instruction +{ + public int constant; + + + /** + * Creates an uninitialized SimpleInstruction. + */ + public SimpleInstruction() {} + + + /** + * Creates a new SimpleInstruction with the given opcode. + */ + public SimpleInstruction(byte opcode) + { + this(opcode, embeddedConstant(opcode)); + } + + + /** + * Creates a new SimpleInstruction with the given opcode and constant. + */ + public SimpleInstruction(byte opcode, int constant) + { + this.opcode = opcode; + this.constant = constant; + } + + + /** + * Copies the given instruction into this instruction. + * @param simpleInstruction the instruction to be copied. + * @return this instruction. + */ + public SimpleInstruction copy(SimpleInstruction simpleInstruction) + { + this.opcode = simpleInstruction.opcode; + this.constant = simpleInstruction.constant; + + return this; + } + + + /** + * Return the embedded constant of the given opcode, or 0 if the opcode + * doesn't have one. + */ + private static int embeddedConstant(byte opcode) + { + switch (opcode) + { + case InstructionConstants.OP_ICONST_M1: return -1; + + case InstructionConstants.OP_ICONST_1: + case InstructionConstants.OP_LCONST_1: + case InstructionConstants.OP_FCONST_1: + case InstructionConstants.OP_DCONST_1: return 1; + + case InstructionConstants.OP_ICONST_2: + case InstructionConstants.OP_FCONST_2: return 2; + + case InstructionConstants.OP_ICONST_3: return 3; + + case InstructionConstants.OP_ICONST_4: return 4; + + case InstructionConstants.OP_ICONST_5: return 5; + + default: return 0; + } + } + + + // Implementations for Instruction. + + public byte canonicalOpcode() + { + // Replace any _1, _2, _3,... extension by _0. + switch (opcode) + { + case InstructionConstants.OP_ICONST_M1: + case InstructionConstants.OP_ICONST_0: + case InstructionConstants.OP_ICONST_1: + case InstructionConstants.OP_ICONST_2: + case InstructionConstants.OP_ICONST_3: + case InstructionConstants.OP_ICONST_4: + case InstructionConstants.OP_ICONST_5: + case InstructionConstants.OP_BIPUSH: + case InstructionConstants.OP_SIPUSH: return InstructionConstants.OP_ICONST_0; + + case InstructionConstants.OP_LCONST_0: + case InstructionConstants.OP_LCONST_1: return InstructionConstants.OP_LCONST_0; + + case InstructionConstants.OP_FCONST_0: + case InstructionConstants.OP_FCONST_1: + case InstructionConstants.OP_FCONST_2: return InstructionConstants.OP_FCONST_0; + + case InstructionConstants.OP_DCONST_0: + case InstructionConstants.OP_DCONST_1: return InstructionConstants.OP_DCONST_0; + + default: return opcode; + } + } + + public Instruction shrink() + { + // Reconstruct the opcode of the shortest instruction, if there are + // any alternatives. + switch (opcode) + { + case InstructionConstants.OP_ICONST_M1: + case InstructionConstants.OP_ICONST_0: + case InstructionConstants.OP_ICONST_1: + case InstructionConstants.OP_ICONST_2: + case InstructionConstants.OP_ICONST_3: + case InstructionConstants.OP_ICONST_4: + case InstructionConstants.OP_ICONST_5: + case InstructionConstants.OP_BIPUSH: + case InstructionConstants.OP_SIPUSH: + switch (requiredConstantSize()) + { + case 0: + opcode = (byte)(InstructionConstants.OP_ICONST_0 + constant); + break; + case 1: + opcode = InstructionConstants.OP_BIPUSH; + break; + case 2: + opcode = InstructionConstants.OP_SIPUSH; + break; + } + break; + + case InstructionConstants.OP_LCONST_0: + case InstructionConstants.OP_LCONST_1: + opcode = (byte)(InstructionConstants.OP_LCONST_0 + constant); + break; + + case InstructionConstants.OP_FCONST_0: + case InstructionConstants.OP_FCONST_1: + case InstructionConstants.OP_FCONST_2: + opcode = (byte)(InstructionConstants.OP_FCONST_0 + constant); + break; + + case InstructionConstants.OP_DCONST_0: + case InstructionConstants.OP_DCONST_1: + opcode = (byte)(InstructionConstants.OP_DCONST_0 + constant); + break; + } + + return this; + } + + protected void readInfo(byte[] code, int offset) + { + int constantSize = constantSize(); + + // Also initialize embedded constants that are different from 0. + constant = constantSize == 0 ? + embeddedConstant(opcode) : + readSignedValue(code, offset, constantSize); + } + + + protected void writeInfo(byte[] code, int offset) + { + int constantSize = constantSize(); + + if (requiredConstantSize() > constantSize) + { + throw new IllegalArgumentException("Instruction has invalid constant size ("+this.toString(offset)+")"); + } + + writeSignedValue(code, offset, constant, constantSize); + } + + + public int length(int offset) + { + return 1 + constantSize(); + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + instructionVisitor.visitSimpleInstruction(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public String toString() + { + return getName() + + (constantSize() > 0 ? " "+constant : ""); + } + + + // Small utility methods. + + /** + * Returns the constant size for this instruction. + */ + private int constantSize() + { + return opcode == InstructionConstants.OP_BIPUSH || + opcode == InstructionConstants.OP_NEWARRAY ? 1 : + opcode == InstructionConstants.OP_SIPUSH ? 2 : + 0; + } + + + /** + * Computes the required constant size for this instruction. + */ + private int requiredConstantSize() + { + return constant >= -1 && constant <= 5 ? 0 : + constant << 24 >> 24 == constant ? 1 : + constant << 16 >> 16 == constant ? 2 : + 4; + } +} diff --git a/src/proguard/classfile/instruction/SwitchInstruction.java b/src/proguard/classfile/instruction/SwitchInstruction.java new file mode 100644 index 0000000..b98c2fb --- /dev/null +++ b/src/proguard/classfile/instruction/SwitchInstruction.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +/** + * This Instruction represents a simple instruction without variable arguments + * or constant pool references. + * + * @author Eric Lafortune + */ +public abstract class SwitchInstruction extends Instruction +{ + public int defaultOffset; + public int[] jumpOffsets; + + + /** + * Creates an uninitialized SwitchInstruction. + */ + public SwitchInstruction() {} + + + /** + * Creates a new SwitchInstruction with the given arguments. + */ + public SwitchInstruction(byte opcode, + int defaultOffset, + int[] jumpOffsets) + { + this.opcode = opcode; + this.defaultOffset = defaultOffset; + this.jumpOffsets = jumpOffsets; + } + + + /** + * Copies the given instruction into this instruction. + * @param switchInstruction the instruction to be copied. + * @return this instruction. + */ + public SwitchInstruction copy(SwitchInstruction switchInstruction) + { + this.opcode = switchInstruction.opcode; + this.defaultOffset = switchInstruction.defaultOffset; + this.jumpOffsets = switchInstruction.jumpOffsets; + + return this; + } + + + // Implementations for Instruction. + + public String toString(int offset) + { + return "["+offset+"] "+toString()+" (target="+(offset+defaultOffset)+")"; + } + + + // Implementations for Object. + + public String toString() + { + return getName()+" ("+jumpOffsets.length+" offsets, default="+defaultOffset+")"; + } +} diff --git a/src/proguard/classfile/instruction/TableSwitchInstruction.java b/src/proguard/classfile/instruction/TableSwitchInstruction.java new file mode 100644 index 0000000..ee81af5 --- /dev/null +++ b/src/proguard/classfile/instruction/TableSwitchInstruction.java @@ -0,0 +1,139 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This Instruction represents a simple instruction without variable arguments + * or constant pool references. + * + * @author Eric Lafortune + */ +public class TableSwitchInstruction extends SwitchInstruction +{ + public int lowCase; + public int highCase; + + + /** + * Creates an uninitialized TableSwitchInstruction. + */ + public TableSwitchInstruction() {} + + + /** + * Creates a new TableSwitchInstruction with the given arguments. + */ + public TableSwitchInstruction(byte opcode, + int defaultOffset, + int lowCase, + int highCase, + int[] jumpOffsets) + { + this.opcode = opcode; + this.defaultOffset = defaultOffset; + this.lowCase = lowCase; + this.highCase = highCase; + this.jumpOffsets = jumpOffsets; + } + + + /** + * Copies the given instruction into this instruction. + * @param tableSwitchInstruction the instruction to be copied. + * @return this instruction. + */ + public TableSwitchInstruction copy(TableSwitchInstruction tableSwitchInstruction) + { + this.opcode = tableSwitchInstruction.opcode; + this.defaultOffset = tableSwitchInstruction.defaultOffset; + this.lowCase = tableSwitchInstruction.lowCase; + this.highCase = tableSwitchInstruction.highCase; + this.jumpOffsets = tableSwitchInstruction.jumpOffsets; + + return this; + } + + + // Implementations for Instruction. + + public Instruction shrink() + { + // There aren't any ways to shrink this instruction. + return this; + } + + protected void readInfo(byte[] code, int offset) + { + // Skip up to three padding bytes. + offset += -offset & 3; + + // Read the three 32-bit arguments. + defaultOffset = readInt(code, offset); offset += 4; + lowCase = readInt(code, offset); offset += 4; + highCase = readInt(code, offset); offset += 4; + + // Read the jump offsets. + jumpOffsets = new int[highCase - lowCase + 1]; + + for (int index = 0; index < jumpOffsets.length; index++) + { + jumpOffsets[index] = readInt(code, offset); offset += 4; + } + } + + + protected void writeInfo(byte[] code, int offset) + { + // Write up to three padding bytes. + while ((offset & 3) != 0) + { + writeByte(code, offset++, 0); + } + + // Write the three 32-bit arguments. + writeInt(code, offset, defaultOffset); offset += 4; + writeInt(code, offset, lowCase); offset += 4; + writeInt(code, offset, highCase); offset += 4; + + // Write the jump offsets. + int length = highCase - lowCase + 1; + for (int index = 0; index < length; index++) + { + writeInt(code, offset, jumpOffsets[index]); offset += 4; + } + } + + + public int length(int offset) + { + return 1 + (-(offset+1) & 3) + 12 + (highCase - lowCase + 1) * 4; + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + instructionVisitor.visitTableSwitchInstruction(clazz, method, codeAttribute, offset, this); + } +} diff --git a/src/proguard/classfile/instruction/VariableInstruction.java b/src/proguard/classfile/instruction/VariableInstruction.java new file mode 100644 index 0000000..309f802 --- /dev/null +++ b/src/proguard/classfile/instruction/VariableInstruction.java @@ -0,0 +1,372 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This Instruction represents an instruction that refers to a variable on the + * local variable stack. + * + * @author Eric Lafortune + */ +public class VariableInstruction extends Instruction +{ + public boolean wide; + public int variableIndex; + public int constant; + + + /** + * Creates an uninitialized VariableInstruction. + */ + public VariableInstruction() {} + + + public VariableInstruction(boolean wide) + { + this.wide = wide; + } + + + public VariableInstruction(byte opcode) + { + this(opcode, embeddedVariable(opcode), 0); + } + + + public VariableInstruction(byte opcode, + int variableIndex) + { + this(opcode, variableIndex, 0); + } + + + public VariableInstruction(byte opcode, + int variableIndex, + int constant) + { + this.opcode = opcode; + this.variableIndex = variableIndex; + this.constant = constant; + this.wide = requiredVariableIndexSize() > 1 || + requiredConstantSize() > 1; + } + + + /** + * Copies the given instruction into this instruction. + * @param variableInstruction the instruction to be copied. + * @return this instruction. + */ + public VariableInstruction copy(VariableInstruction variableInstruction) + { + this.opcode = variableInstruction.opcode; + this.variableIndex = variableInstruction.variableIndex; + this.constant = variableInstruction.constant; + this.wide = variableInstruction.wide; + + return this; + } + + + /** + * Return the embedded variable of the given opcode, or 0 if the opcode + * doesn't have one. + */ + private static int embeddedVariable(byte opcode) + { + switch (opcode) + { + case InstructionConstants.OP_ILOAD_1: + case InstructionConstants.OP_LLOAD_1: + case InstructionConstants.OP_FLOAD_1: + case InstructionConstants.OP_DLOAD_1: + case InstructionConstants.OP_ALOAD_1: + case InstructionConstants.OP_ISTORE_1: + case InstructionConstants.OP_LSTORE_1: + case InstructionConstants.OP_FSTORE_1: + case InstructionConstants.OP_DSTORE_1: + case InstructionConstants.OP_ASTORE_1: return 1; + + case InstructionConstants.OP_ILOAD_2: + case InstructionConstants.OP_LLOAD_2: + case InstructionConstants.OP_FLOAD_2: + case InstructionConstants.OP_DLOAD_2: + case InstructionConstants.OP_ALOAD_2: + case InstructionConstants.OP_ISTORE_2: + case InstructionConstants.OP_LSTORE_2: + case InstructionConstants.OP_FSTORE_2: + case InstructionConstants.OP_DSTORE_2: + case InstructionConstants.OP_ASTORE_2: return 2; + + case InstructionConstants.OP_ILOAD_3: + case InstructionConstants.OP_LLOAD_3: + case InstructionConstants.OP_FLOAD_3: + case InstructionConstants.OP_DLOAD_3: + case InstructionConstants.OP_ALOAD_3: + case InstructionConstants.OP_ISTORE_3: + case InstructionConstants.OP_LSTORE_3: + case InstructionConstants.OP_FSTORE_3: + case InstructionConstants.OP_DSTORE_3: + case InstructionConstants.OP_ASTORE_3: return 3; + + default: return 0; + } + } + + + /** + * Returns whether this instruction stores the value of a variable. + * The value is false for the ret instruction, but true for the iinc + * instruction. + */ + public boolean isStore() + { + // A store instruction can be recognized as follows. Note that this + // excludes the ret instruction, which has a negative opcode. + return opcode >= InstructionConstants.OP_ISTORE || + opcode == InstructionConstants.OP_IINC; + } + + + /** + * Returns whether this instruction loads the value of a variable. + * The value is true for the ret instruction and for the iinc + * instruction. + */ + public boolean isLoad() + { + // A load instruction can be recognized as follows. Note that this + // includes the ret instruction, which has a negative opcode. + return opcode < InstructionConstants.OP_ISTORE; + } + + + // Implementations for Instruction. + + public byte canonicalOpcode() + { + // Remove the _0, _1, _2, _3 extension, if any. + switch (opcode) + { + case InstructionConstants.OP_ILOAD_0: + case InstructionConstants.OP_ILOAD_1: + case InstructionConstants.OP_ILOAD_2: + case InstructionConstants.OP_ILOAD_3: return InstructionConstants.OP_ILOAD; + case InstructionConstants.OP_LLOAD_0: + case InstructionConstants.OP_LLOAD_1: + case InstructionConstants.OP_LLOAD_2: + case InstructionConstants.OP_LLOAD_3: return InstructionConstants.OP_LLOAD; + case InstructionConstants.OP_FLOAD_0: + case InstructionConstants.OP_FLOAD_1: + case InstructionConstants.OP_FLOAD_2: + case InstructionConstants.OP_FLOAD_3: return InstructionConstants.OP_FLOAD; + case InstructionConstants.OP_DLOAD_0: + case InstructionConstants.OP_DLOAD_1: + case InstructionConstants.OP_DLOAD_2: + case InstructionConstants.OP_DLOAD_3: return InstructionConstants.OP_DLOAD; + case InstructionConstants.OP_ALOAD_0: + case InstructionConstants.OP_ALOAD_1: + case InstructionConstants.OP_ALOAD_2: + case InstructionConstants.OP_ALOAD_3: return InstructionConstants.OP_ALOAD; + + case InstructionConstants.OP_ISTORE_0: + case InstructionConstants.OP_ISTORE_1: + case InstructionConstants.OP_ISTORE_2: + case InstructionConstants.OP_ISTORE_3: return InstructionConstants.OP_ISTORE; + case InstructionConstants.OP_LSTORE_0: + case InstructionConstants.OP_LSTORE_1: + case InstructionConstants.OP_LSTORE_2: + case InstructionConstants.OP_LSTORE_3: return InstructionConstants.OP_LSTORE; + case InstructionConstants.OP_FSTORE_0: + case InstructionConstants.OP_FSTORE_1: + case InstructionConstants.OP_FSTORE_2: + case InstructionConstants.OP_FSTORE_3: return InstructionConstants.OP_FSTORE; + case InstructionConstants.OP_DSTORE_0: + case InstructionConstants.OP_DSTORE_1: + case InstructionConstants.OP_DSTORE_2: + case InstructionConstants.OP_DSTORE_3: return InstructionConstants.OP_DSTORE; + case InstructionConstants.OP_ASTORE_0: + case InstructionConstants.OP_ASTORE_1: + case InstructionConstants.OP_ASTORE_2: + case InstructionConstants.OP_ASTORE_3: return InstructionConstants.OP_ASTORE; + + default: return opcode; + } + } + + public Instruction shrink() + { + opcode = canonicalOpcode(); + + // Is this instruction pointing to a variable with index from 0 to 3? + if (variableIndex <= 3) + { + switch (opcode) + { + case InstructionConstants.OP_ILOAD: opcode = (byte)(InstructionConstants.OP_ILOAD_0 + variableIndex); break; + case InstructionConstants.OP_LLOAD: opcode = (byte)(InstructionConstants.OP_LLOAD_0 + variableIndex); break; + case InstructionConstants.OP_FLOAD: opcode = (byte)(InstructionConstants.OP_FLOAD_0 + variableIndex); break; + case InstructionConstants.OP_DLOAD: opcode = (byte)(InstructionConstants.OP_DLOAD_0 + variableIndex); break; + case InstructionConstants.OP_ALOAD: opcode = (byte)(InstructionConstants.OP_ALOAD_0 + variableIndex); break; + + case InstructionConstants.OP_ISTORE: opcode = (byte)(InstructionConstants.OP_ISTORE_0 + variableIndex); break; + case InstructionConstants.OP_LSTORE: opcode = (byte)(InstructionConstants.OP_LSTORE_0 + variableIndex); break; + case InstructionConstants.OP_FSTORE: opcode = (byte)(InstructionConstants.OP_FSTORE_0 + variableIndex); break; + case InstructionConstants.OP_DSTORE: opcode = (byte)(InstructionConstants.OP_DSTORE_0 + variableIndex); break; + case InstructionConstants.OP_ASTORE: opcode = (byte)(InstructionConstants.OP_ASTORE_0 + variableIndex); break; + } + } + + // Only make the instruction wide if necessary. + wide = requiredVariableIndexSize() > 1 || + requiredConstantSize() > 1; + + return this; + } + + + protected boolean isWide() + { + return wide; + } + + + protected void readInfo(byte[] code, int offset) + { + int variableIndexSize = variableIndexSize(); + int constantSize = constantSize(); + + // Also initialize embedded variable indexes. + if (variableIndexSize == 0) + { + // An embedded variable index can be decoded as follows. + variableIndex = opcode < InstructionConstants.OP_ISTORE_0 ? + (opcode - InstructionConstants.OP_ILOAD_0 ) & 3 : + (opcode - InstructionConstants.OP_ISTORE_0) & 3; + } + else + { + variableIndex = readValue(code, offset, variableIndexSize); offset += variableIndexSize; + } + + constant = readSignedValue(code, offset, constantSize); + } + + + protected void writeInfo(byte[] code, int offset) + { + int variableIndexSize = variableIndexSize(); + int constantSize = constantSize(); + + if (requiredVariableIndexSize() > variableIndexSize) + { + throw new IllegalArgumentException("Instruction has invalid variable index size ("+this.toString(offset)+")"); + } + + if (requiredConstantSize() > constantSize) + { + throw new IllegalArgumentException("Instruction has invalid constant size ("+this.toString(offset)+")"); + } + + writeValue(code, offset, variableIndex, variableIndexSize); offset += variableIndexSize; + writeSignedValue(code, offset, constant, constantSize); + } + + + public int length(int offset) + { + return (wide ? 2 : 1) + variableIndexSize() + constantSize(); + } + + + public void accept(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, InstructionVisitor instructionVisitor) + { + instructionVisitor.visitVariableInstruction(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for Object. + + public String toString() + { + return getName() + + (wide ? "_w" : "") + + " v"+variableIndex + + (constantSize() > 0 ? ", "+constant : ""); + } + + + // Small utility methods. + + /** + * Returns the variable index size for this instruction. + */ + private int variableIndexSize() + { + return (opcode >= InstructionConstants.OP_ILOAD_0 && + opcode <= InstructionConstants.OP_ALOAD_3) || + (opcode >= InstructionConstants.OP_ISTORE_0 && + opcode <= InstructionConstants.OP_ASTORE_3) ? 0 : + wide ? 2 : + 1; + } + + + /** + * Computes the required variable index size for this instruction's variable + * index. + */ + private int requiredVariableIndexSize() + { + return (variableIndex & 0x3) == variableIndex ? 0 : + (variableIndex & 0xff) == variableIndex ? 1 : + (variableIndex & 0xffff) == variableIndex ? 2 : + 4; + + } + + + /** + * Returns the constant size for this instruction. + */ + private int constantSize() + { + return opcode != InstructionConstants.OP_IINC ? 0 : + wide ? 2 : + 1; + } + + + /** + * Computes the required constant size for this instruction's constant. + */ + private int requiredConstantSize() + { + return opcode != InstructionConstants.OP_IINC ? 0 : + constant << 24 >> 24 == constant ? 1 : + constant << 16 >> 16 == constant ? 2 : + 4; + } +} diff --git a/src/proguard/classfile/instruction/package.html b/src/proguard/classfile/instruction/package.html new file mode 100644 index 0000000..48c234e --- /dev/null +++ b/src/proguard/classfile/instruction/package.html @@ -0,0 +1,9 @@ + +This package contains classes to represent Java bytecode instructions. +

    +Not every instruction currently has its own class. Only groups of instructions +that refer to the constant pool get their own representations. +

    +While the package is sufficient for the current needs of the ProGuard +application, it may very well be reorganised and extended in the future. + diff --git a/src/proguard/classfile/instruction/visitor/AllInstructionVisitor.java b/src/proguard/classfile/instruction/visitor/AllInstructionVisitor.java new file mode 100644 index 0000000..71b2cde --- /dev/null +++ b/src/proguard/classfile/instruction/visitor/AllInstructionVisitor.java @@ -0,0 +1,56 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor lets a given InstructionVisitor visit all Instruction + * objects of the CodeAttribute objects it visits. + * + * @author Eric Lafortune + */ +public class AllInstructionVisitor +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final InstructionVisitor instructionVisitor; + + + public AllInstructionVisitor(InstructionVisitor instructionVisitor) + { + this.instructionVisitor = instructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + codeAttribute.instructionsAccept(clazz, method, instructionVisitor); + } +} diff --git a/src/proguard/classfile/instruction/visitor/InstructionCounter.java b/src/proguard/classfile/instruction/visitor/InstructionCounter.java new file mode 100644 index 0000000..1d10980 --- /dev/null +++ b/src/proguard/classfile/instruction/visitor/InstructionCounter.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.Instruction; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor counts the number of instructions that has been visited. + * + * @author Eric Lafortune + */ +public class InstructionCounter +extends SimplifiedVisitor +implements InstructionVisitor +{ + private int count; + + + /** + * Returns the number of instructions that has been visited so far. + */ + public int getCount() + { + return count; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int offset, + Instruction instruction) + { + count++; + } +} diff --git a/src/proguard/classfile/instruction/visitor/InstructionVisitor.java b/src/proguard/classfile/instruction/visitor/InstructionVisitor.java new file mode 100644 index 0000000..11af131 --- /dev/null +++ b/src/proguard/classfile/instruction/visitor/InstructionVisitor.java @@ -0,0 +1,42 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.*; + + +/** + * This interface specifies the methods for a visitor of + * Instruction objects. + * + * @author Eric Lafortune + */ +public interface InstructionVisitor +{ + public void visitSimpleInstruction( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction); + public void visitVariableInstruction( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction); + public void visitConstantInstruction( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction); + public void visitBranchInstruction( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction); + public void visitTableSwitchInstruction( Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction); + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction); +} diff --git a/src/proguard/classfile/instruction/visitor/MultiInstructionVisitor.java b/src/proguard/classfile/instruction/visitor/MultiInstructionVisitor.java new file mode 100644 index 0000000..aada455 --- /dev/null +++ b/src/proguard/classfile/instruction/visitor/MultiInstructionVisitor.java @@ -0,0 +1,131 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.instruction.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.*; + + +/** + * This InstructionVisitor delegates all visits to each InstructionVisitor + * in a given list. + * + * @author Eric Lafortune + */ +public class MultiInstructionVisitor implements InstructionVisitor +{ + private static final int ARRAY_SIZE_INCREMENT = 5; + + + private InstructionVisitor[] instructionVisitors; + private int instructionVisitorCount; + + + public MultiInstructionVisitor() + { + } + + + public MultiInstructionVisitor(InstructionVisitor[] instructionVisitors) + { + this.instructionVisitors = instructionVisitors; + this.instructionVisitorCount = instructionVisitors.length; + } + + + public void addInstructionVisitor(InstructionVisitor instructionVisitor) + { + ensureArraySize(); + + instructionVisitors[instructionVisitorCount++] = instructionVisitor; + } + + + private void ensureArraySize() + { + if (instructionVisitors == null) + { + instructionVisitors = new InstructionVisitor[ARRAY_SIZE_INCREMENT]; + } + else if (instructionVisitors.length == instructionVisitorCount) + { + InstructionVisitor[] newInstructionVisitors = + new InstructionVisitor[instructionVisitorCount + + ARRAY_SIZE_INCREMENT]; + System.arraycopy(instructionVisitors, 0, + newInstructionVisitors, 0, + instructionVisitorCount); + instructionVisitors = newInstructionVisitors; + } + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + for (int index = 0; index < instructionVisitorCount; index++) + { + instructionVisitors[index].visitSimpleInstruction(clazz, method, codeAttribute, offset, simpleInstruction); + } + } + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + for (int index = 0; index < instructionVisitorCount; index++) + { + instructionVisitors[index].visitVariableInstruction(clazz, method, codeAttribute, offset, variableInstruction); + } + } + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + for (int index = 0; index < instructionVisitorCount; index++) + { + instructionVisitors[index].visitConstantInstruction(clazz, method, codeAttribute, offset, constantInstruction); + } + } + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + for (int index = 0; index < instructionVisitorCount; index++) + { + instructionVisitors[index].visitBranchInstruction(clazz, method, codeAttribute, offset, branchInstruction); + } + } + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + for (int index = 0; index < instructionVisitorCount; index++) + { + instructionVisitors[index].visitTableSwitchInstruction(clazz, method, codeAttribute, offset, tableSwitchInstruction); + } + } + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + for (int index = 0; index < instructionVisitorCount; index++) + { + instructionVisitors[index].visitLookUpSwitchInstruction(clazz, method, codeAttribute, offset, lookUpSwitchInstruction); + } + } +} diff --git a/src/proguard/classfile/instruction/visitor/package.html b/src/proguard/classfile/instruction/visitor/package.html new file mode 100644 index 0000000..a31a408 --- /dev/null +++ b/src/proguard/classfile/instruction/visitor/package.html @@ -0,0 +1,3 @@ + +This package contains visitors for instructions. + diff --git a/src/proguard/classfile/io/LibraryClassReader.java b/src/proguard/classfile/io/LibraryClassReader.java new file mode 100644 index 0000000..f14471c --- /dev/null +++ b/src/proguard/classfile/io/LibraryClassReader.java @@ -0,0 +1,362 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.io; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +import java.io.DataInput; + +/** + * This ClassVisitor fills out the LibraryClass objects that it visits with data + * from the given DataInput object. + * + * @author Eric Lafortune + */ +public class LibraryClassReader +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor +{ + private static final LibraryField[] EMPTY_LIBRARY_FIELDS = new LibraryField[0]; + private static final LibraryMethod[] EMPTY_LIBRARY_METHODS = new LibraryMethod[0]; + + + private final RuntimeDataInput dataInput; + private final boolean skipNonPublicClasses; + private final boolean skipNonPublicClassMembers; + + // A global array that acts as a parameter for the visitor methods. + private Constant[] constantPool; + + + /** + * Creates a new ProgramClassReader for reading from the given DataInput. + */ + public LibraryClassReader(DataInput dataInput, + boolean skipNonPublicClasses, + boolean skipNonPublicClassMembers) + { + this.dataInput = new RuntimeDataInput(dataInput); + this.skipNonPublicClasses = skipNonPublicClasses; + this.skipNonPublicClassMembers = skipNonPublicClassMembers; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass libraryClass) + { + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Read and check the magic number. + int u4magic = dataInput.readInt(); + + ClassUtil.checkMagicNumber(u4magic); + + // Read and check the version numbers. + int u2minorVersion = dataInput.readUnsignedShort(); + int u2majorVersion = dataInput.readUnsignedShort(); + + int u4version = ClassUtil.internalClassVersion(u2majorVersion, + u2minorVersion); + + ClassUtil.checkVersionNumbers(u4version); + + // Read the constant pool. Note that the first entry is not used. + int u2constantPoolCount = dataInput.readUnsignedShort(); + + // Create the constant pool array. + constantPool = new Constant[u2constantPoolCount]; + + for (int index = 1; index < u2constantPoolCount; index++) + { + Constant constant = createConstant(); + constant.accept(libraryClass, this); + + int tag = constant.getTag(); + if (tag == ClassConstants.CONSTANT_Class || + tag == ClassConstants.CONSTANT_Utf8) + { + constantPool[index] = constant; + } + + // Long constants and double constants take up two entries in the + // constant pool. + if (tag == ClassConstants.CONSTANT_Long || + tag == ClassConstants.CONSTANT_Double) + { + index++; + } + } + + // Read the general class information. + libraryClass.u2accessFlags = dataInput.readUnsignedShort(); + + // We may stop parsing this library class if it's not public anyway. + // E.g. only about 60% of all rt.jar classes need to be parsed. + if (skipNonPublicClasses && + AccessUtil.accessLevel(libraryClass.getAccessFlags()) < AccessUtil.PUBLIC) + { + return; + } + + // Read the class and super class indices. + int u2thisClass = dataInput.readUnsignedShort(); + int u2superClass = dataInput.readUnsignedShort(); + + // Store their actual names. + libraryClass.thisClassName = getClassName(u2thisClass); + libraryClass.superClassName = (u2superClass == 0) ? null : + getClassName(u2superClass); + + // Read the interfaces + int u2interfacesCount = dataInput.readUnsignedShort(); + + libraryClass.interfaceNames = new String[u2interfacesCount]; + for (int index = 0; index < u2interfacesCount; index++) + { + // Store the actual interface name. + int u2interface = dataInput.readUnsignedShort(); + libraryClass.interfaceNames[index] = getClassName(u2interface); + } + + // Read the fields. + int u2fieldsCount = dataInput.readUnsignedShort(); + + // Create the fields array. + LibraryField[] reusableFields = new LibraryField[u2fieldsCount]; + + int visibleFieldsCount = 0; + for (int index = 0; index < u2fieldsCount; index++) + { + LibraryField field = new LibraryField(); + this.visitLibraryMember(libraryClass, field); + + // Only store fields that are visible. + if (AccessUtil.accessLevel(field.getAccessFlags()) >= + (skipNonPublicClassMembers ? AccessUtil.PROTECTED : + AccessUtil.PACKAGE_VISIBLE)) + { + reusableFields[visibleFieldsCount++] = field; + } + } + + // Copy the visible fields (if any) into a fields array of the right size. + if (visibleFieldsCount == 0) + { + libraryClass.fields = EMPTY_LIBRARY_FIELDS; + } + else + { + libraryClass.fields = new LibraryField[visibleFieldsCount]; + System.arraycopy(reusableFields, 0, libraryClass.fields, 0, visibleFieldsCount); + } + + // Read the methods. + int u2methodsCount = dataInput.readUnsignedShort(); + + // Create the methods array. + LibraryMethod[] reusableMethods = new LibraryMethod[u2methodsCount]; + + int visibleMethodsCount = 0; + for (int index = 0; index < u2methodsCount; index++) + { + LibraryMethod method = new LibraryMethod(); + this.visitLibraryMember(libraryClass, method); + + // Only store methods that are visible. + if (AccessUtil.accessLevel(method.getAccessFlags()) >= + (skipNonPublicClassMembers ? AccessUtil.PROTECTED : + AccessUtil.PACKAGE_VISIBLE)) + { + reusableMethods[visibleMethodsCount++] = method; + } + } + + // Copy the visible methods (if any) into a methods array of the right size. + if (visibleMethodsCount == 0) + { + libraryClass.methods = EMPTY_LIBRARY_METHODS; + } + else + { + libraryClass.methods = new LibraryMethod[visibleMethodsCount]; + System.arraycopy(reusableMethods, 0, libraryClass.methods, 0, visibleMethodsCount); + } + + // Skip the class attributes. + skipAttributes(); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass libraryClass, ProgramMember libraryMember) + { + } + + + public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) + { + // Read the general field information. + libraryMember.u2accessFlags = dataInput.readUnsignedShort(); + libraryMember.name = getString(dataInput.readUnsignedShort()); + libraryMember.descriptor = getString(dataInput.readUnsignedShort()); + + // Skip the field attributes. + skipAttributes(); + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + dataInput.skipBytes(4); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + dataInput.skipBytes(8); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + dataInput.skipBytes(4); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + dataInput.skipBytes(8); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + dataInput.skipBytes(2); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + int u2length = dataInput.readUnsignedShort(); + + // Read the UTF-8 bytes. + byte[] bytes = new byte[u2length]; + dataInput.readFully(bytes); + utf8Constant.setBytes(bytes); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + dataInput.skipBytes(4); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.u2nameIndex = dataInput.readUnsignedShort(); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + dataInput.skipBytes(4); + } + + + // Small utility methods. + + /** + * Returns the class name of the ClassConstant at the specified index in the + * reusable constant pool. + */ + private String getClassName(int constantIndex) + { + ClassConstant classEntry = (ClassConstant)constantPool[constantIndex]; + + return getString(classEntry.u2nameIndex); + } + + + /** + * Returns the string of the Utf8Constant at the specified index in the + * reusable constant pool. + */ + private String getString(int constantIndex) + { + return ((Utf8Constant)constantPool[constantIndex]).getString(); + } + + + private Constant createConstant() + { + int u1tag = dataInput.readUnsignedByte(); + + switch (u1tag) + { + case ClassConstants.CONSTANT_Utf8: return new Utf8Constant(); + case ClassConstants.CONSTANT_Integer: return new IntegerConstant(); + case ClassConstants.CONSTANT_Float: return new FloatConstant(); + case ClassConstants.CONSTANT_Long: return new LongConstant(); + case ClassConstants.CONSTANT_Double: return new DoubleConstant(); + case ClassConstants.CONSTANT_String: return new StringConstant(); + case ClassConstants.CONSTANT_Fieldref: return new FieldrefConstant(); + case ClassConstants.CONSTANT_Methodref: return new MethodrefConstant(); + case ClassConstants.CONSTANT_InterfaceMethodref: return new InterfaceMethodrefConstant(); + case ClassConstants.CONSTANT_Class: return new ClassConstant(); + case ClassConstants.CONSTANT_NameAndType: return new NameAndTypeConstant(); + + default: throw new RuntimeException("Unknown constant type ["+u1tag+"] in constant pool"); + } + } + + + private void skipAttributes() + { + int u2attributesCount = dataInput.readUnsignedShort(); + + for (int index = 0; index < u2attributesCount; index++) + { + skipAttribute(); + } + } + + + private void skipAttribute() + { + dataInput.skipBytes(2); + int u4attributeLength = dataInput.readInt(); + dataInput.skipBytes(u4attributeLength); + } +} diff --git a/src/proguard/classfile/io/ProgramClassReader.java b/src/proguard/classfile/io/ProgramClassReader.java new file mode 100644 index 0000000..476a346 --- /dev/null +++ b/src/proguard/classfile/io/ProgramClassReader.java @@ -0,0 +1,862 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.io; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +import java.io.DataInput; + +/** + * This ClassVisitor fills out the ProgramClass objects that it visits with data + * from the given DataInput object. + * + * @author Eric Lafortune + */ +public class ProgramClassReader +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + ExceptionInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LineNumberInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private final RuntimeDataInput dataInput; + + + /** + * Creates a new ProgramClassReader for reading from the given DataInput. + */ + public ProgramClassReader(DataInput dataInput) + { + this.dataInput = new RuntimeDataInput(dataInput); + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Read and check the magic number. + programClass.u4magic = dataInput.readInt(); + + ClassUtil.checkMagicNumber(programClass.u4magic); + + // Read and check the version numbers. + int u2minorVersion = dataInput.readUnsignedShort(); + int u2majorVersion = dataInput.readUnsignedShort(); + + programClass.u4version = ClassUtil.internalClassVersion(u2majorVersion, + u2minorVersion); + + ClassUtil.checkVersionNumbers(programClass.u4version); + + // Read the constant pool. Note that the first entry is not used. + programClass.u2constantPoolCount = dataInput.readUnsignedShort(); + + programClass.constantPool = new Constant[programClass.u2constantPoolCount]; + for (int index = 1; index < programClass.u2constantPoolCount; index++) + { + Constant constant = createConstant(); + constant.accept(programClass, this); + programClass.constantPool[index] = constant; + + // Long constants and double constants take up two entries in the + // constant pool. + int tag = constant.getTag(); + if (tag == ClassConstants.CONSTANT_Long || + tag == ClassConstants.CONSTANT_Double) + { + programClass.constantPool[++index] = null; + } + } + + // Read the general class information. + programClass.u2accessFlags = dataInput.readUnsignedShort(); + programClass.u2thisClass = dataInput.readUnsignedShort(); + programClass.u2superClass = dataInput.readUnsignedShort(); + + // Read the interfaces. + programClass.u2interfacesCount = dataInput.readUnsignedShort(); + + programClass.u2interfaces = new int[programClass.u2interfacesCount]; + for (int index = 0; index < programClass.u2interfacesCount; index++) + { + programClass.u2interfaces[index] = dataInput.readUnsignedShort(); + } + + // Read the fields. + programClass.u2fieldsCount = dataInput.readUnsignedShort(); + + programClass.fields = new ProgramField[programClass.u2fieldsCount]; + for (int index = 0; index < programClass.u2fieldsCount; index++) + { + ProgramField programField = new ProgramField(); + this.visitProgramField(programClass, programField); + programClass.fields[index] = programField; + } + + // Read the methods. + programClass.u2methodsCount = dataInput.readUnsignedShort(); + + programClass.methods = new ProgramMethod[programClass.u2methodsCount]; + for (int index = 0; index < programClass.u2methodsCount; index++) + { + ProgramMethod programMethod = new ProgramMethod(); + this.visitProgramMethod(programClass, programMethod); + programClass.methods[index] = programMethod; + } + + // Read the class attributes. + programClass.u2attributesCount = dataInput.readUnsignedShort(); + + programClass.attributes = new Attribute[programClass.u2attributesCount]; + for (int index = 0; index < programClass.u2attributesCount; index++) + { + Attribute attribute = createAttribute(programClass); + attribute.accept(programClass, this); + programClass.attributes[index] = attribute; + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Read the general field information. + programField.u2accessFlags = dataInput.readUnsignedShort(); + programField.u2nameIndex = dataInput.readUnsignedShort(); + programField.u2descriptorIndex = dataInput.readUnsignedShort(); + + // Read the field attributes. + programField.u2attributesCount = dataInput.readUnsignedShort(); + + programField.attributes = new Attribute[programField.u2attributesCount]; + for (int index = 0; index < programField.u2attributesCount; index++) + { + Attribute attribute = createAttribute(programClass); + attribute.accept(programClass, programField, this); + programField.attributes[index] = attribute; + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Read the general method information. + programMethod.u2accessFlags = dataInput.readUnsignedShort(); + programMethod.u2nameIndex = dataInput.readUnsignedShort(); + programMethod.u2descriptorIndex = dataInput.readUnsignedShort(); + + // Read the method attributes. + programMethod.u2attributesCount = dataInput.readUnsignedShort(); + + programMethod.attributes = new Attribute[programMethod.u2attributesCount]; + for (int index = 0; index < programMethod.u2attributesCount; index++) + { + Attribute attribute = createAttribute(programClass); + attribute.accept(programClass, programMethod, this); + programMethod.attributes[index] = attribute; + } + } + + + public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) + { + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + integerConstant.u4value = dataInput.readInt(); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + longConstant.u8value = dataInput.readLong(); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + floatConstant.f4value = dataInput.readFloat(); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + doubleConstant.f8value = dataInput.readDouble(); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + stringConstant.u2stringIndex = dataInput.readUnsignedShort(); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + int u2length = dataInput.readUnsignedShort(); + + // Read the UTF-8 bytes. + byte[] bytes = new byte[u2length]; + dataInput.readFully(bytes); + utf8Constant.setBytes(bytes); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + refConstant.u2classIndex = dataInput.readUnsignedShort(); + refConstant.u2nameAndTypeIndex = dataInput.readUnsignedShort(); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.u2nameIndex = dataInput.readUnsignedShort(); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + nameAndTypeConstant.u2nameIndex = dataInput.readUnsignedShort(); + nameAndTypeConstant.u2descriptorIndex = dataInput.readUnsignedShort(); + } + + + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + // Read the unknown information. + byte[] info = new byte[unknownAttribute.u4attributeLength]; + dataInput.readFully(info); + unknownAttribute.info = info; + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + sourceFileAttribute.u2sourceFileIndex = dataInput.readUnsignedShort(); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + sourceDirAttribute.u2sourceDirIndex = dataInput.readUnsignedShort(); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Read the inner classes. + innerClassesAttribute.u2classesCount = dataInput.readUnsignedShort(); + + innerClassesAttribute.classes = new InnerClassesInfo[innerClassesAttribute.u2classesCount]; + for (int index = 0; index < innerClassesAttribute.u2classesCount; index++) + { + InnerClassesInfo innerClassesInfo = new InnerClassesInfo(); + this.visitInnerClassesInfo(clazz, innerClassesInfo); + innerClassesAttribute.classes[index] = innerClassesInfo; + } + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + enclosingMethodAttribute.u2classIndex = dataInput.readUnsignedShort(); + enclosingMethodAttribute.u2nameAndTypeIndex = dataInput.readUnsignedShort(); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + // This attribute does not contain any additional information. + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + // This attribute does not contain any additional information. + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + signatureAttribute.u2signatureIndex = dataInput.readUnsignedShort(); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + constantValueAttribute.u2constantValueIndex = dataInput.readUnsignedShort(); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + // Read the exceptions. + exceptionsAttribute.u2exceptionIndexTableLength = dataInput.readUnsignedShort(); + + exceptionsAttribute.u2exceptionIndexTable = new int[exceptionsAttribute.u2exceptionIndexTableLength]; + for (int index = 0; index < exceptionsAttribute.u2exceptionIndexTableLength; index++) + { + exceptionsAttribute.u2exceptionIndexTable[index] = dataInput.readUnsignedShort(); + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Read the stack size and local variable frame size. + codeAttribute.u2maxStack = dataInput.readUnsignedShort(); + codeAttribute.u2maxLocals = dataInput.readUnsignedShort(); + + // Read the byte code. + codeAttribute.u4codeLength = dataInput.readInt(); + + byte[] code = new byte[codeAttribute.u4codeLength]; + dataInput.readFully(code); + codeAttribute.code = code; + + // Read the exceptions. + codeAttribute.u2exceptionTableLength = dataInput.readUnsignedShort(); + + codeAttribute.exceptionTable = new ExceptionInfo[codeAttribute.u2exceptionTableLength]; + for (int index = 0; index < codeAttribute.u2exceptionTableLength; index++) + { + ExceptionInfo exceptionInfo = new ExceptionInfo(); + this.visitExceptionInfo(clazz, method, codeAttribute, exceptionInfo); + codeAttribute.exceptionTable[index] = exceptionInfo; + } + + // Read the code attributes. + codeAttribute.u2attributesCount = dataInput.readUnsignedShort(); + + codeAttribute.attributes = new Attribute[codeAttribute.u2attributesCount]; + for (int index = 0; index < codeAttribute.u2attributesCount; index++) + { + Attribute attribute = createAttribute(clazz); + attribute.accept(clazz, method, codeAttribute, this); + codeAttribute.attributes[index] = attribute; + } + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + // Read the stack map frames (only full frames, without tag). + stackMapAttribute.u2stackMapFramesCount = dataInput.readUnsignedShort(); + + stackMapAttribute.stackMapFrames = new FullFrame[stackMapAttribute.u2stackMapFramesCount]; + for (int index = 0; index < stackMapAttribute.u2stackMapFramesCount; index++) + { + FullFrame stackMapFrame = new FullFrame(); + this.visitFullFrame(clazz, method, codeAttribute, index, stackMapFrame); + stackMapAttribute.stackMapFrames[index] = stackMapFrame; + } + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + // Read the stack map frames. + stackMapTableAttribute.u2stackMapFramesCount = dataInput.readUnsignedShort(); + + stackMapTableAttribute.stackMapFrames = new StackMapFrame[stackMapTableAttribute.u2stackMapFramesCount]; + for (int index = 0; index < stackMapTableAttribute.u2stackMapFramesCount; index++) + { + StackMapFrame stackMapFrame = createStackMapFrame(); + stackMapFrame.accept(clazz, method, codeAttribute, 0, this); + stackMapTableAttribute.stackMapFrames[index] = stackMapFrame; + } + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + // Read the line numbers. + lineNumberTableAttribute.u2lineNumberTableLength = dataInput.readUnsignedShort(); + + lineNumberTableAttribute.lineNumberTable = new LineNumberInfo[lineNumberTableAttribute.u2lineNumberTableLength]; + for (int index = 0; index < lineNumberTableAttribute.u2lineNumberTableLength; index++) + { + LineNumberInfo lineNumberInfo = new LineNumberInfo(); + this.visitLineNumberInfo(clazz, method, codeAttribute, lineNumberInfo); + lineNumberTableAttribute.lineNumberTable[index] = lineNumberInfo; + } + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Read the local variables. + localVariableTableAttribute.u2localVariableTableLength = dataInput.readUnsignedShort(); + + localVariableTableAttribute.localVariableTable = new LocalVariableInfo[localVariableTableAttribute.u2localVariableTableLength]; + for (int index = 0; index < localVariableTableAttribute.u2localVariableTableLength; index++) + { + LocalVariableInfo localVariableInfo = new LocalVariableInfo(); + this.visitLocalVariableInfo(clazz, method, codeAttribute, localVariableInfo); + localVariableTableAttribute.localVariableTable[index] = localVariableInfo; + } + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Read the local variable types. + localVariableTypeTableAttribute.u2localVariableTypeTableLength = dataInput.readUnsignedShort(); + + localVariableTypeTableAttribute.localVariableTypeTable = new LocalVariableTypeInfo[localVariableTypeTableAttribute.u2localVariableTypeTableLength]; + for (int index = 0; index < localVariableTypeTableAttribute.u2localVariableTypeTableLength; index++) + { + LocalVariableTypeInfo localVariableTypeInfo = new LocalVariableTypeInfo(); + this.visitLocalVariableTypeInfo(clazz, method, codeAttribute, localVariableTypeInfo); + localVariableTypeTableAttribute.localVariableTypeTable[index] = localVariableTypeInfo; + } + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Read the annotations. + annotationsAttribute.u2annotationsCount = dataInput.readUnsignedShort(); + + annotationsAttribute.annotations = new Annotation[annotationsAttribute.u2annotationsCount]; + for (int index = 0; index < annotationsAttribute.u2annotationsCount; index++) + { + Annotation annotation = new Annotation(); + this.visitAnnotation(clazz, annotation); + annotationsAttribute.annotations[index] = annotation; + } + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Read the parameter annotations. + parameterAnnotationsAttribute.u2parametersCount = dataInput.readUnsignedByte(); + + // The java compilers of JDK 1.5, JDK 1.6, and Eclipse all count the + // number of parameters of constructors of non-static inner classes + // incorrectly. Fix it right here. + int parameterStart = 0; + if (method.getName(clazz).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + int realParametersCount = ClassUtil.internalMethodParameterCount(method.getDescriptor(clazz)); + parameterStart = realParametersCount - parameterAnnotationsAttribute.u2parametersCount; + parameterAnnotationsAttribute.u2parametersCount = realParametersCount; + } + + parameterAnnotationsAttribute.u2parameterAnnotationsCount = new int[parameterAnnotationsAttribute.u2parametersCount]; + parameterAnnotationsAttribute.parameterAnnotations = new Annotation[parameterAnnotationsAttribute.u2parametersCount][]; + + for (int parameterIndex = parameterStart; parameterIndex < parameterAnnotationsAttribute.u2parametersCount; parameterIndex++) + { + // Read the parameter annotations of the given parameter. + int u2annotationsCount = dataInput.readUnsignedShort(); + + Annotation[] annotations = new Annotation[u2annotationsCount]; + + for (int index = 0; index < u2annotationsCount; index++) + { + Annotation annotation = new Annotation(); + this.visitAnnotation(clazz, annotation); + annotations[index] = annotation; + } + + parameterAnnotationsAttribute.u2parameterAnnotationsCount[parameterIndex] = u2annotationsCount; + parameterAnnotationsAttribute.parameterAnnotations[parameterIndex] = annotations; + } + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Read the default element value. + ElementValue elementValue = createElementValue(); + elementValue.accept(clazz, null, this); + annotationDefaultAttribute.defaultValue = elementValue; + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + innerClassesInfo.u2innerClassIndex = dataInput.readUnsignedShort(); + innerClassesInfo.u2outerClassIndex = dataInput.readUnsignedShort(); + innerClassesInfo.u2innerNameIndex = dataInput.readUnsignedShort(); + innerClassesInfo.u2innerClassAccessFlags = dataInput.readUnsignedShort(); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + exceptionInfo.u2startPC = dataInput.readUnsignedShort(); + exceptionInfo.u2endPC = dataInput.readUnsignedShort(); + exceptionInfo.u2handlerPC = dataInput.readUnsignedShort(); + exceptionInfo.u2catchType = dataInput.readUnsignedShort(); + } + + + // Implementations for StackMapFrameVisitor. + + public void visitSameZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameZeroFrame sameZeroFrame) + { + if (sameZeroFrame.getTag() == StackMapFrame.SAME_ZERO_FRAME_EXTENDED) + { + sameZeroFrame.u2offsetDelta = dataInput.readUnsignedShort(); + } + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + if (sameOneFrame.getTag() == StackMapFrame.SAME_ONE_FRAME_EXTENDED) + { + sameOneFrame.u2offsetDelta = dataInput.readUnsignedShort(); + } + + // Read the verification type of the stack entry. + VerificationType verificationType = createVerificationType(); + verificationType.accept(clazz, method, codeAttribute, offset, this); + sameOneFrame.stackItem = verificationType; + } + + + public void visitLessZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LessZeroFrame lessZeroFrame) + { + lessZeroFrame.u2offsetDelta = dataInput.readUnsignedShort(); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + moreZeroFrame.u2offsetDelta = dataInput.readUnsignedShort(); + + // Read the verification types of the additional local variables. + moreZeroFrame.additionalVariables = new VerificationType[moreZeroFrame.additionalVariablesCount]; + for (int index = 0; index < moreZeroFrame.additionalVariablesCount; index++) + { + VerificationType verificationType = createVerificationType(); + verificationType.accept(clazz, method, codeAttribute, offset, this); + moreZeroFrame.additionalVariables[index] = verificationType; + } + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + fullFrame.u2offsetDelta = dataInput.readUnsignedShort(); + + // Read the verification types of the local variables. + fullFrame.variablesCount = dataInput.readUnsignedShort(); + fullFrame.variables = new VerificationType[fullFrame.variablesCount]; + for (int index = 0; index < fullFrame.variablesCount; index++) + { + VerificationType verificationType = createVerificationType(); + verificationType.variablesAccept(clazz, method, codeAttribute, offset, index, this); + fullFrame.variables[index] = verificationType; + } + + // Read the verification types of the stack entries. + fullFrame.stackCount = dataInput.readUnsignedShort(); + fullFrame.stack = new VerificationType[fullFrame.stackCount]; + for (int index = 0; index < fullFrame.stackCount; index++) + { + VerificationType verificationType = createVerificationType(); + verificationType.stackAccept(clazz, method, codeAttribute, offset, index, this); + fullFrame.stack[index] = verificationType; + } + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) + { + // Most verification types don't contain any additional information. + } + + + public void visitObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType) + { + objectType.u2classIndex = dataInput.readUnsignedShort(); + } + + + public void visitUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType) + { + uninitializedType.u2newInstructionOffset = dataInput.readUnsignedShort(); + } + + + // Implementations for LineNumberInfoVisitor. + + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo) + { + lineNumberInfo.u2startPC = dataInput.readUnsignedShort(); + lineNumberInfo.u2lineNumber = dataInput.readUnsignedShort(); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + localVariableInfo.u2startPC = dataInput.readUnsignedShort(); + localVariableInfo.u2length = dataInput.readUnsignedShort(); + localVariableInfo.u2nameIndex = dataInput.readUnsignedShort(); + localVariableInfo.u2descriptorIndex = dataInput.readUnsignedShort(); + localVariableInfo.u2index = dataInput.readUnsignedShort(); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + localVariableTypeInfo.u2startPC = dataInput.readUnsignedShort(); + localVariableTypeInfo.u2length = dataInput.readUnsignedShort(); + localVariableTypeInfo.u2nameIndex = dataInput.readUnsignedShort(); + localVariableTypeInfo.u2signatureIndex = dataInput.readUnsignedShort(); + localVariableTypeInfo.u2index = dataInput.readUnsignedShort(); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Read the annotation type. + annotation.u2typeIndex = dataInput.readUnsignedShort(); + + // Read the element value pairs. + annotation.u2elementValuesCount = dataInput.readUnsignedShort(); + + annotation.elementValues = new ElementValue[annotation.u2elementValuesCount]; + for (int index = 0; index < annotation.u2elementValuesCount; index++) + { + int u2elementNameIndex = dataInput.readUnsignedShort(); + ElementValue elementValue = createElementValue(); + elementValue.u2elementNameIndex = u2elementNameIndex; + elementValue.accept(clazz, annotation, this); + annotation.elementValues[index] = elementValue; + } + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + constantElementValue.u2constantValueIndex = dataInput.readUnsignedShort(); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + enumConstantElementValue.u2typeNameIndex = dataInput.readUnsignedShort(); + enumConstantElementValue.u2constantNameIndex = dataInput.readUnsignedShort(); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + classElementValue.u2classInfoIndex = dataInput.readUnsignedShort(); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + // Read the annotation. + Annotation annotationValue = new Annotation(); + this.visitAnnotation(clazz, annotationValue); + annotationElementValue.annotationValue = annotationValue; + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Read the element values. + arrayElementValue.u2elementValuesCount = dataInput.readUnsignedShort(); + + arrayElementValue.elementValues = new ElementValue[arrayElementValue.u2elementValuesCount]; + for (int index = 0; index < arrayElementValue.u2elementValuesCount; index++) + { + ElementValue elementValue = createElementValue(); + elementValue.accept(clazz, annotation, this); + arrayElementValue.elementValues[index] = elementValue; + } + } + + + // Small utility methods. + + private Constant createConstant() + { + int u1tag = dataInput.readUnsignedByte(); + + switch (u1tag) + { + case ClassConstants.CONSTANT_Utf8: return new Utf8Constant(); + case ClassConstants.CONSTANT_Integer: return new IntegerConstant(); + case ClassConstants.CONSTANT_Float: return new FloatConstant(); + case ClassConstants.CONSTANT_Long: return new LongConstant(); + case ClassConstants.CONSTANT_Double: return new DoubleConstant(); + case ClassConstants.CONSTANT_String: return new StringConstant(); + case ClassConstants.CONSTANT_Fieldref: return new FieldrefConstant(); + case ClassConstants.CONSTANT_Methodref: return new MethodrefConstant(); + case ClassConstants.CONSTANT_InterfaceMethodref: return new InterfaceMethodrefConstant(); + case ClassConstants.CONSTANT_Class: return new ClassConstant(); + case ClassConstants.CONSTANT_NameAndType: return new NameAndTypeConstant(); + + default: throw new RuntimeException("Unknown constant type ["+u1tag+"] in constant pool"); + } + } + + + private Attribute createAttribute(Clazz clazz) + { + int u2attributeNameIndex = dataInput.readUnsignedShort(); + int u4attributeLength = dataInput.readInt(); + String attributeName = clazz.getString(u2attributeNameIndex); + Attribute attribute = + attributeName.equals(ClassConstants.ATTR_SourceFile) ? (Attribute)new SourceFileAttribute(): + attributeName.equals(ClassConstants.ATTR_SourceDir) ? (Attribute)new SourceDirAttribute(): + attributeName.equals(ClassConstants.ATTR_InnerClasses) ? (Attribute)new InnerClassesAttribute(): + attributeName.equals(ClassConstants.ATTR_EnclosingMethod) ? (Attribute)new EnclosingMethodAttribute(): + attributeName.equals(ClassConstants.ATTR_Deprecated) ? (Attribute)new DeprecatedAttribute(): + attributeName.equals(ClassConstants.ATTR_Synthetic) ? (Attribute)new SyntheticAttribute(): + attributeName.equals(ClassConstants.ATTR_Signature) ? (Attribute)new SignatureAttribute(): + attributeName.equals(ClassConstants.ATTR_ConstantValue) ? (Attribute)new ConstantValueAttribute(): + attributeName.equals(ClassConstants.ATTR_Exceptions) ? (Attribute)new ExceptionsAttribute(): + attributeName.equals(ClassConstants.ATTR_Code) ? (Attribute)new CodeAttribute(): + attributeName.equals(ClassConstants.ATTR_StackMap) ? (Attribute)new StackMapAttribute(): + attributeName.equals(ClassConstants.ATTR_StackMapTable) ? (Attribute)new StackMapTableAttribute(): + attributeName.equals(ClassConstants.ATTR_LineNumberTable) ? (Attribute)new LineNumberTableAttribute(): + attributeName.equals(ClassConstants.ATTR_LocalVariableTable) ? (Attribute)new LocalVariableTableAttribute(): + attributeName.equals(ClassConstants.ATTR_LocalVariableTypeTable) ? (Attribute)new LocalVariableTypeTableAttribute(): + attributeName.equals(ClassConstants.ATTR_RuntimeVisibleAnnotations) ? (Attribute)new RuntimeVisibleAnnotationsAttribute(): + attributeName.equals(ClassConstants.ATTR_RuntimeInvisibleAnnotations) ? (Attribute)new RuntimeInvisibleAnnotationsAttribute(): + attributeName.equals(ClassConstants.ATTR_RuntimeVisibleParameterAnnotations) ? (Attribute)new RuntimeVisibleParameterAnnotationsAttribute(): + attributeName.equals(ClassConstants.ATTR_RuntimeInvisibleParameterAnnotations) ? (Attribute)new RuntimeInvisibleParameterAnnotationsAttribute(): + attributeName.equals(ClassConstants.ATTR_AnnotationDefault) ? (Attribute)new AnnotationDefaultAttribute(): + (Attribute)new UnknownAttribute(u4attributeLength); + attribute.u2attributeNameIndex = u2attributeNameIndex; + + return attribute; + } + + + private StackMapFrame createStackMapFrame() + { + int u1tag = dataInput.readUnsignedByte(); + + return + u1tag < StackMapFrame.SAME_ONE_FRAME ? (StackMapFrame)new SameZeroFrame(u1tag) : + u1tag < StackMapFrame.SAME_ONE_FRAME_EXTENDED ? (StackMapFrame)new SameOneFrame(u1tag) : + u1tag < StackMapFrame.LESS_ZERO_FRAME ? (StackMapFrame)new SameOneFrame(u1tag) : + u1tag < StackMapFrame.SAME_ZERO_FRAME_EXTENDED ? (StackMapFrame)new LessZeroFrame(u1tag) : + u1tag < StackMapFrame.MORE_ZERO_FRAME ? (StackMapFrame)new SameZeroFrame(u1tag) : + u1tag < StackMapFrame.FULL_FRAME ? (StackMapFrame)new MoreZeroFrame(u1tag) : + (StackMapFrame)new FullFrame(); + } + + + private VerificationType createVerificationType() + { + int u1tag = dataInput.readUnsignedByte(); + + switch (u1tag) + { + case VerificationType.INTEGER_TYPE: return new IntegerType(); + case VerificationType.FLOAT_TYPE: return new FloatType(); + case VerificationType.LONG_TYPE: return new LongType(); + case VerificationType.DOUBLE_TYPE: return new DoubleType(); + case VerificationType.TOP_TYPE: return new TopType(); + case VerificationType.OBJECT_TYPE: return new ObjectType(); + case VerificationType.NULL_TYPE: return new NullType(); + case VerificationType.UNINITIALIZED_TYPE: return new UninitializedType(); + case VerificationType.UNINITIALIZED_THIS_TYPE: return new UninitializedThisType(); + + default: throw new RuntimeException("Unknown verification type ["+u1tag+"] in stack map frame"); + } + } + + + private ElementValue createElementValue() + { + int u1tag = dataInput.readUnsignedByte(); + + switch (u1tag) + { + case ClassConstants.INTERNAL_TYPE_BOOLEAN: + case ClassConstants.INTERNAL_TYPE_BYTE: + case ClassConstants.INTERNAL_TYPE_CHAR: + case ClassConstants.INTERNAL_TYPE_SHORT: + case ClassConstants.INTERNAL_TYPE_INT: + case ClassConstants.INTERNAL_TYPE_FLOAT: + case ClassConstants.INTERNAL_TYPE_LONG: + case ClassConstants.INTERNAL_TYPE_DOUBLE: + case ClassConstants.ELEMENT_VALUE_STRING_CONSTANT: return new ConstantElementValue(u1tag); + + case ClassConstants.ELEMENT_VALUE_ENUM_CONSTANT: return new EnumConstantElementValue(); + case ClassConstants.ELEMENT_VALUE_CLASS: return new ClassElementValue(); + case ClassConstants.ELEMENT_VALUE_ANNOTATION: return new AnnotationElementValue(); + case ClassConstants.ELEMENT_VALUE_ARRAY: return new ArrayElementValue(); + + default: throw new IllegalArgumentException("Unknown element value tag ["+u1tag+"]"); + } + } +} diff --git a/src/proguard/classfile/io/ProgramClassWriter.java b/src/proguard/classfile/io/ProgramClassWriter.java new file mode 100644 index 0000000..e56f08a --- /dev/null +++ b/src/proguard/classfile/io/ProgramClassWriter.java @@ -0,0 +1,690 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.io; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +import java.io.*; + +/** + * This ClassVisitor writes out the ProgramClass objects that it visits to the + * given DataOutput object. + * + * @author Eric Lafortune + */ +public class ProgramClassWriter +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor, + AttributeVisitor +{ + private RuntimeDataOutput dataOutput; + + private final ConstantBodyWriter constantBodyWriter = new ConstantBodyWriter(); + private final AttributeBodyWriter attributeBodyWriter = new AttributeBodyWriter(); + private final StackMapFrameBodyWriter stackMapFrameBodyWriter = new StackMapFrameBodyWriter(); + private final VerificationTypeBodyWriter verificationTypeBodyWriter = new VerificationTypeBodyWriter(); + private final ElementValueBodyWriter elementValueBodyWriter = new ElementValueBodyWriter(); + + + /** + * Creates a new ProgramClassWriter for reading from the given DataOutput. + */ + public ProgramClassWriter(DataOutput dataOutput) + { + this.dataOutput = new RuntimeDataOutput(dataOutput); + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Write the magic number. + dataOutput.writeInt(programClass.u4magic); + + // Write the version numbers. + dataOutput.writeShort(ClassUtil.internalMinorClassVersion(programClass.u4version)); + dataOutput.writeShort(ClassUtil.internalMajorClassVersion(programClass.u4version)); + + // Write the constant pool. + dataOutput.writeShort(programClass.u2constantPoolCount); + + programClass.constantPoolEntriesAccept(this); + + // Write the general class information. + dataOutput.writeShort(programClass.u2accessFlags); + dataOutput.writeShort(programClass.u2thisClass); + dataOutput.writeShort(programClass.u2superClass); + + // Write the interfaces. + dataOutput.writeShort(programClass.u2interfacesCount); + + for (int index = 0; index < programClass.u2interfacesCount; index++) + { + dataOutput.writeShort(programClass.u2interfaces[index]); + } + + // Write the fields. + dataOutput.writeShort(programClass.u2fieldsCount); + + programClass.fieldsAccept(this); + + // Write the methods. + dataOutput.writeShort(programClass.u2methodsCount); + + programClass.methodsAccept(this); + + // Write the class attributes. + dataOutput.writeShort(programClass.u2attributesCount); + + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Write the general field information. + dataOutput.writeShort(programField.u2accessFlags); + dataOutput.writeShort(programField.u2nameIndex); + dataOutput.writeShort(programField.u2descriptorIndex); + + // Write the field attributes. + dataOutput.writeShort(programField.u2attributesCount); + + programField.attributesAccept(programClass, this); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Write the general method information. + dataOutput.writeShort(programMethod.u2accessFlags); + dataOutput.writeShort(programMethod.u2nameIndex); + dataOutput.writeShort(programMethod.u2descriptorIndex); + + // Write the method attributes. + dataOutput.writeShort(programMethod.u2attributesCount); + + programMethod.attributesAccept(programClass, this); + } + + + public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) + { + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) + { + // Write the tag. + dataOutput.writeByte(constant.getTag()); + + // Write the actual body. + constant.accept(clazz, constantBodyWriter); + } + + + private class ConstantBodyWriter + extends SimplifiedVisitor + implements ConstantVisitor + { + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + dataOutput.writeInt(integerConstant.u4value); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + dataOutput.writeLong(longConstant.u8value); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + dataOutput.writeFloat(floatConstant.f4value); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + dataOutput.writeDouble(doubleConstant.f8value); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + dataOutput.writeShort(stringConstant.u2stringIndex); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + byte[] bytes = utf8Constant.getBytes(); + + dataOutput.writeShort(bytes.length); + dataOutput.write(bytes); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + dataOutput.writeShort(refConstant.u2classIndex); + dataOutput.writeShort(refConstant.u2nameAndTypeIndex); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + dataOutput.writeShort(classConstant.u2nameIndex); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + dataOutput.writeShort(nameAndTypeConstant.u2nameIndex); + dataOutput.writeShort(nameAndTypeConstant.u2descriptorIndex); + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) + { + // Write the attribute name index. + dataOutput.writeShort(attribute.u2attributeNameIndex); + + // We'll write the attribute body into an array first, so we can + // automatically figure out its length. + ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream(); + + // Temporarily replace the current data output. + RuntimeDataOutput oldDataOutput = dataOutput; + dataOutput = new RuntimeDataOutput(new DataOutputStream(byteArrayOutputStream)); + + // Write the attribute body into the array. Note that the + // accept method with two dummy null arguments never throws + // an UnsupportedOperationException. + attribute.accept(clazz, null, null, attributeBodyWriter); + + // Restore the original data output. + dataOutput = oldDataOutput; + + // Write the attribute length and body. + byte[] info = byteArrayOutputStream.toByteArray(); + + dataOutput.writeInt(info.length); + dataOutput.write(info); + } + + + private class AttributeBodyWriter + extends SimplifiedVisitor + implements AttributeVisitor, + InnerClassesInfoVisitor, + ExceptionInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LineNumberInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor + { + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + // Write the unknown information. + dataOutput.write(unknownAttribute.info); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + dataOutput.writeShort(sourceFileAttribute.u2sourceFileIndex); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + dataOutput.writeShort(sourceDirAttribute.u2sourceDirIndex); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Write the inner classes. + dataOutput.writeShort(innerClassesAttribute.u2classesCount); + + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + dataOutput.writeShort(enclosingMethodAttribute.u2classIndex); + dataOutput.writeShort(enclosingMethodAttribute.u2nameAndTypeIndex); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + // This attribute does not contain any additional information. + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + // This attribute does not contain any additional information. + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + dataOutput.writeShort(signatureAttribute.u2signatureIndex); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + dataOutput.writeShort(constantValueAttribute.u2constantValueIndex); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + // Write the exceptions. + dataOutput.writeShort(exceptionsAttribute.u2exceptionIndexTableLength); + + for (int index = 0; index < exceptionsAttribute.u2exceptionIndexTableLength; index++) + { + dataOutput.writeShort(exceptionsAttribute.u2exceptionIndexTable[index]); + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Write the stack size and local variable frame size. + dataOutput.writeShort(codeAttribute.u2maxStack); + dataOutput.writeShort(codeAttribute.u2maxLocals); + + // Write the byte code. + dataOutput.writeInt(codeAttribute.u4codeLength); + + dataOutput.write(codeAttribute.code, 0, codeAttribute.u4codeLength); + + // Write the exceptions. + dataOutput.writeShort(codeAttribute.u2exceptionTableLength); + + codeAttribute.exceptionsAccept(clazz, method, this); + + // Write the code attributes. + dataOutput.writeShort(codeAttribute.u2attributesCount); + + codeAttribute.attributesAccept(clazz, method, ProgramClassWriter.this); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + // Write the stack map frames (only full frames, without tag). + dataOutput.writeShort(stackMapAttribute.u2stackMapFramesCount); + + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, stackMapFrameBodyWriter); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + // Write the stack map frames. + dataOutput.writeShort(stackMapTableAttribute.u2stackMapFramesCount); + + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + // Write the line numbers. + dataOutput.writeShort(lineNumberTableAttribute.u2lineNumberTableLength); + + lineNumberTableAttribute.lineNumbersAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Write the local variables. + dataOutput.writeShort(localVariableTableAttribute.u2localVariableTableLength); + + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Write the local variable types. + dataOutput.writeShort(localVariableTypeTableAttribute.u2localVariableTypeTableLength); + + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Write the annotations. + dataOutput.writeShort(annotationsAttribute.u2annotationsCount); + + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Write the parameter annotations. + dataOutput.writeByte(parameterAnnotationsAttribute.u2parametersCount); + + for (int parameterIndex = 0; parameterIndex < parameterAnnotationsAttribute.u2parametersCount; parameterIndex++) + { + // Write the parameter annotations of the given parameter. + int u2annotationsCount = parameterAnnotationsAttribute.u2parameterAnnotationsCount[parameterIndex]; + Annotation[] annotations = parameterAnnotationsAttribute.parameterAnnotations[parameterIndex]; + + dataOutput.writeShort(u2annotationsCount); + + for (int index = 0; index < u2annotationsCount; index++) + { + Annotation annotation = annotations[index]; + this.visitAnnotation(clazz, annotation); + } + + } + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Write the default element value. + annotationDefaultAttribute.defaultValue.accept(clazz, null, this); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + dataOutput.writeShort(innerClassesInfo.u2innerClassIndex); + dataOutput.writeShort(innerClassesInfo.u2outerClassIndex); + dataOutput.writeShort(innerClassesInfo.u2innerNameIndex); + dataOutput.writeShort(innerClassesInfo.u2innerClassAccessFlags); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + dataOutput.writeShort(exceptionInfo.u2startPC); + dataOutput.writeShort(exceptionInfo.u2endPC); + dataOutput.writeShort(exceptionInfo.u2handlerPC); + dataOutput.writeShort(exceptionInfo.u2catchType); + } + + + // Implementations for StackMapFrameVisitor. + + public void visitAnyStackMapFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrame stackMapFrame) + { + // Write the stack map frame tag. + dataOutput.writeByte(stackMapFrame.getTag()); + + // Write the actual body. + stackMapFrame.accept(clazz, method, codeAttribute, offset, stackMapFrameBodyWriter); + } + + + // Implementations for LineNumberInfoVisitor. + + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo) + { + dataOutput.writeShort(lineNumberInfo.u2startPC); + dataOutput.writeShort(lineNumberInfo.u2lineNumber); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + dataOutput.writeShort(localVariableInfo.u2startPC); + dataOutput.writeShort(localVariableInfo.u2length); + dataOutput.writeShort(localVariableInfo.u2nameIndex); + dataOutput.writeShort(localVariableInfo.u2descriptorIndex); + dataOutput.writeShort(localVariableInfo.u2index); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + dataOutput.writeShort(localVariableTypeInfo.u2startPC); + dataOutput.writeShort(localVariableTypeInfo.u2length); + dataOutput.writeShort(localVariableTypeInfo.u2nameIndex); + dataOutput.writeShort(localVariableTypeInfo.u2signatureIndex); + dataOutput.writeShort(localVariableTypeInfo.u2index); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Write the annotation type. + dataOutput.writeShort(annotation.u2typeIndex); + + // Write the element value pairs. + dataOutput.writeShort(annotation.u2elementValuesCount); + + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) + { + // Write the element name index, if applicable. + int u2elementNameIndex = elementValue.u2elementNameIndex; + if (u2elementNameIndex != 0) + { + dataOutput.writeShort(u2elementNameIndex); + } + + // Write the tag. + dataOutput.writeByte(elementValue.getTag()); + + // Write the actual body. + elementValue.accept(clazz, annotation, elementValueBodyWriter); + } + } + + + private class StackMapFrameBodyWriter + extends SimplifiedVisitor + implements StackMapFrameVisitor, + VerificationTypeVisitor + { + public void visitSameZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameZeroFrame sameZeroFrame) + { + if (sameZeroFrame.getTag() == StackMapFrame.SAME_ZERO_FRAME_EXTENDED) + { + dataOutput.writeShort(sameZeroFrame.u2offsetDelta); + } + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + if (sameOneFrame.getTag() == StackMapFrame.SAME_ONE_FRAME_EXTENDED) + { + dataOutput.writeShort(sameOneFrame.u2offsetDelta); + } + + // Write the verification type of the stack entry. + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitLessZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LessZeroFrame lessZeroFrame) + { + dataOutput.writeShort(lessZeroFrame.u2offsetDelta); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + dataOutput.writeShort(moreZeroFrame.u2offsetDelta); + + // Write the verification types of the additional local variables. + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + dataOutput.writeShort(fullFrame.u2offsetDelta); + + // Write the verification types of the local variables. + dataOutput.writeShort(fullFrame.variablesCount); + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + + // Write the verification types of the stack entries. + dataOutput.writeShort(fullFrame.stackCount); + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) + { + // Write the verification type tag. + dataOutput.writeByte(verificationType.getTag()); + + // Write the actual body. + verificationType.accept(clazz, method, codeAttribute, offset, verificationTypeBodyWriter); + } + } + + + private class VerificationTypeBodyWriter + extends SimplifiedVisitor + implements VerificationTypeVisitor + { + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) + { + // Most verification types don't contain any additional information. + } + + + public void visitObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType) + { + dataOutput.writeShort(objectType.u2classIndex); + } + + + public void visitUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType) + { + dataOutput.writeShort(uninitializedType.u2newInstructionOffset); + } + } + + + private class ElementValueBodyWriter + extends SimplifiedVisitor + implements ElementValueVisitor + { + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + dataOutput.writeShort(constantElementValue.u2constantValueIndex); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + dataOutput.writeShort(enumConstantElementValue.u2typeNameIndex); + dataOutput.writeShort(enumConstantElementValue.u2constantNameIndex); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + dataOutput.writeShort(classElementValue.u2classInfoIndex); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + // Write the annotation. + attributeBodyWriter.visitAnnotation(clazz, annotationElementValue.annotationValue); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Write the element values. + dataOutput.writeShort(arrayElementValue.u2elementValuesCount); + + arrayElementValue.elementValuesAccept(clazz, annotation, attributeBodyWriter); + } + } +} diff --git a/src/proguard/classfile/io/RuntimeDataInput.java b/src/proguard/classfile/io/RuntimeDataInput.java new file mode 100644 index 0000000..104b7c9 --- /dev/null +++ b/src/proguard/classfile/io/RuntimeDataInput.java @@ -0,0 +1,223 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.io; + +import java.io.*; + +/** + * This class delegates its method calls to the corresponding DataInput methods, + * converting its IOExceptions to RuntimeExceptions. + * + * @author Eric Lafortune + */ +final class RuntimeDataInput +{ + private final DataInput dataInput; + + + public RuntimeDataInput(DataInput dataInput) + { + this.dataInput = dataInput; + } + + + // Methods delegating to DataInput. + + public boolean readBoolean() + { + try + { + return dataInput.readBoolean(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public byte readByte() + { + try + { + return dataInput.readByte(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public char readChar() + { + try + { + return dataInput.readChar(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public double readDouble() + { + try + { + return dataInput.readDouble(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public float readFloat() + { + try + { + return dataInput.readFloat(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public void readFully(byte[] b) + { + try + { + dataInput.readFully(b); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public void readFully(byte[] b, int off, int len) + { + try + { + dataInput.readFully(b, off, len); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public int readInt() + { + try + { + return dataInput.readInt(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public String readLine() + { + try + { + return dataInput.readLine(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public long readLong() + { + try + { + return dataInput.readLong(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public short readShort() + { + try + { + return dataInput.readShort(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public int readUnsignedByte() + { + try + { + return dataInput.readUnsignedByte(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public int readUnsignedShort() + { + try + { + return dataInput.readUnsignedShort(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public String readUTF() + { + try + { + return dataInput.readUTF(); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + public int skipBytes(int n) + { + try + { + return dataInput.skipBytes(n); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } +} diff --git a/src/proguard/classfile/io/RuntimeDataOutput.java b/src/proguard/classfile/io/RuntimeDataOutput.java new file mode 100644 index 0000000..ffde3af --- /dev/null +++ b/src/proguard/classfile/io/RuntimeDataOutput.java @@ -0,0 +1,224 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.io; + +import java.io.*; + +/** + * This class delegates its method calls to the corresponding DataOutput methods, + * converting its IOExceptions to RuntimeExceptions. + * + * @author Eric Lafortune + */ +final class RuntimeDataOutput +{ + private final DataOutput dataOutput; + + + public RuntimeDataOutput(DataOutput dataOutput) + { + this.dataOutput = dataOutput; + } + + + // Methods delegating to DataOutput. + + public void write(byte[] b) + { + try + { + dataOutput.write(b); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void write(byte[] b, int off, int len) + { + try + { + dataOutput.write(b, off, len); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void write(int b) + { + try + { + dataOutput.write(b); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeBoolean(boolean v) + { + try + { + dataOutput.writeBoolean(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeByte(int v) + { + try + { + dataOutput.writeByte(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeBytes(String s) + { + try + { + dataOutput.writeBytes(s); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeChar(int v) + { + try + { + dataOutput.writeChar(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeChars(String s) + { + try + { + dataOutput.writeChars(s); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeDouble(double v) + { + try + { + dataOutput.writeDouble(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeFloat(float v) + { + try + { + dataOutput.writeFloat(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeInt(int v) + { + try + { + dataOutput.writeInt(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeLong(long v) + { + try + { + dataOutput.writeLong(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeShort(int v) + { + try + { + dataOutput.writeShort(v); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } + + + public void writeUTF(String str) + { + try + { + dataOutput.writeUTF(str); + } + catch (IOException ex) + { + throw new RuntimeException(ex.getMessage()); + } + } +} diff --git a/src/proguard/classfile/io/package.html b/src/proguard/classfile/io/package.html new file mode 100644 index 0000000..780b917 --- /dev/null +++ b/src/proguard/classfile/io/package.html @@ -0,0 +1,3 @@ + +This package contains classes for reading and writing class files. + diff --git a/src/proguard/classfile/package.html b/src/proguard/classfile/package.html new file mode 100644 index 0000000..fad087c --- /dev/null +++ b/src/proguard/classfile/package.html @@ -0,0 +1,15 @@ + +This package contains classes to represent the various elements of class files. +

    +A class file is represented by the {@link proguard.classfile.ClassFile +ClassFile} interface. This interface currently has two alternative +representations: +

      +
    • {@link ProgramClassFile ProgramClassFile}: + a complete representation that can be read, modified, and written back. +
    • {@link LibraryClassFile LibraryClassFile}: + an incomplete representation that can be only be read. It is however + more compact than ProgramClassFile, and sufficient for + analyzing class files from library jars. +
    + diff --git a/src/proguard/classfile/util/AccessUtil.java b/src/proguard/classfile/util/AccessUtil.java new file mode 100644 index 0000000..3ad6961 --- /dev/null +++ b/src/proguard/classfile/util/AccessUtil.java @@ -0,0 +1,105 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.ClassConstants; + + +/** + * Utility methods for working with access flags. For convenience, this class + * defines access levels, in ascending order: PRIVATE, + * PACKAGE_VISIBLE, PROTECTED, and PUBLIC. + * + * @author Eric Lafortune + */ +public class AccessUtil +{ + public static final int PRIVATE = 0; + public static final int PACKAGE_VISIBLE = 1; + public static final int PROTECTED = 2; + public static final int PUBLIC = 3; + + + // The mask of access flags. + private static final int ACCESS_MASK = + ClassConstants.INTERNAL_ACC_PUBLIC | + ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_PROTECTED; + + + /** + * Returns the corresponding access level of the given access flags. + * @param accessFlags the internal access flags. + * @return the corresponding access level: PRIVATE, + * PACKAGE_VISIBLE, PROTECTED, or + * PUBLIC. + */ + public static int accessLevel(int accessFlags) + { + switch (accessFlags & ACCESS_MASK) + { + case ClassConstants.INTERNAL_ACC_PRIVATE: return PRIVATE; + default: return PACKAGE_VISIBLE; + case ClassConstants.INTERNAL_ACC_PROTECTED: return PROTECTED; + case ClassConstants.INTERNAL_ACC_PUBLIC: return PUBLIC; + } + } + + + /** + * Returns the corresponding access flags of the given access level. + * @param accessLevel the access level: PRIVATE, + * PACKAGE_VISIBLE, PROTECTED, + * or PUBLIC. + * @return the corresponding internal access flags, the internal access + * flags as a logical bit mask of INTERNAL_ACC_PRIVATE, + * INTERNAL_ACC_PROTECTED, and + * INTERNAL_ACC_PUBLIC. + */ + public static int accessFlags(int accessLevel) + { + switch (accessLevel) + { + case PRIVATE: return ClassConstants.INTERNAL_ACC_PRIVATE; + default: return 0; + case PROTECTED: return ClassConstants.INTERNAL_ACC_PROTECTED; + case PUBLIC: return ClassConstants.INTERNAL_ACC_PUBLIC; + } + } + + + /** + * Replaces the access part of the given access flags. + * @param accessFlags the internal access flags. + * @param accessFlags the new internal access flags. + */ + public static int replaceAccessFlags(int accessFlags, int newAccessFlags) + { + // A private class member should not be explicitly final. + if (newAccessFlags == ClassConstants.INTERNAL_ACC_PRIVATE) + { + accessFlags &= ~ClassConstants.INTERNAL_ACC_FINAL; + } + + return (accessFlags & ~ACCESS_MASK) | + (newAccessFlags & ACCESS_MASK); + } +} diff --git a/src/proguard/classfile/util/ClassReferenceInitializer.java b/src/proguard/classfile/util/ClassReferenceInitializer.java new file mode 100644 index 0000000..b1f2c27 --- /dev/null +++ b/src/proguard/classfile/util/ClassReferenceInitializer.java @@ -0,0 +1,545 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.visitor.*; + + +/** + * This ClassVisitor initializes the references of all classes that + * it visits. + *

    + * All class constant pool entries get direct references to the corresponding + * classes. These references make it more convenient to travel up and across + * the class hierarchy. + *

    + * All field and method reference constant pool entries get direct references + * to the corresponding classes, fields, and methods. + *

    + * All name and type constant pool entries get a list of direct references to + * the classes listed in the type. + *

    + * This visitor optionally prints warnings if some items can't be found. + *

    + * The class hierarchy must be initialized before using this visitor. + * + * @author Eric Lafortune + */ +public class ClassReferenceInitializer +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor, + AttributeVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + private final WarningPrinter missingClassWarningPrinter; + private final WarningPrinter missingMemberWarningPrinter; + private final WarningPrinter dependencyWarningPrinter; + + private final MemberFinder memberFinder = new MemberFinder(); + + + /** + * Creates a new ClassReferenceInitializer that initializes the references + * of all visited class files, optionally printing warnings if some classes + * or class members can't be found or if they are in the program class pool. + */ + public ClassReferenceInitializer(ClassPool programClassPool, + ClassPool libraryClassPool, + WarningPrinter missingClassWarningPrinter, + WarningPrinter missingMemberWarningPrinter, + WarningPrinter dependencyWarningPrinter) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + this.missingClassWarningPrinter = missingClassWarningPrinter; + this.missingMemberWarningPrinter = missingMemberWarningPrinter; + this.dependencyWarningPrinter = dependencyWarningPrinter; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Initialize the constant pool entries. + programClass.constantPoolEntriesAccept(this); + + // Initialize all fields and methods. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + // Initialize the attributes. + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Initialize all fields and methods. + libraryClass.fieldsAccept(this); + libraryClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + programField.referencedClass = + findReferencedClass(programClass.getName(), + programField.getDescriptor(programClass)); + + // Initialize the attributes. + programField.attributesAccept(programClass, this); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + programMethod.referencedClasses = + findReferencedClasses(programClass.getName(), + programMethod.getDescriptor(programClass)); + + // Initialize the attributes. + programMethod.attributesAccept(programClass, this); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + libraryField.referencedClass = + findReferencedClass(libraryClass.getName(), + libraryField.getDescriptor(libraryClass)); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + libraryMethod.referencedClasses = + findReferencedClasses(libraryClass.getName(), + libraryMethod.getDescriptor(libraryClass)); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Fill out the String class. + stringConstant.javaLangStringClass = + findClass(clazz.getName(), ClassConstants.INTERNAL_NAME_JAVA_LANG_STRING); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + String className = refConstant.getClassName(clazz); + + // See if we can find the referenced class. + // Unresolved references are assumed to refer to library classes + // that will not change anyway. + Clazz referencedClass = findClass(clazz.getName(), className); + + if (referencedClass != null && + !ClassUtil.isInternalArrayType(className)) + { + String name = refConstant.getName(clazz); + String type = refConstant.getType(clazz); + + boolean isFieldRef = refConstant.getTag() == ClassConstants.CONSTANT_Fieldref; + + // See if we can find the referenced class member somewhere in the + // hierarchy. + refConstant.referencedMember = memberFinder.findMember(clazz, + referencedClass, + name, + type, + isFieldRef); + refConstant.referencedClass = memberFinder.correspondingClass(); + + if (refConstant.referencedMember == null) + { + // We've haven't found the class member anywhere in the hierarchy. + missingMemberWarningPrinter.print(clazz.getName(), + className, + "Warning: " + + ClassUtil.externalClassName(clazz.getName()) + + ": can't find referenced " + + (isFieldRef ? + "field '" + ClassUtil.externalFullFieldDescription(0, name, type) : + "method '" + ClassUtil.externalFullMethodDescription(className, 0, name, type)) + + "' in class " + + ClassUtil.externalClassName(className)); + } + } + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + String className = clazz.getName(); + + // Fill out the referenced class. + classConstant.referencedClass = + findClass(className, classConstant.getName(clazz)); + + // Fill out the Class class. + classConstant.javaLangClassClass = + findClass(className, ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + String className = clazz.getName(); + String enclosingClassName = enclosingMethodAttribute.getClassName(clazz); + + // See if we can find the referenced class. + Clazz referencedClass = findClass(className, enclosingClassName); + + if (referencedClass == null) + { + // We couldn't find the enclosing class. + missingClassWarningPrinter.print(className, + enclosingClassName, + "Warning: " + + ClassUtil.externalClassName(className) + + ": can't find enclosing class " + + ClassUtil.externalClassName(enclosingClassName)); + return; + } + + // Make sure there is actually an enclosed method. + if (enclosingMethodAttribute.u2nameAndTypeIndex == 0) + { + return; + } + + String name = enclosingMethodAttribute.getName(clazz); + String type = enclosingMethodAttribute.getType(clazz); + + // See if we can find the method in the referenced class. + Method referencedMethod = referencedClass.findMethod(name, type); + + if (referencedMethod == null) + { + // We couldn't find the enclosing method. + missingMemberWarningPrinter.print(className, + enclosingClassName, + "Warning: " + + ClassUtil.externalClassName(className) + + ": can't find enclosing method '" + + ClassUtil.externalFullMethodDescription(enclosingClassName, 0, name, type) + + "' in class " + + ClassUtil.externalClassName(enclosingClassName)); + return; + } + + // Save the references. + enclosingMethodAttribute.referencedClass = referencedClass; + enclosingMethodAttribute.referencedMethod = referencedMethod; + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Initialize the nested attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Initialize the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Initialize the local variable types. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + signatureAttribute.referencedClasses = + findReferencedClasses(clazz.getName(), + clazz.getString(signatureAttribute.u2signatureIndex)); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Initialize the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Initialize the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Initialize the annotation. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + localVariableInfo.referencedClass = + findReferencedClass(clazz.getName(), + clazz.getString(localVariableInfo.u2descriptorIndex)); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + localVariableTypeInfo.referencedClasses = + findReferencedClasses(clazz.getName(), + clazz.getString(localVariableTypeInfo.u2signatureIndex)); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + annotation.referencedClasses = + findReferencedClasses(clazz.getName(), + clazz.getString(annotation.u2typeIndex)); + + // Initialize the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + initializeElementValue(clazz, annotation, constantElementValue); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + initializeElementValue(clazz, annotation, enumConstantElementValue); + + enumConstantElementValue.referencedClasses = + findReferencedClasses(clazz.getName(), + clazz.getString(enumConstantElementValue.u2typeNameIndex)); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + initializeElementValue(clazz, annotation, classElementValue); + + classElementValue.referencedClasses = + findReferencedClasses(clazz.getName(), + clazz.getString(classElementValue.u2classInfoIndex)); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + initializeElementValue(clazz, annotation, annotationElementValue); + + // Initialize the annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + initializeElementValue(clazz, annotation, arrayElementValue); + + // Initialize the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + /** + * Initializes the referenced method of an element value, if any. + */ + private void initializeElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) + { + // See if we have a referenced class. + if (annotation != null && + annotation.referencedClasses != null && + elementValue.u2elementNameIndex != 0) + { + // See if we can find the method in the referenced class + // (ignoring the descriptor). + String name = clazz.getString(elementValue.u2elementNameIndex); + + Clazz referencedClass = annotation.referencedClasses[0]; + elementValue.referencedClass = referencedClass; + elementValue.referencedMethod = referencedClass.findMethod(name, null); + } + } + + + // Small utility methods. + + /** + * Returns the single class referenced by the given descriptor, or + * null if there isn't any useful reference. + */ + private Clazz findReferencedClass(String referencingClassName, + String descriptor) + { + DescriptorClassEnumeration enumeration = + new DescriptorClassEnumeration(descriptor); + + enumeration.nextFluff(); + + if (enumeration.hasMoreClassNames()) + { + return findClass(referencingClassName, enumeration.nextClassName()); + } + + return null; + } + + + /** + * Returns an array of classes referenced by the given descriptor, or + * null if there aren't any useful references. + */ + private Clazz[] findReferencedClasses(String referencingClassName, + String descriptor) + { + DescriptorClassEnumeration enumeration = + new DescriptorClassEnumeration(descriptor); + + int classCount = enumeration.classCount(); + if (classCount > 0) + { + Clazz[] referencedClasses = new Clazz[classCount]; + + boolean foundReferencedClasses = false; + + for (int index = 0; index < classCount; index++) + { + String fluff = enumeration.nextFluff(); + String name = enumeration.nextClassName(); + + Clazz referencedClass = findClass(referencingClassName, name); + + if (referencedClass != null) + { + referencedClasses[index] = referencedClass; + foundReferencedClasses = true; + } + } + + if (foundReferencedClasses) + { + return referencedClasses; + } + } + + return null; + } + + + /** + * Returns the class with the given name, either for the program class pool + * or from the library class pool, or null if it can't be found. + */ + private Clazz findClass(String referencingClassName, String name) + { + // Ignore any primitive array types. + if (ClassUtil.isInternalArrayType(name) && + !ClassUtil.isInternalClassType(name)) + { + return null; + } + + // First look for the class in the program class pool. + Clazz clazz = programClassPool.getClass(name); + + // Otherwise look for the class in the library class pool. + if (clazz == null) + { + clazz = libraryClassPool.getClass(name); + + if (clazz == null && + missingClassWarningPrinter != null) + { + // We didn't find the superclass or interface. Print a warning. + missingClassWarningPrinter.print(referencingClassName, + name, + "Warning: " + + ClassUtil.externalClassName(referencingClassName) + + ": can't find referenced class " + + ClassUtil.externalClassName(name)); + } + } + else if (dependencyWarningPrinter != null) + { + // The superclass or interface was found in the program class pool. + // Print a warning. + dependencyWarningPrinter.print(referencingClassName, + name, + "Warning: library class " + + ClassUtil.externalClassName(referencingClassName) + + " depends on program class " + + ClassUtil.externalClassName(name)); + } + + return clazz; + } +} diff --git a/src/proguard/classfile/util/ClassSubHierarchyInitializer.java b/src/proguard/classfile/util/ClassSubHierarchyInitializer.java new file mode 100644 index 0000000..30fd526 --- /dev/null +++ b/src/proguard/classfile/util/ClassSubHierarchyInitializer.java @@ -0,0 +1,77 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor adds all classes that it visits to the list of subclasses + * of their superclass. These subclass lists make it more convenient to travel + * + * @author Eric Lafortune + */ +public class ClassSubHierarchyInitializer +implements ClassVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Add this class to the subclasses of its superclass. + addSubclass(programClass, programClass.getSuperClass()); + + // Add this class to the subclasses of its interfaces. + for (int index = 0; index < programClass.u2interfacesCount; index++) + { + addSubclass(programClass, programClass.getInterface(index)); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Add this class to the subclasses of its superclass, + addSubclass(libraryClass, libraryClass.superClass); + + // Add this class to the subclasses of its interfaces. + Clazz[] interfaceClasses = libraryClass.interfaceClasses; + if (interfaceClasses != null) + { + for (int index = 0; index < interfaceClasses.length; index++) + { + // Add this class to the subclasses of the interface class. + addSubclass(libraryClass, interfaceClasses[index]); + } + } + } + + + // Small utility methods. + + private void addSubclass(Clazz subclass, Clazz clazz) + { + if (clazz != null) + { + clazz.addSubClass(subclass); + } + } +} diff --git a/src/proguard/classfile/util/ClassSuperHierarchyInitializer.java b/src/proguard/classfile/util/ClassSuperHierarchyInitializer.java new file mode 100644 index 0000000..af2a209 --- /dev/null +++ b/src/proguard/classfile/util/ClassSuperHierarchyInitializer.java @@ -0,0 +1,168 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor initializes the superclass hierarchy of all classes that + * it visits. + *

    + * Visited library classes get direct references to their superclasses and + * interfaces, replacing the superclass names and interface names. The direct + * references are equivalent to the names, but they are more efficient to work + * with. + *

    + * This visitor optionally prints warnings if some superclasses can't be found + * or if they are in the program class pool. + * + * @author Eric Lafortune + */ +public class ClassSuperHierarchyInitializer +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor +{ + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + private final WarningPrinter missingWarningPrinter; + private final WarningPrinter dependencyWarningPrinter; + + + /** + * Creates a new ClassSuperHierarchyInitializer that initializes the super + * hierarchy of all visited class files, optionally printing warnings if + * some classes can't be found or if they are in the program class pool. + */ + public ClassSuperHierarchyInitializer(ClassPool programClassPool, + ClassPool libraryClassPool, + WarningPrinter missingWarningPrinter, + WarningPrinter dependencyWarningPrinter) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + this.missingWarningPrinter = missingWarningPrinter; + this.dependencyWarningPrinter = dependencyWarningPrinter; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Link to the super class. + programClass.superClassConstantAccept(this); + + // Link to the interfaces. + programClass.interfaceConstantsAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + String className = libraryClass.getName(); + + // Link to the super class. + String superClassName = libraryClass.superClassName; + if (superClassName != null) + { + // Keep a reference to the superclass. + libraryClass.superClass = findClass(className, superClassName); + } + + // Link to the interfaces. + if (libraryClass.interfaceNames != null) + { + String[] interfaceNames = libraryClass.interfaceNames; + Clazz[] interfaceClasses = new Clazz[interfaceNames.length]; + + for (int index = 0; index < interfaceNames.length; index++) + { + // Keep a reference to the interface class. + interfaceClasses[index] = + findClass(className, interfaceNames[index]); + } + + libraryClass.interfaceClasses = interfaceClasses; + } + + // Discard the name Strings. From now on, we'll use the object + // references. + libraryClass.superClassName = null; + libraryClass.interfaceNames = null; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.referencedClass = + findClass(clazz.getName(), classConstant.getName(clazz)); + } + + + // Small utility methods. + + /** + * Returns the class with the given name, either for the program class pool + * or from the library class pool, or null if it can't be found. + */ + private Clazz findClass(String referencingClassName, String name) + { + // First look for the class in the program class pool. + Clazz clazz = programClassPool.getClass(name); + + // Otherwise look for the class in the library class pool. + if (clazz == null) + { + clazz = libraryClassPool.getClass(name); + + if (clazz == null && + missingWarningPrinter != null) + { + // We didn't find the superclass or interface. Print a warning. + missingWarningPrinter.print(referencingClassName, + name, + "Warning: " + + ClassUtil.externalClassName(referencingClassName) + + ": can't find superclass or interface " + + ClassUtil.externalClassName(name)); + } + } + else if (dependencyWarningPrinter != null) + { + // The superclass or interface was found in the program class pool. + // Print a warning. + dependencyWarningPrinter.print(referencingClassName, + name, + "Warning: library class " + + ClassUtil.externalClassName(referencingClassName) + + " extends or implements program class " + + ClassUtil.externalClassName(name)); + } + + return clazz; + } +} diff --git a/src/proguard/classfile/util/ClassUtil.java b/src/proguard/classfile/util/ClassUtil.java new file mode 100644 index 0000000..5f25f01 --- /dev/null +++ b/src/proguard/classfile/util/ClassUtil.java @@ -0,0 +1,1154 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.ClassConstants; + +import java.util.List; + +/** + * Utility methods for converting between internal and external representations + * of names and descriptions. + * + * @author Eric Lafortune + */ +public class ClassUtil +{ + private static final String EMPTY_STRING = ""; + + + /** + * Checks whether the given class magic number is correct. + * @param magicNumber the magic number. + * @throws UnsupportedOperationException when the magic number is incorrect. + */ + public static void checkMagicNumber(int magicNumber) throws UnsupportedOperationException + { + if (magicNumber != ClassConstants.MAGIC) + { + throw new UnsupportedOperationException("Invalid magic number ["+Integer.toHexString(magicNumber)+"] in class"); + } + } + + + /** + * Returns the combined class version number. + * @param majorVersion the major part of the class version number. + * @param minorVersion the minor part of the class version number. + * @return the combined class version number. + */ + public static int internalClassVersion(int majorVersion, int minorVersion) + { + return (majorVersion << 16) | minorVersion; + } + + + /** + * Returns the major part of the given class version number. + * @param classVersion the combined class version number. + * @return the major part of the class version number. + */ + public static int internalMajorClassVersion(int classVersion) + { + return classVersion >>> 16; + } + + + /** + * Returns the internal class version number. + * @param classVersion the external class version number. + * @return the internal class version number. + */ + public static int internalMinorClassVersion(int classVersion) + { + return classVersion & 0xffff; + } + + + /** + * Returns the internal class version number. + * @param classVersion the external class version number. + * @return the internal class version number. + */ + public static int internalClassVersion(String classVersion) + { + return + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_0) || + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_1) ? ClassConstants.INTERNAL_CLASS_VERSION_1_0 : + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_2) ? ClassConstants.INTERNAL_CLASS_VERSION_1_2 : + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_3) ? ClassConstants.INTERNAL_CLASS_VERSION_1_3 : + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_4) ? ClassConstants.INTERNAL_CLASS_VERSION_1_4 : + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_5_ALIAS) || + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_5) ? ClassConstants.INTERNAL_CLASS_VERSION_1_5 : + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_6_ALIAS) || + classVersion.equals(ClassConstants.EXTERNAL_CLASS_VERSION_1_6) ? ClassConstants.INTERNAL_CLASS_VERSION_1_6 : + 0; + } + + + /** + * Returns the minor part of the given class version number. + * @param classVersion the combined class version number. + * @return the minor part of the class version number. + */ + public static String externalClassVersion(int classVersion) + { + switch (classVersion) + { + case ClassConstants.INTERNAL_CLASS_VERSION_1_0: return ClassConstants.EXTERNAL_CLASS_VERSION_1_0; + case ClassConstants.INTERNAL_CLASS_VERSION_1_2: return ClassConstants.EXTERNAL_CLASS_VERSION_1_2; + case ClassConstants.INTERNAL_CLASS_VERSION_1_3: return ClassConstants.EXTERNAL_CLASS_VERSION_1_3; + case ClassConstants.INTERNAL_CLASS_VERSION_1_4: return ClassConstants.EXTERNAL_CLASS_VERSION_1_4; + case ClassConstants.INTERNAL_CLASS_VERSION_1_5: return ClassConstants.EXTERNAL_CLASS_VERSION_1_5; + case ClassConstants.INTERNAL_CLASS_VERSION_1_6: return ClassConstants.EXTERNAL_CLASS_VERSION_1_6; + default: return null; + } + } + + + /** + * Checks whether the given class version number is supported. + * @param classVersion the combined class version number. + * @throws UnsupportedOperationException when the version is not supported. + */ + public static void checkVersionNumbers(int classVersion) throws UnsupportedOperationException + { + if (classVersion < ClassConstants.INTERNAL_CLASS_VERSION_1_0 || + classVersion > ClassConstants.INTERNAL_CLASS_VERSION_1_6) + { + throw new UnsupportedOperationException("Unsupported version number ["+ + internalMajorClassVersion(classVersion)+"."+ + internalMinorClassVersion(classVersion)+"] for class format"); + } + } + + + /** + * Converts an external class name into an internal class name. + * @param externalClassName the external class name, + * e.g. "java.lang.Object" + * @return the internal class name, + * e.g. "java/lang/Object". + */ + public static String internalClassName(String externalClassName) + { + return externalClassName.replace(ClassConstants.EXTERNAL_PACKAGE_SEPARATOR, + ClassConstants.INTERNAL_PACKAGE_SEPARATOR); + } + + + /** + * Converts an internal class description into an external class description. + * @param accessFlags the access flags of the class. + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @return the external class description, + * e.g. "public java.lang.Object". + */ + public static String externalFullClassDescription(int accessFlags, + String internalClassName) + { + return externalClassAccessFlags(accessFlags) + + externalClassName(internalClassName); + } + + + /** + * Converts an internal class name into an external class name. + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @return the external class name, + * e.g. "java.lang.Object". + */ + public static String externalClassName(String internalClassName) + { + return //internalClassName.startsWith(ClassConstants.INTERNAL_PACKAGE_JAVA_LANG) && + //internalClassName.indexOf(ClassConstants.INTERNAL_PACKAGE_SEPARATOR, ClassConstants.INTERNAL_PACKAGE_JAVA_LANG.length() + 1) < 0 ? + //internalClassName.substring(ClassConstants.INTERNAL_PACKAGE_JAVA_LANG.length()) : + internalClassName.replace(ClassConstants.INTERNAL_PACKAGE_SEPARATOR, + ClassConstants.EXTERNAL_PACKAGE_SEPARATOR); + } + + + /** + * Converts an internal class name into an external short class name, without + * package specification. + * @param externalClassName the external class name, + * e.g. "java.lang.Object" + * @return the external short class name, + * e.g. "Object". + */ + public static String externalShortClassName(String externalClassName) + { + int index = externalClassName.lastIndexOf(ClassConstants.EXTERNAL_PACKAGE_SEPARATOR); + return externalClassName.substring(index+1); + } + + + /** + * Returns whether the given internal type is an array type. + * @param internalType the internal type, + * e.g. "[[Ljava/lang/Object;". + * @return true if the given type is an array type, + * false otherwise. + */ + public static boolean isInternalArrayType(String internalType) + { + return internalType.length() > 1 && + internalType.charAt(0) == ClassConstants.INTERNAL_TYPE_ARRAY; + } + + + /** + * Returns the number of dimensions of the given internal type. + * @param internalType the internal type, + * e.g. "[[Ljava/lang/Object;". + * @return the number of dimensions, e.g. 2. + */ + public static int internalArrayTypeDimensionCount(String internalType) + { + int dimensions = 0; + while (internalType.charAt(dimensions) == ClassConstants.INTERNAL_TYPE_ARRAY) + { + dimensions++; + } + + return dimensions; + } + + + /** + * Returns whether the given internal class name is one of the interfaces + * that is implemented by all array types. These class names are + * "java/lang/Object", "java/lang/Cloneable", and + * "java/io/Serializable" + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @return true if the given type is an array interface name, + * false otherwise. + */ + public static boolean isInternalArrayInterfaceName(String internalClassName) + { + return ClassConstants.INTERNAL_NAME_JAVA_LANG_OBJECT.equals(internalClassName) || + ClassConstants.INTERNAL_NAME_JAVA_LANG_CLONEABLE.equals(internalClassName) || + ClassConstants.INTERNAL_NAME_JAVA_IO_SERIALIZABLE.equals(internalClassName); + } + + + /** + * Returns whether the given internal type is a plain primitive type + * (not void). + * @param internalType the internal type, + * e.g. "I". + * @return true if the given type is a class type, + * false otherwise. + */ + public static boolean isInternalPrimitiveType(char internalType) + { + return internalType == ClassConstants.INTERNAL_TYPE_BOOLEAN || + internalType == ClassConstants.INTERNAL_TYPE_BYTE || + internalType == ClassConstants.INTERNAL_TYPE_CHAR || + internalType == ClassConstants.INTERNAL_TYPE_SHORT || + internalType == ClassConstants.INTERNAL_TYPE_INT || + internalType == ClassConstants.INTERNAL_TYPE_FLOAT || + internalType == ClassConstants.INTERNAL_TYPE_LONG || + internalType == ClassConstants.INTERNAL_TYPE_DOUBLE; + } + + + /** + * Returns whether the given internal type is a primitive Category 2 type. + * @param internalType the internal type, + * e.g. "L". + * @return true if the given type is a Category 2 type, + * false otherwise. + */ + public static boolean isInternalCategory2Type(String internalType) + { + return internalType.length() == 1 && + (internalType.charAt(0) == ClassConstants.INTERNAL_TYPE_LONG || + internalType.charAt(0) == ClassConstants.INTERNAL_TYPE_DOUBLE); + } + + + /** + * Returns whether the given internal type is a plain class type + * (including an array type of a plain class type). + * @param internalType the internal type, + * e.g. "Ljava/lang/Object;". + * @return true if the given type is a class type, + * false otherwise. + */ + public static boolean isInternalClassType(String internalType) + { + int length = internalType.length(); + return length > 1 && +// internalType.charAt(0) == ClassConstants.INTERNAL_TYPE_CLASS_START && + internalType.charAt(length-1) == ClassConstants.INTERNAL_TYPE_CLASS_END; + } + + + /** + * Returns the internal type of a given class name. + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @return the internal type, + * e.g. "Ljava/lang/Object;". + */ + public static String internalTypeFromClassName(String internalClassName) + { + return internalArrayTypeFromClassName(internalClassName, 0); + } + + + /** + * Returns the internal array type of a given class name with a given number + * of dimensions. If the number of dimensions is 0, the class name itself is + * returned. + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @param dimensionCount the number of array dimensions. + * @return the internal array type of the array elements, + * e.g. "Ljava/lang/Object;". + */ + public static String internalArrayTypeFromClassName(String internalClassName, + int dimensionCount) + { + StringBuffer buffer = new StringBuffer(internalClassName.length() + dimensionCount + 2); + + for (int dimension = 0; dimension < dimensionCount; dimension++) + { + buffer.append(ClassConstants.INTERNAL_TYPE_ARRAY); + } + + return buffer.append(ClassConstants.INTERNAL_TYPE_CLASS_START) + .append(internalClassName) + .append(ClassConstants.INTERNAL_TYPE_CLASS_END) + .toString(); + } + + + /** + * Returns the internal element type of a given internal array type. + * @param internalArrayType the internal array type, + * e.g. "[[Ljava/lang/Object;" or + * "[I". + * @return the internal type of the array elements, + * e.g. "Ljava/lang/Object;" or + * "I". + */ + public static String internalTypeFromArrayType(String internalArrayType) + { + int index = internalArrayType.lastIndexOf(ClassConstants.INTERNAL_TYPE_ARRAY); + return internalArrayType.substring(index+1); + } + + + /** + * Returns the internal class name of a given internal class type + * (including an array type). Types involving primitive types are returned + * unchanged. + * @param internalClassType the internal class type, + * e.g. "[Ljava/lang/Object;", + * "Ljava/lang/Object;", or + * "java/lang/Object". + * @return the internal class name, + * e.g. "java/lang/Object". + */ + public static String internalClassNameFromClassType(String internalClassType) + { + return isInternalClassType(internalClassType) ? + internalClassType.substring(internalClassType.indexOf(ClassConstants.INTERNAL_TYPE_CLASS_START)+1, + internalClassType.length()-1) : + internalClassType; + } + + + /** + * Returns the internal class name of any given internal descriptor type, + * disregarding array prefixes. + * @param internalClassType the internal class type, + * e.g. "Ljava/lang/Object;" or + * "[[I". + * @return the internal class name, + * e.g. "java/lang/Object" or + * null. + */ + public static String internalClassNameFromType(String internalClassType) + { + if (!isInternalClassType(internalClassType)) + { + return null; + } + + // Is it an array type? + if (isInternalArrayType(internalClassType)) + { + internalClassType = internalTypeFromArrayType(internalClassType); + } + + return internalClassNameFromClassType(internalClassType); + } + + + /** + * Returns the internal type of the given internal method descriptor. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(II)Z". + * @return the internal return type, + * e.g. "Z". + */ + public static String internalMethodReturnType(String internalMethodDescriptor) + { + int index = internalMethodDescriptor.indexOf(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + return internalMethodDescriptor.substring(index + 1); + } + + + /** + * Returns the number of parameters of the given internal method descriptor. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(ID)Z". + * @return the number of parameters, + * e.g. 2. + */ + public static int internalMethodParameterCount(String internalMethodDescriptor) + { + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(internalMethodDescriptor); + + int counter = 0; + while (internalTypeEnumeration.hasMoreTypes()) + { + internalTypeEnumeration.nextType(); + + counter++; + } + + return counter; + } + + + /** + * Returns the size taken up on the stack by the parameters of the given + * internal method descriptor. This accounts for long and double parameters + * taking up two entries. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(ID)Z". + * @return the size taken up on the stack, + * e.g. 3. + */ + public static int internalMethodParameterSize(String internalMethodDescriptor) + { + return internalMethodParameterSize(internalMethodDescriptor, true); + } + + + /** + * Returns the size taken up on the stack by the parameters of the given + * internal method descriptor. This accounts for long and double parameters + * taking up two entries, and a non-static method taking up an additional + * entry. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(ID)Z". + * @param accessFlags the access flags of the method, + * e.g. 0. + * @return the size taken up on the stack, + * e.g. 4. + */ + public static int internalMethodParameterSize(String internalMethodDescriptor, + int accessFlags) + { + return internalMethodParameterSize(internalMethodDescriptor, + (accessFlags & ClassConstants.INTERNAL_ACC_STATIC) != 0); + } + + + /** + * Returns the size taken up on the stack by the parameters of the given + * internal method descriptor. This accounts for long and double parameters + * taking up two spaces, and a non-static method taking up an additional + * entry. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(ID)Z". + * @param isStatic specifies whether the method is static, + * e.g. false. + * @return the size taken up on the stack, + * e.g. 4. + */ + public static int internalMethodParameterSize(String internalMethodDescriptor, + boolean isStatic) + { + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(internalMethodDescriptor); + + int size = isStatic ? 0 : 1; + while (internalTypeEnumeration.hasMoreTypes()) + { + String internalType = internalTypeEnumeration.nextType(); + + size += internalTypeSize(internalType); + } + + return size; + } + + + /** + * Returns the size taken up on the stack by the given internal type. + * The size is 1, except for long and double types, for which it is 2, + * and for the void type, for which 0 is returned. + * @param internalType the internal type, + * e.g. "I". + * @return the size taken up on the stack, + * e.g. 1. + */ + public static int internalTypeSize(String internalType) + { + if (internalType.length() == 1) + { + char internalPrimitiveType = internalType.charAt(0); + if (internalPrimitiveType == ClassConstants.INTERNAL_TYPE_LONG || + internalPrimitiveType == ClassConstants.INTERNAL_TYPE_DOUBLE) + { + return 2; + } + else if (internalPrimitiveType == ClassConstants.INTERNAL_TYPE_VOID) + { + return 0; + } + } + + return 1; + } + + + /** + * Converts an external type into an internal type. + * @param externalType the external type, + * e.g. "java.lang.Object[][]" or + * "int[]". + * @return the internal type, + * e.g. "[[Ljava/lang/Object;" or + * "[I". + */ + public static String internalType(String externalType) + { + // Strip the array part, if any. + int dimensionCount = externalArrayTypeDimensionCount(externalType); + if (dimensionCount > 0) + { + externalType = externalType.substring(0, externalType.length() - dimensionCount * ClassConstants.EXTERNAL_TYPE_ARRAY.length()); + } + + // Analyze the actual type part. + char internalTypeChar = + externalType.equals(ClassConstants.EXTERNAL_TYPE_VOID ) ? + ClassConstants.INTERNAL_TYPE_VOID : + externalType.equals(ClassConstants.EXTERNAL_TYPE_BOOLEAN) ? + ClassConstants.INTERNAL_TYPE_BOOLEAN : + externalType.equals(ClassConstants.EXTERNAL_TYPE_BYTE ) ? + ClassConstants.INTERNAL_TYPE_BYTE : + externalType.equals(ClassConstants.EXTERNAL_TYPE_CHAR ) ? + ClassConstants.INTERNAL_TYPE_CHAR : + externalType.equals(ClassConstants.EXTERNAL_TYPE_SHORT ) ? + ClassConstants.INTERNAL_TYPE_SHORT : + externalType.equals(ClassConstants.EXTERNAL_TYPE_INT ) ? + ClassConstants.INTERNAL_TYPE_INT : + externalType.equals(ClassConstants.EXTERNAL_TYPE_FLOAT ) ? + ClassConstants.INTERNAL_TYPE_FLOAT : + externalType.equals(ClassConstants.EXTERNAL_TYPE_LONG ) ? + ClassConstants.INTERNAL_TYPE_LONG : + externalType.equals(ClassConstants.EXTERNAL_TYPE_DOUBLE ) ? + ClassConstants.INTERNAL_TYPE_DOUBLE : + externalType.equals("%" ) ? + '%' : + (char)0; + + String internalType = + internalTypeChar != 0 ? String.valueOf(internalTypeChar) : + ClassConstants.INTERNAL_TYPE_CLASS_START + + internalClassName(externalType) + + ClassConstants.INTERNAL_TYPE_CLASS_END; + + // Prepend the array part, if any. + for (int count = 0; count < dimensionCount; count++) + { + internalType = ClassConstants.INTERNAL_TYPE_ARRAY + internalType; + } + + return internalType; + } + + + /** + * Returns the number of dimensions of the given external type. + * @param externalType the external type, + * e.g. "[[Ljava/lang/Object;". + * @return the number of dimensions, e.g. 2. + */ + public static int externalArrayTypeDimensionCount(String externalType) + { + int dimensions = 0; + int length = ClassConstants.EXTERNAL_TYPE_ARRAY.length(); + int offset = externalType.length() - length; + while (externalType.regionMatches(offset, + ClassConstants.EXTERNAL_TYPE_ARRAY, + 0, + length)) + { + dimensions++; + offset -= length; + } + + return dimensions; + } + + + /** + * Converts an internal type into an external type. + * @param internalType the internal type, + * e.g. "[[Ljava/lang/Object;" or + * "[I". + * @return the external type, + * e.g. "java.lang.Object[][]" or + * "int[]". + */ + public static String externalType(String internalType) + { + // Strip the array part, if any. + int dimensionCount = internalArrayTypeDimensionCount(internalType); + if (dimensionCount > 0) + { + internalType = internalType.substring(dimensionCount); + } + + // Analyze the actual type part. + char internalTypeChar = internalType.charAt(0); + + String externalType = + internalTypeChar == ClassConstants.INTERNAL_TYPE_VOID ? + ClassConstants.EXTERNAL_TYPE_VOID : + internalTypeChar == ClassConstants.INTERNAL_TYPE_BOOLEAN ? + ClassConstants.EXTERNAL_TYPE_BOOLEAN : + internalTypeChar == ClassConstants.INTERNAL_TYPE_BYTE ? + ClassConstants.EXTERNAL_TYPE_BYTE : + internalTypeChar == ClassConstants.INTERNAL_TYPE_CHAR ? + ClassConstants.EXTERNAL_TYPE_CHAR : + internalTypeChar == ClassConstants.INTERNAL_TYPE_SHORT ? + ClassConstants.EXTERNAL_TYPE_SHORT : + internalTypeChar == ClassConstants.INTERNAL_TYPE_INT ? + ClassConstants.EXTERNAL_TYPE_INT : + internalTypeChar == ClassConstants.INTERNAL_TYPE_FLOAT ? + ClassConstants.EXTERNAL_TYPE_FLOAT : + internalTypeChar == ClassConstants.INTERNAL_TYPE_LONG ? + ClassConstants.EXTERNAL_TYPE_LONG : + internalTypeChar == ClassConstants.INTERNAL_TYPE_DOUBLE ? + ClassConstants.EXTERNAL_TYPE_DOUBLE : + internalTypeChar == '%' ? + "%" : + internalTypeChar == ClassConstants.INTERNAL_TYPE_CLASS_START ? + externalClassName(internalType.substring(1, internalType.indexOf(ClassConstants.INTERNAL_TYPE_CLASS_END))) : + null; + + if (externalType == null) + { + throw new IllegalArgumentException("Unknown type ["+internalType+"]"); + } + + // Append the array part, if any. + for (int count = 0; count < dimensionCount; count++) + { + externalType += ClassConstants.EXTERNAL_TYPE_ARRAY; + } + + return externalType; + } + + + /** + * Returns whether the given internal descriptor String represents a method + * descriptor. + * @param internalDescriptor the internal descriptor String, + * e.g. "(II)Z". + * @return true if the given String is a method descriptor, + * false otherwise. + */ + public static boolean isInternalMethodDescriptor(String internalDescriptor) + { + return internalDescriptor.charAt(0) == ClassConstants.INTERNAL_METHOD_ARGUMENTS_OPEN; + } + + + /** + * Returns whether the given member String represents an external method + * name with arguments. + * @param externalMemberNameAndArguments the external member String, + * e.g. "myField" or + * e.g. "myMethod(int,int)". + * @return true if the given String refers to a method, + * false otherwise. + */ + public static boolean isExternalMethodNameAndArguments(String externalMemberNameAndArguments) + { + return externalMemberNameAndArguments.indexOf(ClassConstants.EXTERNAL_METHOD_ARGUMENTS_OPEN) > 0; + } + + + /** + * Returns the name part of the given external method name and arguments. + * @param externalMethodNameAndArguments the external method name and arguments, + * e.g. "myMethod(int,int)". + * @return the name part of the String, e.g. "myMethod". + */ + public static String externalMethodName(String externalMethodNameAndArguments) + { + ExternalTypeEnumeration externalTypeEnumeration = + new ExternalTypeEnumeration(externalMethodNameAndArguments); + + return externalTypeEnumeration.methodName(); + } + + + /** + * Converts the given external method return type and name and arguments to + * an internal method descriptor. + * @param externalReturnType the external method return type, + * e.g. "boolean". + * @param externalMethodNameAndArguments the external method name and arguments, + * e.g. "myMethod(int,int)". + * @return the internal method descriptor, + * e.g. "(II)Z". + */ + public static String internalMethodDescriptor(String externalReturnType, + String externalMethodNameAndArguments) + { + StringBuffer internalMethodDescriptor = new StringBuffer(); + internalMethodDescriptor.append(ClassConstants.INTERNAL_METHOD_ARGUMENTS_OPEN); + + ExternalTypeEnumeration externalTypeEnumeration = + new ExternalTypeEnumeration(externalMethodNameAndArguments); + + while (externalTypeEnumeration.hasMoreTypes()) + { + internalMethodDescriptor.append(internalType(externalTypeEnumeration.nextType())); + } + + internalMethodDescriptor.append(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + internalMethodDescriptor.append(internalType(externalReturnType)); + + return internalMethodDescriptor.toString(); + } + + + /** + * Converts the given external method return type and List of arguments to + * an internal method descriptor. + * @param externalReturnType the external method return type, + * e.g. "boolean". + * @param externalArguments the external method arguments, + * e.g. { "int", "int" }. + * @return the internal method descriptor, + * e.g. "(II)Z". + */ + public static String internalMethodDescriptor(String externalReturnType, + List externalArguments) + { + StringBuffer internalMethodDescriptor = new StringBuffer(); + internalMethodDescriptor.append(ClassConstants.INTERNAL_METHOD_ARGUMENTS_OPEN); + + for (int index = 0; index < externalArguments.size(); index++) + { + internalMethodDescriptor.append(internalType((String)externalArguments.get(index))); + } + + internalMethodDescriptor.append(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + internalMethodDescriptor.append(internalType(externalReturnType)); + + return internalMethodDescriptor.toString(); + } + + + /** + * Converts an internal field description into an external full field description. + * @param accessFlags the access flags of the field. + * @param fieldName the field name, + * e.g. "myField". + * @param internalFieldDescriptor the internal field descriptor, + * e.g. "Z". + * @return the external full field description, + * e.g. "public boolean myField". + */ + public static String externalFullFieldDescription(int accessFlags, + String fieldName, + String internalFieldDescriptor) + { + return externalFieldAccessFlags(accessFlags) + + externalType(internalFieldDescriptor) + + ' ' + + fieldName; + } + + + /** + * Converts an internal method description into an external full method description. + * @param internalClassName the internal name of the class of the method, + * e.g. "mypackage/MyClass". + * @param accessFlags the access flags of the method. + * @param internalMethodName the internal method name, + * e.g. "myMethod" or + * "<init>". + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(II)Z". + * @return the external full method description, + * e.g. "public boolean myMethod(int,int)" or + * "public MyClass(int,int)". + */ + public static String externalFullMethodDescription(String internalClassName, + int accessFlags, + String internalMethodName, + String internalMethodDescriptor) + { + return externalMethodAccessFlags(accessFlags) + + externalMethodReturnTypeAndName(internalClassName, + internalMethodName, + internalMethodDescriptor) + + ClassConstants.EXTERNAL_METHOD_ARGUMENTS_OPEN + + externalMethodArguments(internalMethodDescriptor) + + ClassConstants.EXTERNAL_METHOD_ARGUMENTS_CLOSE; + } + + + /** + * Converts internal class access flags into an external access description. + * @param accessFlags the class access flags. + * @return the external class access description, + * e.g. "public final ". + */ + public static String externalClassAccessFlags(int accessFlags) + { + return externalClassAccessFlags(accessFlags, ""); + } + + + /** + * Converts internal class access flags into an external access description. + * @param accessFlags the class access flags. + * @param prefix a prefix that is added to each access modifier. + * @return the external class access description, + * e.g. "public final ". + */ + public static String externalClassAccessFlags(int accessFlags, String prefix) + { + if (accessFlags == 0) + { + return EMPTY_STRING; + } + + StringBuffer string = new StringBuffer(50); + + if ((accessFlags & ClassConstants.INTERNAL_ACC_PUBLIC) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PUBLIC).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_FINAL) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_FINAL).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_ANNOTATTION) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_ANNOTATION); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_INTERFACE) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_INTERFACE).append(' '); + } + else if ((accessFlags & ClassConstants.INTERNAL_ACC_ENUM) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_ENUM).append(' '); + } + else if ((accessFlags & ClassConstants.INTERNAL_ACC_ABSTRACT) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_ABSTRACT).append(' '); + } + + return string.toString(); + } + + + /** + * Converts internal field access flags into an external access description. + * @param accessFlags the field access flags. + * @return the external field access description, + * e.g. "public volatile ". + */ + public static String externalFieldAccessFlags(int accessFlags) + { + return externalFieldAccessFlags(accessFlags, ""); + } + + + /** + * Converts internal field access flags into an external access description. + * @param accessFlags the field access flags. + * @param prefix a prefix that is added to each access modifier. + * @return the external field access description, + * e.g. "public volatile ". + */ + public static String externalFieldAccessFlags(int accessFlags, String prefix) + { + if (accessFlags == 0) + { + return EMPTY_STRING; + } + + StringBuffer string = new StringBuffer(50); + + if ((accessFlags & ClassConstants.INTERNAL_ACC_PUBLIC) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PUBLIC).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_PRIVATE) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PRIVATE).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_PROTECTED) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PROTECTED).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_STATIC) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_STATIC).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_FINAL) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_FINAL).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_VOLATILE) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_VOLATILE).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_TRANSIENT) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_TRANSIENT).append(' '); + } + + return string.toString(); + } + + + /** + * Converts internal method access flags into an external access description. + * @param accessFlags the method access flags. + * @return the external method access description, + * e.g. "public synchronized ". + */ + public static String externalMethodAccessFlags(int accessFlags) + { + return externalMethodAccessFlags(accessFlags, ""); + } + + + /** + * Converts internal method access flags into an external access description. + * @param accessFlags the method access flags. + * @param prefix a prefix that is added to each access modifier. + * @return the external method access description, + * e.g. "public synchronized ". + */ + public static String externalMethodAccessFlags(int accessFlags, String prefix) + { + if (accessFlags == 0) + { + return EMPTY_STRING; + } + + StringBuffer string = new StringBuffer(50); + + if ((accessFlags & ClassConstants.INTERNAL_ACC_PUBLIC) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PUBLIC).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_PRIVATE) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PRIVATE).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_PROTECTED) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_PROTECTED).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_STATIC) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_STATIC).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_FINAL) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_FINAL).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_SYNCHRONIZED) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_SYNCHRONIZED).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_NATIVE) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_NATIVE).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_ABSTRACT) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_ABSTRACT).append(' '); + } + if ((accessFlags & ClassConstants.INTERNAL_ACC_STRICT) != 0) + { + string.append(prefix).append(ClassConstants.EXTERNAL_ACC_STRICT).append(' '); + } + + return string.toString(); + } + + + /** + * Converts an internal method descriptor into an external method return type. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(II)Z". + * @return the external method return type, + * e.g. "boolean". + */ + public static String externalMethodReturnType(String internalMethodDescriptor) + { + return externalType(internalMethodReturnType(internalMethodDescriptor)); + } + + + /** + * Converts an internal class name, method name, and method descriptor to + * an external method return type and name. + * @param internalClassName the internal name of the class of the method, + * e.g. "mypackage/MyClass". + * @param internalMethodName the internal method name, + * e.g. "myMethod" or + * "<init>". + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(II)Z". + * @return the external method return type and name, + * e.g. "boolean myMethod" or + * "MyClass". + */ + private static String externalMethodReturnTypeAndName(String internalClassName, + String internalMethodName, + String internalMethodDescriptor) + { + return internalMethodName.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) ? + externalShortClassName(externalClassName(internalClassName)) : + (externalMethodReturnType(internalMethodDescriptor) + + ' ' + + internalMethodName); + } + + + /** + * Converts an internal method descriptor into an external method argument + * description. + * @param internalMethodDescriptor the internal method descriptor, + * e.g. "(II)Z". + * @return the external method argument description, + * e.g. "int,int". + */ + public static String externalMethodArguments(String internalMethodDescriptor) + { + StringBuffer externalMethodNameAndArguments = new StringBuffer(); + + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(internalMethodDescriptor); + + while (internalTypeEnumeration.hasMoreTypes()) + { + externalMethodNameAndArguments.append(externalType(internalTypeEnumeration.nextType())); + if (internalTypeEnumeration.hasMoreTypes()) + { + externalMethodNameAndArguments.append(ClassConstants.EXTERNAL_METHOD_ARGUMENTS_SEPARATOR); + } + } + + return externalMethodNameAndArguments.toString(); + } + + + /** + * Returns the internal package name of the given internal class name. + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @return the internal package name, + * e.g. "java/lang". + */ + public static String internalPackageName(String internalClassName) + { + String internalPackagePrefix = internalPackagePrefix(internalClassName); + int length = internalPackagePrefix.length(); + return length > 0 ? + internalPackagePrefix.substring(0, length - 1) : + ""; + } + + + /** + * Returns the internal package prefix of the given internal class name. + * @param internalClassName the internal class name, + * e.g. "java/lang/Object". + * @return the internal package prefix, + * e.g. "java/lang/". + */ + public static String internalPackagePrefix(String internalClassName) + { + return internalClassName.substring(0, internalClassName.lastIndexOf(ClassConstants.INTERNAL_PACKAGE_SEPARATOR, + internalClassName.length() - 2) + 1); + } + + + /** + * Returns the external package name of the given external class name. + * @param externalClassName the external class name, + * e.g. "java.lang.Object". + * @return the external package name, + * e.g. "java.lang". + */ + public static String externalPackageName(String externalClassName) + { + String externalPackagePrefix = externalPackagePrefix(externalClassName); + int length = externalPackagePrefix.length(); + return length > 0 ? + externalPackagePrefix.substring(0, length - 1) : + ""; + } + + + /** + * Returns the external package prefix of the given external class name. + * @param externalClassName the external class name, + * e.g. "java.lang.Object". + * @return the external package prefix, + * e.g. "java.lang.". + */ + public static String externalPackagePrefix(String externalClassName) + { + return externalClassName.substring(0, externalClassName.lastIndexOf(ClassConstants.EXTERNAL_PACKAGE_SEPARATOR, + externalClassName.length() - 2) + 1); + } +} diff --git a/src/proguard/classfile/util/DescriptorClassEnumeration.java b/src/proguard/classfile/util/DescriptorClassEnumeration.java new file mode 100644 index 0000000..0bee2d5 --- /dev/null +++ b/src/proguard/classfile/util/DescriptorClassEnumeration.java @@ -0,0 +1,236 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.ClassConstants; + +import java.util.Stack; + +/** + * A DescriptorClassEnumeration provides an enumeration of all + * classes mentioned in a given descriptor or signature. + * + * @author Eric Lafortune + */ +public class DescriptorClassEnumeration +{ + private String descriptor; + + private int index; + private int nestingLevel; + private boolean isInnerClassName; + private String accumulatedClassName; + private Stack accumulatedClassNames; + + + /** + * Creates a new DescriptorClassEnumeration for the given descriptor. + */ + public DescriptorClassEnumeration(String descriptor) + { + this.descriptor = descriptor; + } + + + /** + * Returns the number of classes contained in the descriptor. This + * is the number of class names that the enumeration will return. + */ + public int classCount() + { + int count = 0; + + nextFluff(); + while (hasMoreClassNames()) + { + count++; + + nextClassName(); + nextFluff(); + } + + index = 0; + + return count; + } + + + /** + * Returns whether the enumeration can provide more class names from the + * descriptor. + */ + public boolean hasMoreClassNames() + { + return index < descriptor.length(); + } + + + /** + * Returns the next fluff (surrounding class names) from the descriptor. + */ + public String nextFluff() + { + int fluffStartIndex = index; + + // Find the first token marking the start of a class name 'L' or '.'. + loop: while (index < descriptor.length()) + { + switch (descriptor.charAt(index++)) + { + case ClassConstants.INTERNAL_TYPE_GENERIC_START: + { + nestingLevel++; + + // Make sure we have a stack. + if (accumulatedClassNames == null) + { + accumulatedClassNames = new Stack(); + } + + // Remember the accumulated class name. + accumulatedClassNames.push(accumulatedClassName); + + break; + } + case ClassConstants.INTERNAL_TYPE_GENERIC_END: + { + nestingLevel--; + + // Return to the accumulated class name outside the + // generic block. + accumulatedClassName = (String)accumulatedClassNames.pop(); + + continue loop; + } + case ClassConstants.INTERNAL_TYPE_GENERIC_BOUND: + { + continue loop; + } + case ClassConstants.INTERNAL_TYPE_CLASS_START: + { + // We've found the start of an ordinary class name. + nestingLevel += 2; + isInnerClassName = false; + break loop; + } + case ClassConstants.INTERNAL_TYPE_CLASS_END: + { + nestingLevel -= 2; + break; + } + case ClassConstants.EXTERNAL_INNER_CLASS_SEPARATOR: + { + // We've found the start of an inner class name in a signature. + isInnerClassName = true; + break loop; + } + case ClassConstants.INTERNAL_TYPE_GENERIC_VARIABLE_START: + { + // We've found the start of a type identifier. Skip to the end. + while (descriptor.charAt(index++) != ClassConstants.INTERNAL_TYPE_CLASS_END); + break; + } + } + + if (nestingLevel == 1 && + descriptor.charAt(index) != ClassConstants.INTERNAL_TYPE_GENERIC_END) + { + // We're at the start of a type parameter. Skip to the start + // of the bounds. + while (descriptor.charAt(index++) != ClassConstants.INTERNAL_TYPE_GENERIC_BOUND); + } + } + + return descriptor.substring(fluffStartIndex, index); + } + + + /** + * Returns the next class name from the descriptor. + */ + public String nextClassName() + { + int classNameStartIndex = index; + + // Find the first token marking the end of a class name '<' or ';'. + loop: while (true) + { + switch (descriptor.charAt(index)) + { + case ClassConstants.INTERNAL_TYPE_GENERIC_START: + case ClassConstants.INTERNAL_TYPE_CLASS_END: + case ClassConstants.EXTERNAL_INNER_CLASS_SEPARATOR: + { + break loop; + } + } + + index++; + } + + String className = descriptor.substring(classNameStartIndex, index); + + // Recompose the inner class name if necessary. + accumulatedClassName = isInnerClassName ? + accumulatedClassName + ClassConstants.INTERNAL_INNER_CLASS_SEPARATOR + className : + className; + + return accumulatedClassName; + } + + + /** + * Returns whether the most recently returned class name was a recomposed + * inner class name from a signature. + */ + public boolean isInnerClassName() + { + return isInnerClassName; + } + + + /** + * A main method for testing the class name enumeration. + */ + public static void main(String[] args) + { + try + { + for (int index = 0; index < args.length; index++) + { + String descriptor = args[index]; + + System.out.println("Descriptor ["+descriptor+"]"); + DescriptorClassEnumeration enumeration = new DescriptorClassEnumeration(descriptor); + System.out.println(" Fluff: ["+enumeration.nextFluff()+"]"); + while (enumeration.hasMoreClassNames()) + { + System.out.println(" Name: ["+enumeration.nextClassName()+"]"); + System.out.println(" Fluff: ["+enumeration.nextFluff()+"]"); + } + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/classfile/util/DynamicClassReferenceInitializer.java b/src/proguard/classfile/util/DynamicClassReferenceInitializer.java new file mode 100644 index 0000000..09ffdd0 --- /dev/null +++ b/src/proguard/classfile/util/DynamicClassReferenceInitializer.java @@ -0,0 +1,478 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.util.StringMatcher; + +/** + * This InstructionVisitor initializes any constant Class.forName or + * .class references of all classes it visits. More specifically, + * it fills out the references of string constant pool entries that refer to a + * class in the program class pool or in the library class pool. + *

    + * It optionally prints notes if on usage of + * (SomeClass)Class.forName(variable).newInstance(). + *

    + * The class hierarchy must be initialized before using this visitor. + * + * @see ClassSuperHierarchyInitializer + * + * @author Eric Lafortune + */ +public class DynamicClassReferenceInitializer +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + AttributeVisitor +{ + public static final int X = InstructionSequenceMatcher.X; + public static final int Y = InstructionSequenceMatcher.Y; + public static final int Z = InstructionSequenceMatcher.Z; + + public static final int A = InstructionSequenceMatcher.A; + public static final int B = InstructionSequenceMatcher.B; + public static final int C = InstructionSequenceMatcher.C; + public static final int D = InstructionSequenceMatcher.D; + + + private final Constant[] CLASS_FOR_NAME_CONSTANTS = new Constant[] + { + // 0 + new MethodrefConstant(1, 2, null, null), + new ClassConstant(3, null), + new NameAndTypeConstant(4, 5), + new Utf8Constant(ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_CLASS_FOR_NAME), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_CLASS_FOR_NAME), + + // 6 + new MethodrefConstant(1, 7, null, null), + new NameAndTypeConstant(8, 9), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_NEW_INSTANCE), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_NEW_INSTANCE), + + // 10 + new MethodrefConstant(1, 11, null, null), + new NameAndTypeConstant(12, 13), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_CLASS_GET_COMPONENT_TYPE), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_CLASS_GET_COMPONENT_TYPE), + }; + + // Class.forName("SomeClass"). + private final Instruction[] CONSTANT_CLASS_FOR_NAME_INSTRUCTIONS = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + }; + + // (SomeClass)Class.forName(someName).newInstance(). + private final Instruction[] CLASS_FOR_NAME_CAST_INSTRUCTIONS = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 6), + new ConstantInstruction(InstructionConstants.OP_CHECKCAST, X), + }; + + +// private Constant[] DOT_CLASS_JAVAC_CONSTANTS = new Constant[] +// { +// new MethodrefConstant(A, 1, null, null), +// new NameAndTypeConstant(2, 3), +// new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_DOT_CLASS_JAVAC), +// new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_DOT_CLASS_JAVAC), +// }; + + private final Constant[] DOT_CLASS_JAVAC_CONSTANTS = new Constant[] + { + new MethodrefConstant(A, 1, null, null), + new NameAndTypeConstant(B, 2), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_DOT_CLASS_JAVAC), + }; + + // SomeClass.class = class$("SomeClass") (javac). + private final Instruction[] DOT_CLASS_JAVAC_INSTRUCTIONS = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + }; + + +// private Constant[] DOT_CLASS_JIKES_CONSTANTS = new Constant[] +// { +// new MethodrefConstant(A, 1, null, null), +// new NameAndTypeConstant(2, 3), +// new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_DOT_CLASS_JIKES), +// new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_DOT_CLASS_JIKES), +// }; + + private final Constant[] DOT_CLASS_JIKES_CONSTANTS = new Constant[] + { + new MethodrefConstant(A, 1, null, null), + new NameAndTypeConstant(B, 2), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_DOT_CLASS_JIKES), + }; + + // SomeClass.class = class("SomeClass", false) (jikes). + private final Instruction[] DOT_CLASS_JIKES_INSTRUCTIONS = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + }; + + // return Class.forName(v0). + private final Instruction[] DOT_CLASS_JAVAC_IMPLEMENTATION_INSTRUCTIONS = new Instruction[] + { + new VariableInstruction(InstructionConstants.OP_ALOAD_0), + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + new SimpleInstruction(InstructionConstants.OP_ARETURN), + }; + + // return Class.forName(v0), if (!v1) .getComponentType(). + private final Instruction[] DOT_CLASS_JIKES_IMPLEMENTATION_INSTRUCTIONS = new Instruction[] + { + new VariableInstruction(InstructionConstants.OP_ALOAD_0), + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + new VariableInstruction(InstructionConstants.OP_ALOAD_1), + new BranchInstruction(InstructionConstants.OP_IFNE, +6), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 10), + new SimpleInstruction(InstructionConstants.OP_ARETURN), + }; + + // return Class.forName(v0).getComponentType(). + private final Instruction[] DOT_CLASS_JIKES_IMPLEMENTATION_INSTRUCTIONS2 = new Instruction[] + { + new VariableInstruction(InstructionConstants.OP_ALOAD_0), + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, 0), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 10), + new SimpleInstruction(InstructionConstants.OP_ARETURN), + }; + + + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + private final WarningPrinter missingNotePrinter; + private final WarningPrinter dependencyWarningPrinter; + private final WarningPrinter notePrinter; + private final StringMatcher noteExceptionMatcher; + + + private final InstructionSequenceMatcher constantClassForNameMatcher = + new InstructionSequenceMatcher(CLASS_FOR_NAME_CONSTANTS, + CONSTANT_CLASS_FOR_NAME_INSTRUCTIONS); + + private final InstructionSequenceMatcher classForNameCastMatcher = + new InstructionSequenceMatcher(CLASS_FOR_NAME_CONSTANTS, + CLASS_FOR_NAME_CAST_INSTRUCTIONS); + + private final InstructionSequenceMatcher dotClassJavacMatcher = + new InstructionSequenceMatcher(DOT_CLASS_JAVAC_CONSTANTS, + DOT_CLASS_JAVAC_INSTRUCTIONS); + + private final InstructionSequenceMatcher dotClassJikesMatcher = + new InstructionSequenceMatcher(DOT_CLASS_JIKES_CONSTANTS, + DOT_CLASS_JIKES_INSTRUCTIONS); + + private final InstructionSequenceMatcher dotClassJavacImplementationMatcher = + new InstructionSequenceMatcher(CLASS_FOR_NAME_CONSTANTS, + DOT_CLASS_JAVAC_IMPLEMENTATION_INSTRUCTIONS); + + private final InstructionSequenceMatcher dotClassJikesImplementationMatcher = + new InstructionSequenceMatcher(CLASS_FOR_NAME_CONSTANTS, + DOT_CLASS_JIKES_IMPLEMENTATION_INSTRUCTIONS); + + private final InstructionSequenceMatcher dotClassJikesImplementationMatcher2 = + new InstructionSequenceMatcher(CLASS_FOR_NAME_CONSTANTS, + DOT_CLASS_JIKES_IMPLEMENTATION_INSTRUCTIONS2); + + + // A field acting as a return variable for the visitors. + private boolean isClassForNameInvocation; + + + /** + * Creates a new DynamicClassReferenceInitializer that optionally prints + * warnings and notes, with optional class specifications for which never + * to print notes. + */ + public DynamicClassReferenceInitializer(ClassPool programClassPool, + ClassPool libraryClassPool, + WarningPrinter missingNotePrinter, + WarningPrinter dependencyWarningPrinter, + WarningPrinter notePrinter, + StringMatcher noteExceptionMatcher) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + this.missingNotePrinter = missingNotePrinter; + this.dependencyWarningPrinter = dependencyWarningPrinter; + this.notePrinter = notePrinter; + this.noteExceptionMatcher = noteExceptionMatcher; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Try to match the Class.forName("SomeClass") construct. + instruction.accept(clazz, method, codeAttribute, offset, + constantClassForNameMatcher); + + // Did we find a match? + if (constantClassForNameMatcher.isMatching()) + { + // Fill out the matched string constant. + clazz.constantPoolEntryAccept(constantClassForNameMatcher.matchedConstantIndex(X), this); + + // Don't look for the dynamic construct. + classForNameCastMatcher.reset(); + } + + // Try to match the (SomeClass)Class.forName(someName).newInstance() + // construct. + instruction.accept(clazz, method, codeAttribute, offset, + classForNameCastMatcher); + + // Did we find a match? + if (classForNameCastMatcher.isMatching()) + { + // Print out a note about the construct. + clazz.constantPoolEntryAccept(classForNameCastMatcher.matchedConstantIndex(X), this); + } + + // Try to match the javac .class construct. + instruction.accept(clazz, method, codeAttribute, offset, + dotClassJavacMatcher); + + // Did we find a match? + if (dotClassJavacMatcher.isMatching() && + isDotClassMethodref(clazz, dotClassJavacMatcher.matchedConstantIndex(0))) + { + // Fill out the matched string constant. + clazz.constantPoolEntryAccept(dotClassJavacMatcher.matchedConstantIndex(X), this); + } + + // Try to match the jikes .class construct. + instruction.accept(clazz, method, codeAttribute, offset, + dotClassJikesMatcher); + + // Did we find a match? + if (dotClassJikesMatcher.isMatching() && + isDotClassMethodref(clazz, dotClassJikesMatcher.matchedConstantIndex(0))) + { + // Fill out the matched string constant. + clazz.constantPoolEntryAccept(dotClassJikesMatcher.matchedConstantIndex(X), this); + } + } + + + // Implementations for ConstantVisitor. + + /** + * Fills out the link to the referenced class. + */ + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Save a reference to the corresponding class. + String externalClassName = stringConstant.getString(clazz); + String internalClassName = ClassUtil.internalClassName(externalClassName); + + stringConstant.referencedClass = findClass(clazz.getName(), internalClassName); + } + + + /** + * Prints out a note about the class cast to this class, if applicable. + */ + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Print out a note about the class cast. + if (noteExceptionMatcher == null || + !noteExceptionMatcher.matches(classConstant.getName(clazz))) + { + notePrinter.print(clazz.getName(), + classConstant.getName(clazz), + "Note: " + + ClassUtil.externalClassName(clazz.getName()) + + " calls '(" + + ClassUtil.externalClassName(classConstant.getName(clazz)) + + ")Class.forName(variable).newInstance()'"); + } + } + + + /** + * Checks whether the referenced method is a .class method. + */ + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + String methodType = methodrefConstant.getType(clazz); + + // Do the method's class and type match? + if (methodType.equals(ClassConstants.INTERNAL_METHOD_TYPE_DOT_CLASS_JAVAC) || + methodType.equals(ClassConstants.INTERNAL_METHOD_TYPE_DOT_CLASS_JIKES)) + { + String methodName = methodrefConstant.getName(clazz); + + // Does the method's name match one of the special names? + isClassForNameInvocation = + methodName.equals(ClassConstants.INTERNAL_METHOD_NAME_DOT_CLASS_JAVAC) || + methodName.equals(ClassConstants.INTERNAL_METHOD_NAME_DOT_CLASS_JIKES); + + if (isClassForNameInvocation) + { + return; + } + + String className = methodrefConstant.getClassName(clazz); + + // Note that we look for the class by name, since the referenced + // class has not been initialized yet. + Clazz referencedClass = programClassPool.getClass(className); + if (referencedClass != null) + { + // Check if the code of the referenced method is .class code. + // Note that we look for the method by name and type, since the + // referenced method has not been initialized yet. + referencedClass.methodAccept(methodName, + methodType, + new AllAttributeVisitor(this)); + } + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Check whether this is class$(String), as generated by javac, or + // class(String, boolean), as generated by jikes, or an optimized + // version. + isClassForNameInvocation = + isDotClassMethodCode(clazz, method, codeAttribute, + dotClassJavacImplementationMatcher, 5) || + isDotClassMethodCode(clazz, method, codeAttribute, + dotClassJikesImplementationMatcher, 12) || + isDotClassMethodCode(clazz, method, codeAttribute, + dotClassJikesImplementationMatcher2, 8); + } + + + // Small utility methods. + + /** + * Returns whether the given method reference corresponds to a .class + * method, as generated by javac or by jikes. + */ + private boolean isDotClassMethodref(Clazz clazz, int methodrefConstantIndex) + { + isClassForNameInvocation = false; + + // Check if the code of the referenced method is .class code. + clazz.constantPoolEntryAccept(methodrefConstantIndex, this); + + return isClassForNameInvocation; + } + + + /** + * Returns whether the first whether the first instructions of the + * given code attribute match with the given instruction matcher. + */ + private boolean isDotClassMethodCode(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + InstructionSequenceMatcher codeMatcher, + int codeLength) + { + // Check the minimum code length. + if (codeAttribute.u4codeLength < codeLength) + { + return false; + } + + // Check the actual instructions. + codeMatcher.reset(); + codeAttribute.instructionsAccept(clazz, method, 0, codeLength, codeMatcher); + return codeMatcher.isMatching(); + } + + + /** + * Returns the class with the given name, either for the program class pool + * or from the library class pool, or null if it can't be found. + */ + private Clazz findClass(String referencingClassName, String name) + { + // Ignore any primitive array types. + if (ClassUtil.isInternalArrayType(name) && + !ClassUtil.isInternalClassType(name)) + { + return null; + } + + // First look for the class in the program class pool. + Clazz clazz = programClassPool.getClass(name); + + // Otherwise look for the class in the library class pool. + if (clazz == null) + { + clazz = libraryClassPool.getClass(name); + + if (clazz == null && + missingNotePrinter != null) + { + // We didn't find the superclass or interface. Print a note. + missingNotePrinter.print(referencingClassName, + name, + "Note: " + + ClassUtil.externalClassName(referencingClassName) + + ": can't find dynamically referenced class " + + ClassUtil.externalClassName(name)); + } + } + else if (dependencyWarningPrinter != null) + { + // The superclass or interface was found in the program class pool. + // Print a warning. + dependencyWarningPrinter.print(referencingClassName, + name, + "Warning: library class " + + ClassUtil.externalClassName(referencingClassName) + + " depends dynamically on program class " + + ClassUtil.externalClassName(name)); + } + + return clazz; + } +} diff --git a/src/proguard/classfile/util/DynamicMemberReferenceInitializer.java b/src/proguard/classfile/util/DynamicMemberReferenceInitializer.java new file mode 100644 index 0000000..1f57708 --- /dev/null +++ b/src/proguard/classfile/util/DynamicMemberReferenceInitializer.java @@ -0,0 +1,604 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.visitor.*; +import proguard.util.StringMatcher; + +/** + * This InstructionVisitor initializes any constant + * Class.get[Declared]{Field,Method} references of all instructions + * it visits. More specifically, it fills out the references of string constant + * pool entries that refer to a class member in the program class pool or in the + * library class pool. + *

    + * It optionally prints notes if on usage of + * (SomeClass)Class.forName(variable).newInstance(). + *

    + * The class hierarchy and references must be initialized before using this + * visitor. + * + * @see ClassSuperHierarchyInitializer + * @see ClassReferenceInitializer + * + * @author Eric Lafortune + */ +public class DynamicMemberReferenceInitializer +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + AttributeVisitor, + MemberVisitor +{ + public static final int X = InstructionSequenceMatcher.X; + public static final int Y = InstructionSequenceMatcher.Y; + public static final int Z = InstructionSequenceMatcher.Z; + + public static final int A = InstructionSequenceMatcher.A; + public static final int B = InstructionSequenceMatcher.B; + public static final int C = InstructionSequenceMatcher.C; + public static final int D = InstructionSequenceMatcher.D; + + + private final Constant[] GET_FIELD_CONSTANTS = new Constant[] + { + new MethodrefConstant(1, 2, null, null), + new ClassConstant(3, null), + new NameAndTypeConstant(4, 5), + new Utf8Constant(ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_CLASS_GET_FIELD), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_CLASS_GET_FIELD), + }; + + private final Constant[] GET_DECLARED_FIELD_CONSTANTS = new Constant[] + { + new MethodrefConstant(1, 2, null, null), + new ClassConstant(3, null), + new NameAndTypeConstant(4, 5), + new Utf8Constant(ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_CLASS_GET_DECLARED_FIELD), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_CLASS_GET_DECLARED_FIELD), + }; + + private final Constant[] GET_METHOD_CONSTANTS = new Constant[] + { + new MethodrefConstant(1, 2, null, null), + new ClassConstant(3, null), + new NameAndTypeConstant(4, 5), + new Utf8Constant(ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_CLASS_GET_METHOD), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_CLASS_GET_METHOD), + }; + + private final Constant[] GET_DECLARED_METHOD_CONSTANTS = new Constant[] + { + new MethodrefConstant(1, 2, null, null), + new ClassConstant(3, null), + new NameAndTypeConstant(4, 5), + new Utf8Constant(ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_NAME_CLASS_GET_DECLARED_METHOD), + new Utf8Constant(ClassConstants.INTERNAL_METHOD_TYPE_CLASS_GET_DECLARED_METHOD), + }; + + // SomeClass.class.get[Declared]Field("someField"). + private final Instruction[] CONSTANT_GET_FIELD_INSTRUCTIONS = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // SomeClass.class.get[Declared]Method("someMethod", new Class[] {}). + private final Instruction[] CONSTANT_GET_METHOD_INSTRUCTIONS0 = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_ANEWARRAY, 1), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // SomeClass.class.get[Declared]Method("someMethod", new Class[] { A.class }). + private final Instruction[] CONSTANT_GET_METHOD_INSTRUCTIONS1 = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new ConstantInstruction(InstructionConstants.OP_ANEWARRAY, 1), + new SimpleInstruction(InstructionConstants.OP_DUP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_AASTORE), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // SomeClass.class.get[Declared]Method("someMethod", new Class[] { A.class, B.class }). + private final Instruction[] CONSTANT_GET_METHOD_INSTRUCTIONS2 = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, X), + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new SimpleInstruction(InstructionConstants.OP_ICONST_2), + new ConstantInstruction(InstructionConstants.OP_ANEWARRAY, 1), + new SimpleInstruction(InstructionConstants.OP_DUP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_AASTORE), + new SimpleInstruction(InstructionConstants.OP_DUP), + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new ConstantInstruction(InstructionConstants.OP_LDC, B), + new SimpleInstruction(InstructionConstants.OP_AASTORE), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // get[Declared]Field("someField"). + private final Instruction[] GET_FIELD_INSTRUCTIONS = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // get[Declared]Method("someMethod", new Class[] {}). + private final Instruction[] GET_METHOD_INSTRUCTIONS0 = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_ANEWARRAY, 1), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // get[Declared]Method("someMethod", new Class[] { A.class }). + private final Instruction[] GET_METHOD_INSTRUCTIONS1 = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new ConstantInstruction(InstructionConstants.OP_ANEWARRAY, 1), + new SimpleInstruction(InstructionConstants.OP_DUP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_AASTORE), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + // get[Declared]Method("someMethod", new Class[] { A.class, B.class }). + private final Instruction[] GET_METHOD_INSTRUCTIONS2 = new Instruction[] + { + new ConstantInstruction(InstructionConstants.OP_LDC, Y), + new SimpleInstruction(InstructionConstants.OP_ICONST_2), + new ConstantInstruction(InstructionConstants.OP_ANEWARRAY, 1), + new SimpleInstruction(InstructionConstants.OP_DUP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_AASTORE), + new SimpleInstruction(InstructionConstants.OP_DUP), + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new ConstantInstruction(InstructionConstants.OP_LDC, B), + new SimpleInstruction(InstructionConstants.OP_AASTORE), + new ConstantInstruction(InstructionConstants.OP_INVOKEVIRTUAL, 0), + }; + + + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + private final WarningPrinter notePrinter; + private final StringMatcher noteFieldExceptionMatcher; + private final StringMatcher noteMethodExceptionMatcher; + + + private final InstructionSequenceMatcher constantGetFieldMatcher = + new InstructionSequenceMatcher(GET_FIELD_CONSTANTS, + CONSTANT_GET_FIELD_INSTRUCTIONS); + + private final InstructionSequenceMatcher constantGetDeclaredFieldMatcher = + new InstructionSequenceMatcher(GET_DECLARED_FIELD_CONSTANTS, + CONSTANT_GET_FIELD_INSTRUCTIONS); + + private final InstructionSequenceMatcher constantGetMethodMatcher0 = + new InstructionSequenceMatcher(GET_METHOD_CONSTANTS, + CONSTANT_GET_METHOD_INSTRUCTIONS0); + + private final InstructionSequenceMatcher constantGetDeclaredMethodMatcher0 = + new InstructionSequenceMatcher(GET_DECLARED_METHOD_CONSTANTS, + CONSTANT_GET_METHOD_INSTRUCTIONS0); + + private final InstructionSequenceMatcher constantGetMethodMatcher1 = + new InstructionSequenceMatcher(GET_METHOD_CONSTANTS, + CONSTANT_GET_METHOD_INSTRUCTIONS1); + + private final InstructionSequenceMatcher constantGetDeclaredMethodMatcher1 = + new InstructionSequenceMatcher(GET_DECLARED_METHOD_CONSTANTS, + CONSTANT_GET_METHOD_INSTRUCTIONS1); + + private final InstructionSequenceMatcher constantGetMethodMatcher2 = + new InstructionSequenceMatcher(GET_METHOD_CONSTANTS, + CONSTANT_GET_METHOD_INSTRUCTIONS2); + + private final InstructionSequenceMatcher constantGetDeclaredMethodMatcher2 = + new InstructionSequenceMatcher(GET_DECLARED_METHOD_CONSTANTS, + CONSTANT_GET_METHOD_INSTRUCTIONS2); + + private final InstructionSequenceMatcher getFieldMatcher = + new InstructionSequenceMatcher(GET_FIELD_CONSTANTS, + GET_FIELD_INSTRUCTIONS); + + private final InstructionSequenceMatcher getDeclaredFieldMatcher = + new InstructionSequenceMatcher(GET_DECLARED_FIELD_CONSTANTS, + GET_FIELD_INSTRUCTIONS); + + private final InstructionSequenceMatcher getMethodMatcher0 = + new InstructionSequenceMatcher(GET_METHOD_CONSTANTS, + GET_METHOD_INSTRUCTIONS0); + + private final InstructionSequenceMatcher getDeclaredMethodMatcher0 = + new InstructionSequenceMatcher(GET_DECLARED_METHOD_CONSTANTS, + GET_METHOD_INSTRUCTIONS0); + + private final InstructionSequenceMatcher getMethodMatcher1 = + new InstructionSequenceMatcher(GET_METHOD_CONSTANTS, + GET_METHOD_INSTRUCTIONS1); + + private final InstructionSequenceMatcher getDeclaredMethodMatcher1 = + new InstructionSequenceMatcher(GET_DECLARED_METHOD_CONSTANTS, + GET_METHOD_INSTRUCTIONS1); + + private final InstructionSequenceMatcher getMethodMatcher2 = + new InstructionSequenceMatcher(GET_METHOD_CONSTANTS, + GET_METHOD_INSTRUCTIONS2); + + private final InstructionSequenceMatcher getDeclaredMethodMatcher2 = + new InstructionSequenceMatcher(GET_DECLARED_METHOD_CONSTANTS, + GET_METHOD_INSTRUCTIONS2); + + private final MemberFinder memberFinder = new MemberFinder(); + + + // Fields acting as parameters for the visitors. + private Clazz referencedClass; + private boolean isDeclared; + private boolean isField; + + + + /** + * Creates a new DynamicMemberReferenceInitializer. + */ + public DynamicMemberReferenceInitializer(ClassPool programClassPool, + ClassPool libraryClassPool, + WarningPrinter notePrinter, + StringMatcher noteFieldExceptionMatcher, + StringMatcher noteMethodExceptionMatcher) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + this.notePrinter = notePrinter; + this.noteFieldExceptionMatcher = noteFieldExceptionMatcher; + this.noteMethodExceptionMatcher = noteMethodExceptionMatcher; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Try to match the SomeClass.class.getField("someField") construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetFieldMatcher, + getFieldMatcher, true, false); + + // Try to match the SomeClass.class.getDeclaredField("someField") construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetDeclaredFieldMatcher, + getDeclaredFieldMatcher, true, true); + + // Try to match the SomeClass.class.getMethod("someMethod", new Class[] + // {}) construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetMethodMatcher0, + getMethodMatcher0, false, false); + + // Try to match the SomeClass.class.getDeclaredMethod("someMethod", + // new Class[] {}) construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetDeclaredMethodMatcher0, + getDeclaredMethodMatcher0, false, true); + + // Try to match the SomeClass.class.getMethod("someMethod", new Class[] + // { A.class }) construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetMethodMatcher1, + getMethodMatcher1, false, false); + + // Try to match the SomeClass.class.getDeclaredMethod("someMethod", + // new Class[] { A.class }) construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetDeclaredMethodMatcher1, + getDeclaredMethodMatcher1, false, true); + + // Try to match the SomeClass.class.getMethod("someMethod", new Class[] + // { A.class, B.class }) construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetMethodMatcher2, + getMethodMatcher2, false, false); + + // Try to match the SomeClass.class.getDeclaredMethod("someMethod", + // new Class[] { A.class, B.class }) construct. + matchGetMember(clazz, method, codeAttribute, offset, instruction, + constantGetDeclaredMethodMatcher2, + getDeclaredMethodMatcher2, false, true); + } + + + /** + * Tries to match the next instruction and fills out the string constant + * or prints out a note accordingly. + */ + private void matchGetMember(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int offset, + Instruction instruction, + InstructionSequenceMatcher constantSequenceMatcher, + InstructionSequenceMatcher variableSequenceMatcher, + boolean isField, + boolean isDeclared) + { + // Try to match the next instruction in the constant sequence. + instruction.accept(clazz, method, codeAttribute, offset, + constantSequenceMatcher); + + // Did we find a match to fill out the string constant? + if (constantSequenceMatcher.isMatching()) + { + this.isField = isField; + this.isDeclared = isDeclared; + + // Get the member's class. + clazz.constantPoolEntryAccept(constantSequenceMatcher.matchedConstantIndex(X), this); + + // Fill out the matched string constant. + clazz.constantPoolEntryAccept(constantSequenceMatcher.matchedConstantIndex(Y), this); + + // Don't look for the dynamic construct. + variableSequenceMatcher.reset(); + } + + // Try to match the next instruction in the variable sequence. + instruction.accept(clazz, method, codeAttribute, offset, + variableSequenceMatcher); + + // Did we find a match to print out a note? + if (variableSequenceMatcher.isMatching()) + { + // Print out a note about the dynamic invocation. + printDynamicInvocationNote(clazz, + variableSequenceMatcher, + isField, + isDeclared); + } + } + + + // Implementations for ConstantVisitor. + + /** + * Remembers the referenced class. + */ + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Remember the referenced class. + referencedClass = ClassUtil.isInternalArrayType(classConstant.getName(clazz)) ? + null : + classConstant.referencedClass; + } + + + /** + * Fills out the link to the referenced class member. + */ + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + if (referencedClass != null) + { + String name = stringConstant.getString(clazz); + + // See if we can find the referenced class member locally, or + // somewhere in the hierarchy. + Member referencedMember = isDeclared ? isField ? + (Member)referencedClass.findField(name, null) : + (Member)referencedClass.findMethod(name, null) : + (Member)memberFinder.findMember(clazz, + referencedClass, + name, + null, + isField); + if (referencedMember != null) + { + stringConstant.referencedMember = referencedMember; + stringConstant.referencedClass = isDeclared ? + referencedClass : + memberFinder.correspondingClass(); + } + } + } + + + // Small utility methods. + + /** + * Prints out a note on the matched dynamic invocation, if necessary. + */ + private void printDynamicInvocationNote(Clazz clazz, + InstructionSequenceMatcher noteSequenceMatcher, + boolean isField, + boolean isDeclared) + { + // Print out a note about the dynamic invocation. + if (notePrinter != null && + notePrinter.accepts(clazz.getName())) + { + // Is the class member name in the list of exceptions? + StringMatcher noteExceptionMatcher = isField ? + noteFieldExceptionMatcher : + noteMethodExceptionMatcher; + + int memberNameIndex = noteSequenceMatcher.matchedConstantIndex(Y); + String memberName = clazz.getStringString(memberNameIndex); + + if (noteExceptionMatcher == null || + !noteExceptionMatcher.matches(memberName)) + { + // Compose the external member name and partial descriptor. + String externalMemberDescription = memberName; + + if (!isField) + { + externalMemberDescription += '('; + for (int count = 0; count < 2; count++) + { + int memberArgumentIndex = noteSequenceMatcher.matchedConstantIndex(A + count); + if (memberArgumentIndex > 0) + { + if (count > 0) + { + externalMemberDescription += ','; + } + String className = clazz.getClassName(memberArgumentIndex); + externalMemberDescription += ClassUtil.isInternalArrayType(className) ? + ClassUtil.externalType(className) : + ClassUtil.externalClassName(className); + } + } + externalMemberDescription += ')'; + } + + // Print out the actual note. + notePrinter.print(clazz.getName(), + "Note: " + + ClassUtil.externalClassName(clazz.getName()) + + " accesses a " + + (isDeclared ? "declared " : "") + + (isField ? "field" : "method") + + " '" + + externalMemberDescription + + "' dynamically"); + + // Print out notes about potential candidates. + ClassVisitor classVisitor; + + if (isField) + { + classVisitor = + new AllFieldVisitor( + new MemberNameFilter(memberName, this)); + } + else + { + // Compose the partial method descriptor. + String methodDescriptor = "("; + for (int count = 0; count < 2; count++) + { + int memberArgumentIndex = noteSequenceMatcher.matchedConstantIndex(A + count); + if (memberArgumentIndex > 0) + { + if (count > 0) + { + methodDescriptor += ','; + } + String className = clazz.getClassName(memberArgumentIndex); + methodDescriptor += ClassUtil.isInternalArrayType(className) ? + className : + ClassUtil.internalTypeFromClassName(className); + } + } + methodDescriptor += ")L///;"; + + classVisitor = + new AllMethodVisitor( + new MemberNameFilter(memberName, + new MemberDescriptorFilter(methodDescriptor, this))); + } + + programClassPool.classesAcceptAlphabetically(classVisitor); + libraryClassPool.classesAcceptAlphabetically(classVisitor); + } + } + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (notePrinter.accepts(programClass.getName())) + { + System.out.println(" Maybe this is program field '" + + ClassUtil.externalFullClassDescription(0, programClass.getName()) + + " { " + + ClassUtil.externalFullFieldDescription(0, programField.getName(programClass), programField.getDescriptor(programClass)) + + "; }'"); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (notePrinter.accepts(programClass.getName())) + { + System.out.println(" Maybe this is program method '" + + ClassUtil.externalFullClassDescription(0, programClass.getName()) + + " { " + + ClassUtil.externalFullMethodDescription(null, 0, programMethod.getName(programClass), programMethod.getDescriptor(programClass)) + + "; }'"); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (notePrinter.accepts(libraryClass.getName())) + { + System.out.println(" Maybe this is library field '" + + ClassUtil.externalFullClassDescription(0, libraryClass.getName()) + + " { " + + ClassUtil.externalFullFieldDescription(0, libraryField.getName(libraryClass), libraryField.getDescriptor(libraryClass)) + + "; }'"); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (notePrinter.accepts(libraryClass.getName())) + { + System.out.println(" Maybe this is library method '" + + ClassUtil.externalFullClassDescription(0, libraryClass.getName()) + + " { " + + ClassUtil.externalFullMethodDescription(null, 0, libraryMethod.getName(libraryClass), libraryMethod.getDescriptor(libraryClass)) + + "; }'"); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/util/ExternalTypeEnumeration.java b/src/proguard/classfile/util/ExternalTypeEnumeration.java new file mode 100644 index 0000000..6371888 --- /dev/null +++ b/src/proguard/classfile/util/ExternalTypeEnumeration.java @@ -0,0 +1,106 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.ClassConstants; + + +/** + * An ExternalTypeEnumeration provides an enumeration of all + * types listed in a given external descriptor string. The method name can + * be retrieved separately. + *

    + * A ExternalTypeEnumeration object can be reused for processing + * different subsequent descriptors, by means of the setDescriptor + * method. + * + * @author Eric Lafortune + */ +public class ExternalTypeEnumeration +{ + private String descriptor; + private int index; + + + public ExternalTypeEnumeration(String descriptor) + { + setDescriptor(descriptor); + } + + + ExternalTypeEnumeration() + { + } + + + void setDescriptor(String descriptor) + { + this.descriptor = descriptor; + + reset(); + } + + + public void reset() + { + index = descriptor.indexOf(ClassConstants.EXTERNAL_METHOD_ARGUMENTS_OPEN) + 1; + + if (index < 1) + { + throw new IllegalArgumentException("Missing opening parenthesis in descriptor ["+descriptor+"]"); + } + } + + + public boolean hasMoreTypes() + { + return index < descriptor.length() - 1; + } + + + public String nextType() + { + int startIndex = index; + + // Find the next separating comma. + index = descriptor.indexOf(ClassConstants.EXTERNAL_METHOD_ARGUMENTS_SEPARATOR, + startIndex); + + // Otherwise find the closing parenthesis. + if (index < 0) + { + index = descriptor.indexOf(ClassConstants.EXTERNAL_METHOD_ARGUMENTS_CLOSE, + startIndex); + if (index < 0) + { + throw new IllegalArgumentException("Missing closing parenthesis in descriptor ["+descriptor+"]"); + } + } + + return descriptor.substring(startIndex, index++).trim(); + } + + + public String methodName() + { + return descriptor.substring(0, descriptor.indexOf(ClassConstants.EXTERNAL_METHOD_ARGUMENTS_OPEN)).trim(); + } +} diff --git a/src/proguard/classfile/util/InstructionSequenceMatcher.java b/src/proguard/classfile/util/InstructionSequenceMatcher.java new file mode 100644 index 0000000..8a689d5 --- /dev/null +++ b/src/proguard/classfile/util/InstructionSequenceMatcher.java @@ -0,0 +1,634 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; + +/** + * This InstructionVisitor checks whether a given pattern instruction sequence + * occurs in the instructions that are visited. The arguments of the + * instruction sequence can be wildcards that are matched. + * + * @author Eric Lafortune + */ +public class InstructionSequenceMatcher +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor +{ + /* + private static boolean DEBUG = false; + public static boolean DEBUG_MORE = false; + /*/ + private static final boolean DEBUG = false; + private static final boolean DEBUG_MORE = false; + //*/ + + public static final int X = 0x40000000; + public static final int Y = 0x40000001; + public static final int Z = 0x40000002; + + public static final int A = 0x40000003; + public static final int B = 0x40000004; + public static final int C = 0x40000005; + public static final int D = 0x40000006; + + + private final Constant[] patternConstants; + private final Instruction[] patternInstructions; + + private boolean matching; + private boolean matchingAnyWildCards; + private int patternInstructionIndex; + private final int[] matchedInstructionOffsets; + private int matchedArgumentFlags; + private final int[] matchedArguments = new int[7]; + private long matchedConstantFlags; + private final int[] matchedConstantIndices; + + // Fields acting as a parameter and a return value for visitor methods. + private Constant patternConstant; + private boolean matchingConstant; + + + /** + * Creates a new InstructionSequenceMatcher. + * @param patternConstants any constants referenced by the pattern + * instruction. + * @param patternInstructions the pattern instruction sequence. + */ + public InstructionSequenceMatcher(Constant[] patternConstants, + Instruction[] patternInstructions) + { + this.patternConstants = patternConstants; + this.patternInstructions = patternInstructions; + + matchedInstructionOffsets = new int[patternInstructions.length]; + matchedConstantIndices = new int[patternConstants.length]; + } + + + /** + * Starts matching from the first instruction again next time. + */ + public void reset() + { + patternInstructionIndex = 0; + matchedArgumentFlags = 0; + matchedConstantFlags = 0L; + } + + + public boolean isMatching() + { + return matching; + } + + + public boolean isMatchingAnyWildcards() + { + return matchingAnyWildCards; + } + + + public int instructionCount() + { + return patternInstructions.length; + } + + + public int matchedInstructionOffset(int index) + { + return matchedInstructionOffsets[index]; + } + + + public int matchedArgument(int argument) + { + int argumentIndex = argument - X; + return argumentIndex < 0 ? + argument : + matchedArguments[argumentIndex]; + } + + + public int[] matchedArguments(int[] arguments) + { + int[] matchedArguments = new int[arguments.length]; + + for (int index = 0; index < arguments.length; index++) + { + matchedArguments[index] = matchedArgument(arguments[index]); + } + + return matchedArguments; + } + + + public int matchedConstantIndex(int constantIndex) + { + int argumentIndex = constantIndex - X; + return argumentIndex < 0 ? + matchedConstantIndices[constantIndex] : + matchedArguments[argumentIndex]; + } + + + public int matchedBranchOffset(int offset, int branchOffset) + { + int argumentIndex = branchOffset - X; + return argumentIndex < 0 ? + branchOffset : + matchedArguments[argumentIndex] - offset; + } + + + public int[] matchedJumpOffsets(int offset, int[] jumpOffsets) + { + int[] matchedJumpOffsets = new int[jumpOffsets.length]; + + for (int index = 0; index < jumpOffsets.length; index++) + { + matchedJumpOffsets[index] = matchedBranchOffset(offset, + jumpOffsets[index]); + } + + return matchedJumpOffsets; + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + Instruction patternInstruction = patternInstructions[patternInstructionIndex]; + + // Check if the instruction matches the next instruction in the sequence. + boolean condition = + matchingOpcodes(simpleInstruction, patternInstruction) && + matchingArguments(simpleInstruction.constant, + ((SimpleInstruction)patternInstruction).constant); + + // Check if the instruction sequence is matching now. + checkMatch(condition, + clazz, + method, + codeAttribute, + offset, + simpleInstruction); + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + Instruction patternInstruction = patternInstructions[patternInstructionIndex]; + + // Check if the instruction matches the next instruction in the sequence. + boolean condition = + matchingOpcodes(variableInstruction, patternInstruction) && + matchingArguments(variableInstruction.variableIndex, + ((VariableInstruction)patternInstruction).variableIndex) && + matchingArguments(variableInstruction.constant, + ((VariableInstruction)patternInstruction).constant); + + // Check if the instruction sequence is matching now. + checkMatch(condition, + clazz, + method, + codeAttribute, + offset, + variableInstruction); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + Instruction patternInstruction = patternInstructions[patternInstructionIndex]; + + // Check if the instruction matches the next instruction in the sequence. + boolean condition = + matchingOpcodes(constantInstruction, patternInstruction) && + matchingConstantIndices(clazz, + constantInstruction.constantIndex, + ((ConstantInstruction)patternInstruction).constantIndex) && + matchingArguments(constantInstruction.constant, + ((ConstantInstruction)patternInstruction).constant); + + // Check if the instruction sequence is matching now. + checkMatch(condition, + clazz, + method, + codeAttribute, + offset, + constantInstruction); + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + Instruction patternInstruction = patternInstructions[patternInstructionIndex]; + + // Check if the instruction matches the next instruction in the from + // sequence. + boolean condition = + matchingOpcodes(branchInstruction, patternInstruction) && + matchingBranchOffsets(offset, + branchInstruction.branchOffset, + ((BranchInstruction)patternInstruction).branchOffset); + + // Check if the instruction sequence is matching now. + checkMatch(condition, + clazz, + method, + codeAttribute, + offset, + branchInstruction); + } + + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + Instruction patternInstruction = patternInstructions[patternInstructionIndex]; + + // Check if the instruction matches the next instruction in the sequence. + boolean condition = + matchingOpcodes(tableSwitchInstruction, patternInstruction) && + matchingBranchOffsets(offset, + tableSwitchInstruction.defaultOffset, + ((TableSwitchInstruction)patternInstruction).defaultOffset) && + matchingArguments(tableSwitchInstruction.lowCase, + ((TableSwitchInstruction)patternInstruction).lowCase) && + matchingArguments(tableSwitchInstruction.highCase, + ((TableSwitchInstruction)patternInstruction).highCase) && + matchingJumpOffsets(offset, + tableSwitchInstruction.jumpOffsets, + ((TableSwitchInstruction)patternInstruction).jumpOffsets); + + // Check if the instruction sequence is matching now. + checkMatch(condition, + clazz, + method, + codeAttribute, + offset, + tableSwitchInstruction); + } + + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + Instruction patternInstruction = patternInstructions[patternInstructionIndex]; + + // Check if the instruction matches the next instruction in the sequence. + boolean condition = + matchingOpcodes(lookUpSwitchInstruction, patternInstruction) && + matchingBranchOffsets(offset, + lookUpSwitchInstruction.defaultOffset, + ((LookUpSwitchInstruction)patternInstruction).defaultOffset) && + matchingArguments(lookUpSwitchInstruction.cases, + ((LookUpSwitchInstruction)patternInstruction).cases) && + matchingJumpOffsets(offset, + lookUpSwitchInstruction.jumpOffsets, + ((LookUpSwitchInstruction)patternInstruction).jumpOffsets); + + // Check if the instruction sequence is matching now. + checkMatch(condition, + clazz, + method, + codeAttribute, + offset, + lookUpSwitchInstruction); + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + IntegerConstant integerPatternConstant = (IntegerConstant)patternConstant; + + // Compare the integer values. + matchingConstant = integerConstant.getValue() == + integerPatternConstant.getValue(); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + LongConstant longPatternConstant = (LongConstant)patternConstant; + + // Compare the long values. + matchingConstant = longConstant.getValue() == + longPatternConstant.getValue(); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + FloatConstant floatPatternConstant = (FloatConstant)patternConstant; + + // Compare the float values. + matchingConstant = floatConstant.getValue() == + floatPatternConstant.getValue(); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + DoubleConstant doublePatternConstant = (DoubleConstant)patternConstant; + + // Compare the double values. + matchingConstant = doubleConstant.getValue() == + doublePatternConstant.getValue(); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + StringConstant stringPatternConstant = (StringConstant)patternConstant; + + // Check the UTF-8 constant. + matchingConstant = + matchingConstantIndices(clazz, + stringConstant.u2stringIndex, + stringPatternConstant.u2stringIndex); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + Utf8Constant utf8PatternConstant = (Utf8Constant)patternConstant; + + // Compare the actual strings. + matchingConstant = utf8Constant.getString().equals( + utf8PatternConstant.getString()); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + RefConstant refPatternConstant = (RefConstant)patternConstant; + + // Check the class and the name and type. + matchingConstant = + matchingConstantIndices(clazz, + refConstant.getClassIndex(), + refPatternConstant.getClassIndex()) && + matchingConstantIndices(clazz, + refConstant.getNameAndTypeIndex(), + refPatternConstant.getNameAndTypeIndex()); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + ClassConstant classPatternConstant = (ClassConstant)patternConstant; + + // Check the class name. + matchingConstant = + matchingConstantIndices(clazz, + classConstant.u2nameIndex, + classPatternConstant.u2nameIndex); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + NameAndTypeConstant typePatternConstant = (NameAndTypeConstant)patternConstant; + + // Check the name and the descriptor. + matchingConstant = + matchingConstantIndices(clazz, + nameAndTypeConstant.u2nameIndex, + typePatternConstant.u2nameIndex) && + matchingConstantIndices(clazz, + nameAndTypeConstant.u2descriptorIndex, + typePatternConstant.u2descriptorIndex); + } + + + // Small utility methods. + + private boolean matchingOpcodes(Instruction instruction1, + Instruction instruction2) + { + // Check the opcode. + return instruction1.opcode == instruction2.opcode || + instruction1.canonicalOpcode() == instruction2.opcode; + } + + + private boolean matchingArguments(int argument1, + int argument2) + { + int argumentIndex = argument2 - X; + if (argumentIndex < 0) + { + // Check the literal argument. + return argument1 == argument2; + } + else if ((matchedArgumentFlags & (1 << argumentIndex)) == 0) + { + // Store a wildcard argument. + matchedArguments[argumentIndex] = argument1; + matchedArgumentFlags |= 1 << argumentIndex; + + return true; + } + else + { + // Check the previously stored wildcard argument. + return matchedArguments[argumentIndex] == argument1; + } + } + + + private boolean matchingArguments(int[] arguments1, + int[] arguments2) + { + if (arguments1.length != arguments2.length) + { + return false; + } + + for (int index = 0; index < arguments1.length; index++) + { + if (!matchingArguments(arguments1[index], arguments2[index])) + { + return false; + } + } + + return true; + } + + + private boolean matchingConstantIndices(Clazz clazz, + int constantIndex1, + int constantIndex2) + { + if (constantIndex2 >= X) + { + // Check the constant index. + return matchingArguments(constantIndex1, constantIndex2); + } + else if ((matchedConstantFlags & (1L << constantIndex2)) == 0) + { + // Check the actual constant. + matchingConstant = false; + patternConstant = patternConstants[constantIndex2]; + + if (clazz.getTag(constantIndex1) == patternConstant.getTag()) + { + clazz.constantPoolEntryAccept(constantIndex1, this); + + if (matchingConstant) + { + // Store the constant index. + matchedConstantIndices[constantIndex2] = constantIndex1; + matchedConstantFlags |= 1L << constantIndex2; + } + } + + return matchingConstant; + } + else + { + // Check a previously stored constant index. + return matchedConstantIndices[constantIndex2] == constantIndex1; + } + } + + + private boolean matchingBranchOffsets(int offset, + int branchOffset1, + int branchOffset2) + { + int argumentIndex = branchOffset2 - X; + if (argumentIndex < 0) + { + // Check the literal argument. + return branchOffset1 == branchOffset2; + } + else if ((matchedArgumentFlags & (1 << argumentIndex)) == 0) + { + // Store a wildcard argument. + matchedArguments[argumentIndex] = offset + branchOffset1; + matchedArgumentFlags |= 1 << argumentIndex; + + return true; + } + else + { + // Check the previously stored wildcard argument. + return matchedArguments[argumentIndex] == offset + branchOffset1; + } + } + + + private boolean matchingJumpOffsets(int offset, + int[] jumpOffsets1, + int[] jumpOffsets2) + { + if (jumpOffsets1.length != jumpOffsets2.length) + { + return false; + } + + for (int index = 0; index < jumpOffsets1.length; index++) + { + if (!matchingBranchOffsets(offset, + jumpOffsets1[index], + jumpOffsets2[index])) + { + return false; + } + } + + return true; + } + + + private void checkMatch(boolean condition, + Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int offset, + Instruction instruction) + { + if (DEBUG_MORE) + { + System.out.println("InstructionSequenceMatcher: ["+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"]: "+patternInstructions[patternInstructionIndex].toString(patternInstructionIndex)+(condition?"\t== ":"\t ")+instruction.toString(offset)); + } + + // Did the instruction match? + if (condition) + { + // Remember the offset of the matching instruction. + matchedInstructionOffsets[patternInstructionIndex] = offset; + + // Try to match the next instruction next time. + patternInstructionIndex++; + + // Did we match all instructions in the sequence? + matching = patternInstructionIndex == patternInstructions.length; + + // Did we match any wildcards along the way? + matchingAnyWildCards = matchedArgumentFlags != 0; + + if (matching) + { + if (DEBUG) + { + System.out.println("InstructionSequenceMatcher: ["+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + for (int index = 0; index < patternInstructionIndex; index++) + { + System.out.println(" "+InstructionFactory.create(codeAttribute.code, matchedInstructionOffsets[index]).toString(matchedInstructionOffsets[index])); + } + } + + // Start matching from the first instruction again next time. + reset(); + } + } + else + { + // The instruction didn't match. + matching = false; + + // Is this a failed second instruction? + boolean retry = patternInstructionIndex == 1; + + // Start matching from the first instruction next time. + reset(); + + // Retry a failed second instruction as a first instruction. + if (retry) + { + instruction.accept(clazz, method, codeAttribute, offset, this); + } + } + } +} diff --git a/src/proguard/classfile/util/InternalTypeEnumeration.java b/src/proguard/classfile/util/InternalTypeEnumeration.java new file mode 100644 index 0000000..76f7e84 --- /dev/null +++ b/src/proguard/classfile/util/InternalTypeEnumeration.java @@ -0,0 +1,204 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.ClassConstants; + + +/** + * An InternalTypeEnumeration provides an enumeration of all + * parameter types listed in a given internal method descriptor or signature. + * The signature can also be a class signature. The return type of a method + * descriptor can retrieved separately. + * + * @author Eric Lafortune + */ +public class InternalTypeEnumeration +{ + private String descriptor; + private int firstIndex; + private int lastIndex; + private int index; + + + /** + * Creates a new InternalTypeEnumeration for the given method descriptor. + */ + public InternalTypeEnumeration(String descriptor) + { + this.descriptor = descriptor; + this.firstIndex = descriptor.indexOf(ClassConstants.INTERNAL_METHOD_ARGUMENTS_OPEN); + this.lastIndex = descriptor.indexOf(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + this.index = firstIndex + 1; + + if (lastIndex < 0) + { + lastIndex = descriptor.length(); + } + } + + + /** + * Returns the formal type parameters from the descriptor, assuming it's a + * method descriptor. + */ + public String formalTypeParameters() + { + return descriptor.substring(0, firstIndex); + } + + + /** + * Returns whether the enumeration can provide more types from the method + * descriptor. + */ + public boolean hasMoreTypes() + { + return index < lastIndex; + } + + + /** + * Returns the next type from the method descriptor. + */ + public String nextType() + { + int startIndex = index; + + skipArray(); + + char c = descriptor.charAt(index++); + switch (c) + { + case ClassConstants.INTERNAL_TYPE_CLASS_START: + case ClassConstants.INTERNAL_TYPE_GENERIC_VARIABLE_START: + { + skipClass(); + break; + } + case ClassConstants.INTERNAL_TYPE_GENERIC_START: + { + skipGeneric(); + break; + } + } + + return descriptor.substring(startIndex, index); + } + + + /** + * Returns the return type from the descriptor, assuming it's a method + * descriptor. + */ + public String returnType() + { + return descriptor.substring(lastIndex + 1); + } + + + // Small utility methods. + + private void skipArray() + { + while (descriptor.charAt(index) == ClassConstants.INTERNAL_TYPE_ARRAY) + { + index++; + } + } + + + private void skipClass() + { + while (true) + { + char c = descriptor.charAt(index++); + switch (c) + { + case ClassConstants.INTERNAL_TYPE_GENERIC_START: + skipGeneric(); + break; + + case ClassConstants.INTERNAL_TYPE_CLASS_END: + return; + } + } + } + + + private void skipGeneric() + { + int nestingLevel = 1; + + do + { + char c = descriptor.charAt(index++); + switch (c) + { + case ClassConstants.INTERNAL_TYPE_GENERIC_START: + nestingLevel++; + break; + + case ClassConstants.INTERNAL_TYPE_GENERIC_END: + nestingLevel--; + break; + } + } + while (nestingLevel > 0); + } + + + /** + * A main method for testing the type enumeration. + */ + public static void main(String[] args) + { + try + { + for (int index = 0; index < args.length; index++) + { + String descriptor = args[index]; + + System.out.println("Descriptor ["+descriptor+"]"); + InternalTypeEnumeration enumeration = new InternalTypeEnumeration(descriptor); + + if (enumeration.firstIndex >= 0) + { + System.out.println(" Formal type parameters ["+enumeration.formalTypeParameters()+"]"); + } + + while (enumeration.hasMoreTypes()) + { + System.out.println(" Type ["+enumeration.nextType()+"]"); + } + + if (enumeration.lastIndex < descriptor.length()) + { + System.out.println(" Return type ["+enumeration.returnType()+"]"); + } + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/classfile/util/MemberFinder.java b/src/proguard/classfile/util/MemberFinder.java new file mode 100644 index 0000000..0fdeec0 --- /dev/null +++ b/src/proguard/classfile/util/MemberFinder.java @@ -0,0 +1,197 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.visitor.*; + +/** + * This class provides methods to find class members in a given class or in its + * hierarchy. + * + * @author Eric Lafortune + */ +public class MemberFinder +extends SimplifiedVisitor +implements MemberVisitor +{ + private static class MemberFoundException extends RuntimeException {} + private static final MemberFoundException MEMBER_FOUND = new MemberFoundException(); + + private Clazz clazz; + private Member member; + + + /** + * Finds the field with the given name and descriptor in the given + * class or its hierarchy. + */ + public Field findField(Clazz referencingClass, + Clazz clazz, + String name, + String descriptor) + { + return (Field)findMember(referencingClass, clazz, name, descriptor, true); + } + + + /** + * Finds the method with the given name and descriptor in the given + * class or its hierarchy. + */ + public Method findMethod(Clazz referencingClass, + Clazz clazz, + String name, + String descriptor) + { + return (Method)findMember(referencingClass, clazz, name, descriptor, false); + } + + + /** + * Finds the class member with the given name and descriptor in the given + * class or its hierarchy. + */ + public Member findMember(Clazz referencingClass, + Clazz clazz, + String name, + String descriptor, + boolean isField) + { + // Organize a search in the hierarchy of superclasses and interfaces. + // The class member may be in a different class, if the code was + // compiled with "-target 1.2" or higher (the default in JDK 1.4). + try + { + this.clazz = null; + this.member = null; + clazz.hierarchyAccept(true, true, true, false, isField ? + (ClassVisitor)new NamedFieldVisitor(name, descriptor, + new MemberClassAccessFilter(referencingClass, this)) : + (ClassVisitor)new NamedMethodVisitor(name, descriptor, + new MemberClassAccessFilter(referencingClass, this))); + } + catch (MemberFoundException ex) + { + // We've found the member we were looking for. + } + + return member; + } + + + /** + * Returns the corresponding class of the most recently found class + * member. + */ + public Clazz correspondingClass() + { + return clazz; + } + + + /** + * Returns whether the given method is overridden anywhere down the class + * hierarchy. + */ + public boolean isOverriden(Clazz clazz, + Method method) + { + String name = method.getName(clazz); + String descriptor = method.getDescriptor(clazz); + + // Go looking for the method down the class hierarchy. + try + { + this.clazz = null; + this.member = null; + + clazz.hierarchyAccept(false, false, false, true, + new NamedMethodVisitor(name, descriptor, + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, this))); + } + catch (MemberFoundException ex) + { + // We've found an overriding method. + return true; + } + + return false; + } + + + /** + * Returns whether the given field is shadowed anywhere down the class + * hierarchy. + */ + public boolean isShadowed(Clazz clazz, + Field field) + { + String name = field.getName(clazz); + String descriptor = field.getDescriptor(clazz); + + // Go looking for the field down the class hierarchy. + try + { + this.clazz = null; + this.member = null; + clazz.hierarchyAccept(false, false, false, true, + new NamedFieldVisitor(name, descriptor, + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, this))); + } + catch (MemberFoundException ex) + { + // We've found a shadowing field. + return true; + } + + return false; + } + + +// // Implementations for ClassVisitor. +// +// private void visitAnyClass(Clazz clazz) +// { +// if (member == null) +// { +// member = isField ? +// (Member)clazz.findField(name, descriptor) : +// (Member)clazz.findMethod(name, descriptor); +// +// if (member != null) +// { +// this.clazz = clazz; +// } +// } +// } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + this.clazz = clazz; + this.member = member; + + throw MEMBER_FOUND; + } +} diff --git a/src/proguard/classfile/util/MethodLinker.java b/src/proguard/classfile/util/MethodLinker.java new file mode 100644 index 0000000..5f2ea6f --- /dev/null +++ b/src/proguard/classfile/util/MethodLinker.java @@ -0,0 +1,165 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.visitor.*; + +import java.util.*; + +/** + * This ClassVisitor links all corresponding non-private methods in the class + * hierarchies of all visited classes. Visited classes are typically all class + * files that are not being subclassed. Chains of links that have been created + * in previous invocations are merged with new chains of links, in order to + * create a consistent set of chains. + *

    + * As a MemberVisitor, it links all corresponding class members that it visits, + * including fields and private class members. + *

    + * Class initialization methods and constructors are always ignored. + * + * @author Eric Lafortune + */ +public class MethodLinker +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor +{ + // An object that is reset and reused every time. + // The map: [class member name+' '+descriptor - class member info] + private final Map memberMap = new HashMap(); + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + // Collect all non-private members in this class hierarchy. + clazz.hierarchyAccept(true, true, true, false, + new AllMethodVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + this))); + + // Clean up for the next class hierarchy. + memberMap.clear(); + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + // Get the class member's name and descriptor. + String name = member.getName(clazz); + String descriptor = member.getDescriptor(clazz); + + // Special cases: and are always kept unchanged. + // We can ignore them here. + if (name.equals(ClassConstants.INTERNAL_METHOD_NAME_CLINIT) || + name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + return; + } + + // See if we've already come across a method with the same name and + // descriptor. + String key = name + ' ' + descriptor; + Member otherMember = (Member)memberMap.get(key); + + if (otherMember == null) + { + // Get the last method in the chain. + Member thisLastMember = lastMember(member); + + // Store the new class method in the map. + memberMap.put(key, thisLastMember); + } + else + { + // Link both members. + link(member, otherMember); + } + } + + + // Small utility methods. + + /** + * Links the two given class members. + */ + private static void link(Member member1, Member member2) + { + // Get the last methods in the both chains. + Member lastMember1 = lastMember(member1); + Member lastMember2 = lastMember(member2); + + // Check if both link chains aren't already ending in the same element. + if (!lastMember1.equals(lastMember2)) + { + // Merge the two chains, with the library members last. + if (lastMember2 instanceof LibraryMember) + { + lastMember1.setVisitorInfo(lastMember2); + } + else + { + lastMember2.setVisitorInfo(lastMember1); + } + } + } + + + /** + * Finds the last class member in the linked list of related class members. + * @param member the given class member. + * @return the last class member in the linked list. + */ + public static Member lastMember(Member member) + { + Member lastMember = member; + while (lastMember.getVisitorInfo() != null && + lastMember.getVisitorInfo() instanceof Member) + { + lastMember = (Member)lastMember.getVisitorInfo(); + } + + return lastMember; + } + + + /** + * Finds the last visitor accepter in the linked list of visitors. + * @param visitorAccepter the given method. + * @return the last method in the linked list. + */ + public static VisitorAccepter lastVisitorAccepter(VisitorAccepter visitorAccepter) + { + VisitorAccepter lastVisitorAccepter = visitorAccepter; + while (lastVisitorAccepter.getVisitorInfo() != null && + lastVisitorAccepter.getVisitorInfo() instanceof VisitorAccepter) + { + lastVisitorAccepter = (VisitorAccepter)lastVisitorAccepter.getVisitorInfo(); + } + + return lastVisitorAccepter; + } +} diff --git a/src/proguard/classfile/util/SimplifiedVisitor.java b/src/proguard/classfile/util/SimplifiedVisitor.java new file mode 100644 index 0000000..87b7fe4 --- /dev/null +++ b/src/proguard/classfile/util/SimplifiedVisitor.java @@ -0,0 +1,810 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.constant.*; +import proguard.classfile.instruction.*; + +/** + * This abstract utility class allows to implement various visitor interfaces + * with simplified methods. The provided methods delegate to other versions + * with fewer arguments or more general arguments. + * + * @author Eric Lafortune + * @noinspection AbstractClassWithoutAbstractMethods + */ +public abstract class SimplifiedVisitor +{ + // Simplifications for ClassVisitor. + + /** + * Visits any type of class member of the given class. + */ + public void visitAnyClass(Clazz Clazz) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitProgramClass(ProgramClass programClass) + { + visitAnyClass(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + visitAnyClass(libraryClass); + } + + + // Simplifications for MemberVisitor. + + /** + * Visits any type of class member of the given class. + */ + public void visitAnyMember(Clazz clazz, Member member) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + /** + * Visits any type of class member of the given program class. + */ + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + visitAnyMember(programClass, programMember); + } + + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + visitProgramMember(programClass, programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + visitProgramMember(programClass, programMethod); + } + + + /** + * Visits any type of class member of the given library class. + */ + public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) + { + visitAnyMember(libraryClass, libraryMember); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + visitLibraryMember(libraryClass, libraryField); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + visitLibraryMember(libraryClass, libraryMethod); + } + + + // Simplifications for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + visitAnyConstant(clazz, integerConstant); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + visitAnyConstant(clazz, longConstant); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + visitAnyConstant(clazz, floatConstant); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + visitAnyConstant(clazz, doubleConstant); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + visitAnyConstant(clazz, stringConstant); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + visitAnyConstant(clazz, utf8Constant); + } + + + /** + * Visits any type of RefConstant of the given class. + */ + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + visitAnyConstant(clazz, refConstant); + } + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + visitAnyRefConstant(clazz, fieldrefConstant); + } + + + /** + * Visits any type of method RefConstant of the given class. + */ + public void visitAnyMethodrefConstant(Clazz clazz, RefConstant refConstant) + { + visitAnyRefConstant(clazz, refConstant); + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + visitAnyMethodrefConstant(clazz, interfaceMethodrefConstant); + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + visitAnyMethodrefConstant(clazz, methodrefConstant); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + visitAnyConstant(clazz, classConstant); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + visitAnyConstant(clazz, nameAndTypeConstant); + } + + + // Simplifications for AttributeVisitor. + + /** + * Visit any type of attribute. + */ + public void visitAnyAttribute(Clazz clazz, Attribute attribute) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + visitAnyAttribute(clazz, unknownAttribute); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + visitAnyAttribute(clazz, sourceFileAttribute); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + visitAnyAttribute(clazz, sourceDirAttribute); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + visitAnyAttribute(clazz, innerClassesAttribute); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + visitAnyAttribute(clazz, enclosingMethodAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + visitAnyAttribute(clazz, deprecatedAttribute); + } + + + /** + * Visits the given DeprecatedAttribute of any type of class member. + */ + public void visitDeprecatedAttribute(Clazz clazz, Member member, DeprecatedAttribute deprecatedAttribute) + { + visitDeprecatedAttribute(clazz, deprecatedAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, Field field, DeprecatedAttribute deprecatedAttribute) + { + visitDeprecatedAttribute(clazz, (Member)field, deprecatedAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, Method method, DeprecatedAttribute deprecatedAttribute) + { + visitDeprecatedAttribute(clazz, (Member)method, deprecatedAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + visitAnyAttribute(clazz, syntheticAttribute); + } + + + /** + * Visits the given SyntheticAttribute of any type of class member. + */ + public void visitSyntheticAttribute(Clazz clazz, Member member, SyntheticAttribute syntheticAttribute) + { + visitSyntheticAttribute(clazz, syntheticAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, Field field, SyntheticAttribute syntheticAttribute) + { + visitSyntheticAttribute(clazz, (Member)field, syntheticAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, Method method, SyntheticAttribute syntheticAttribute) + { + visitSyntheticAttribute(clazz, (Member)method, syntheticAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + visitAnyAttribute(clazz, signatureAttribute); + } + + + /** + * Visits the given SignatureAttribute of any type of class member. + */ + public void visitSignatureAttribute(Clazz clazz, Member member, SignatureAttribute signatureAttribute) + { + visitSignatureAttribute(clazz, signatureAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, Field field, SignatureAttribute signatureAttribute) + { + visitSignatureAttribute(clazz, (Member)field, signatureAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute signatureAttribute) + { + visitSignatureAttribute(clazz, (Member)method, signatureAttribute); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + visitAnyAttribute(clazz, constantValueAttribute); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + visitAnyAttribute(clazz, exceptionsAttribute); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + visitAnyAttribute(clazz, codeAttribute); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + visitAnyAttribute(clazz, stackMapAttribute); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + visitAnyAttribute(clazz, stackMapTableAttribute); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + visitAnyAttribute(clazz, lineNumberTableAttribute); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + visitAnyAttribute(clazz, localVariableTableAttribute); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + visitAnyAttribute(clazz, localVariableTypeTableAttribute); + } + + + /** + * Visits any type of AnnotationsAttribute of a class. + */ + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + visitAnyAttribute(clazz, annotationsAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + visitAnyAnnotationsAttribute(clazz, runtimeVisibleAnnotationsAttribute); + } + + + /** + * Visits the given RuntimeVisibleAnnotationsAttribute of any type of class member. + */ + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Member member, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + visitRuntimeVisibleAnnotationsAttribute(clazz, runtimeVisibleAnnotationsAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + visitRuntimeVisibleAnnotationsAttribute(clazz, (Member)field, runtimeVisibleAnnotationsAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + visitRuntimeVisibleAnnotationsAttribute(clazz, (Member)method, runtimeVisibleAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + visitAnyAnnotationsAttribute(clazz, runtimeInvisibleAnnotationsAttribute); + } + + + /** + * Visits the given RuntimeInvisibleAnnotationsAttribute of any type of class member. + */ + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Member member, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + visitRuntimeInvisibleAnnotationsAttribute(clazz, runtimeInvisibleAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + visitRuntimeInvisibleAnnotationsAttribute(clazz, (Member)field, runtimeInvisibleAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + visitRuntimeInvisibleAnnotationsAttribute(clazz, (Member)method, runtimeInvisibleAnnotationsAttribute); + } + + + /** + * Visits any type of ParameterAnnotationsAttribute. + */ + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + visitAnyAttribute(clazz, parameterAnnotationsAttribute); + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + visitAnyParameterAnnotationsAttribute(clazz, method, runtimeVisibleParameterAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + visitAnyParameterAnnotationsAttribute(clazz, method, runtimeInvisibleParameterAnnotationsAttribute); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + visitAnyAttribute(clazz, annotationDefaultAttribute); + } + + + // Simplifications for InstructionVisitor. + + /** + * Visits any type of Instruction. + */ + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + visitAnyInstruction(clazz, method, codeAttribute, offset, simpleInstruction); + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + visitAnyInstruction(clazz, method, codeAttribute, offset, variableInstruction); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + visitAnyInstruction(clazz, method, codeAttribute, offset, constantInstruction); + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + visitAnyInstruction(clazz, method, codeAttribute, offset, branchInstruction); + } + + + /** + * Visits either type of SwitchInstruction. + */ + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + visitAnyInstruction(clazz, method, codeAttribute, offset, switchInstruction); + } + + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + visitAnySwitchInstruction(clazz, method, codeAttribute, offset, tableSwitchInstruction); + } + + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + visitAnySwitchInstruction(clazz, method, codeAttribute, offset, lookUpSwitchInstruction); + } + + + // Simplifications for StackMapFrameVisitor. + + /** + * Visits any type of VerificationType. + */ + public void visitAnyStackMapFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrame stackMapFrame) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitSameZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameZeroFrame sameZeroFrame) + { + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, sameZeroFrame); + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, sameOneFrame); + } + + + public void visitLessZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LessZeroFrame lessZeroFrame) + { + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, lessZeroFrame); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, moreZeroFrame); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + visitAnyStackMapFrame(clazz, method, codeAttribute, offset, fullFrame); + } + + + // Simplifications for VerificationTypeVisitor. + + /** + * Visits any type of VerificationType. + */ + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitIntegerType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, IntegerType integerType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, integerType); + } + + + public void visitFloatType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FloatType floatType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, floatType); + } + + + public void visitLongType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LongType longType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, longType); + } + + + public void visitDoubleType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, DoubleType doubleType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, doubleType); + } + + + public void visitTopType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TopType topType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, topType); + } + + + public void visitObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, objectType); + } + + + public void visitNullType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, NullType nullType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, nullType); + } + + + public void visitUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, uninitializedType); + } + + + public void visitUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedThisType uninitializedThisType) + { + visitAnyVerificationType(clazz, method, codeAttribute, offset, uninitializedThisType); + } + + + public void visitStackIntegerType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, IntegerType integerType) + { + visitIntegerType(clazz, method, codeAttribute, offset, integerType); + } + + + public void visitStackFloatType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, FloatType floatType) + { + visitFloatType(clazz, method, codeAttribute, offset, floatType); + } + + + public void visitStackLongType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, LongType longType) + { + visitLongType(clazz, method, codeAttribute, offset, longType); + } + + + public void visitStackDoubleType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, DoubleType doubleType) + { + visitDoubleType(clazz, method, codeAttribute, offset, doubleType); + } + + + public void visitStackTopType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, TopType topType) + { + visitTopType(clazz, method, codeAttribute, offset, topType); + } + + + public void visitStackObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, ObjectType objectType) + { + visitObjectType(clazz, method, codeAttribute, offset, objectType); + } + + + public void visitStackNullType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, NullType nullType) + { + visitNullType(clazz, method, codeAttribute, offset, nullType); + } + + + public void visitStackUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedType uninitializedType) + { + visitUninitializedType(clazz, method, codeAttribute, offset, uninitializedType); + } + + + public void visitStackUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedThisType uninitializedThisType) + { + visitUninitializedThisType(clazz, method, codeAttribute, offset, uninitializedThisType); + } + + + + public void visitVariablesIntegerType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, IntegerType integerType) + { + visitIntegerType(clazz, method, codeAttribute, offset, integerType); + } + + + public void visitVariablesFloatType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, FloatType floatType) + { + visitFloatType(clazz, method, codeAttribute, offset, floatType); + } + + + public void visitVariablesLongType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, LongType longType) + { + visitLongType(clazz, method, codeAttribute, offset, longType); + } + + + public void visitVariablesDoubleType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, DoubleType doubleType) + { + visitDoubleType(clazz, method, codeAttribute, offset, doubleType); + } + + + public void visitVariablesTopType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, TopType topType) + { + visitTopType(clazz, method, codeAttribute, offset, topType); + } + + + public void visitVariablesObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, ObjectType objectType) + { + visitObjectType(clazz, method, codeAttribute, offset, objectType); + } + + + public void visitVariablesNullType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, NullType nullType) + { + visitNullType(clazz, method, codeAttribute, offset, nullType); + } + + + public void visitVariablesUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedType uninitializedType) + { + visitUninitializedType(clazz, method, codeAttribute, offset, uninitializedType); + } + + + public void visitVariablesUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int index, UninitializedThisType uninitializedThisType) + { + visitUninitializedThisType(clazz, method, codeAttribute, offset, uninitializedThisType); + } + + + // Simplifications for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + /** + * Visits the given Annotation of any type of class member. + */ + public void visitAnnotation(Clazz clazz, Member member, Annotation annotation) + { + visitAnnotation(clazz, annotation); + } + + + public void visitAnnotation(Clazz clazz, Field field, Annotation annotation) + { + visitAnnotation(clazz, (Member)field, annotation); + } + + + public void visitAnnotation(Clazz clazz, Method method, Annotation annotation) + { + visitAnnotation(clazz, (Member)method, annotation); + } + + + public void visitAnnotation(Clazz clazz, Method method, int parameterIndex, Annotation annotation) + { + visitAnnotation(clazz, method, annotation); + } + + + // Simplifications for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) + { + throw new UnsupportedOperationException("Method must be overridden in ["+this.getClass().getName()+"] if ever called"); + } + + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + visitAnyElementValue(clazz, annotation, constantElementValue); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + visitAnyElementValue(clazz, annotation, enumConstantElementValue); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + visitAnyElementValue(clazz, annotation, classElementValue); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + visitAnyElementValue(clazz, annotation, annotationElementValue); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + visitAnyElementValue(clazz, annotation, arrayElementValue); + } +} diff --git a/src/proguard/classfile/util/StringReferenceInitializer.java b/src/proguard/classfile/util/StringReferenceInitializer.java new file mode 100644 index 0000000..3884a04 --- /dev/null +++ b/src/proguard/classfile/util/StringReferenceInitializer.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; + +/** + * This ConstantVisitor initializes any class references of all string constants + * it visits. More specifically, it fills out the references of string constant + * pool entries that happen to refer to a class in the program class pool or in + * the library class pool. + * + * @author Eric Lafortune + */ +public class StringReferenceInitializer +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final ClassPool programClassPool; + private final ClassPool libraryClassPool; + + + /** + * Creates a new StringReferenceInitializer. + */ + public StringReferenceInitializer(ClassPool programClassPool, + ClassPool libraryClassPool) + { + this.programClassPool = programClassPool; + this.libraryClassPool = libraryClassPool; + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + if (stringConstant.referencedClass == null) + { + // See if we can find the referenced class. + stringConstant.referencedClass = + findClass(ClassUtil.internalClassName(stringConstant.getString(clazz))); + } + } + + + // Small utility methods. + + /** + * Returns the class with the given name, either for the program class pool + * or from the library class pool, or null if it can't be found. + */ + private Clazz findClass(String name) + { + // First look for the class in the program class pool. + Clazz clazz = programClassPool.getClass(name); + + // Otherwise look for the class in the library class pool. + if (clazz == null) + { + clazz = libraryClassPool.getClass(name); + } + + return clazz; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/util/StringSharer.java b/src/proguard/classfile/util/StringSharer.java new file mode 100644 index 0000000..56de7c5 --- /dev/null +++ b/src/proguard/classfile/util/StringSharer.java @@ -0,0 +1,155 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor shares strings in the class files that it visits. + * + * @author Eric Lafortune + */ +public class StringSharer +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + AttributeVisitor +{ + // A fields acting as an argument for the visitor methods. + private String name; + private String type; + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Replace name strings in the constant pool by shared strings. + programClass.constantPoolEntriesAccept(this); + + // Replace attribute name strings in the constant pool by internalized + // strings. + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Replace the super class name string by the shared name string. + Clazz superClass = libraryClass.superClass; + if (superClass != null) + { + libraryClass.superClassName = superClass.getName(); + } + } + + + // Implementations for ConstantVisitor. + + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitAnyStringConstant(Clazz clazz, StringConstant stringConstant) + { + Member referencedMember = stringConstant.referencedMember; + if (referencedMember != null) + { + Clazz referencedClass = stringConstant.referencedClass; + + // Put the actual class member's name in the class pool. + name = referencedMember.getName(referencedClass); + clazz.constantPoolEntryAccept(stringConstant.u2stringIndex, this); + } + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + Clazz referencedClass = refConstant.referencedClass; + + // Put the actual class member's name and type strings in the class + // pool. + name = referencedMember.getName(referencedClass); + type = referencedMember.getDescriptor(referencedClass); + clazz.constantPoolEntryAccept(refConstant.u2nameAndTypeIndex, this); + } + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + if (name != null) + { + // Put the actual class member's name and type strings in the class + // pool. + clazz.constantPoolEntryAccept(nameAndTypeConstant.u2nameIndex, this); + name = type; + clazz.constantPoolEntryAccept(nameAndTypeConstant.u2descriptorIndex, this); + } + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + Clazz referencedClass = classConstant.referencedClass; + if (referencedClass != null) + { + // Put the actual class's name string in the class pool. + name = referencedClass.getName(); + clazz.constantPoolEntryAccept(classConstant.u2nameIndex, this); + } + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + // Do we have a new string to put into this constant? + if (name != null) + { + // Replace the string, if it's actually the same. + if (name.equals(utf8Constant.getString())) + { + utf8Constant.setString(name); + } + + name = null; + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) + { + // Put the internalized attribute's name string in the class pool. + name = attribute.getAttributeName(clazz).intern(); + clazz.constantPoolEntryAccept(attribute.u2attributeNameIndex, this); + } +} diff --git a/src/proguard/classfile/util/WarningPrinter.java b/src/proguard/classfile/util/WarningPrinter.java new file mode 100644 index 0000000..87d8978 --- /dev/null +++ b/src/proguard/classfile/util/WarningPrinter.java @@ -0,0 +1,136 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.util; + +import proguard.util.*; + +import java.io.PrintStream; +import java.util.List; + +/** + * This class prints out and counts warnings. + * + * @author Eric Lafortune + */ +public class WarningPrinter +{ + private final PrintStream printStream; + private final StringMatcher classFilter; + private int warningCount; + + + /** + * Creates a new WarningPrinter that prints to the System.err print stream. + */ + public WarningPrinter() + { + this(System.err); + } + + + /** + * Creates a new WarningPrinter that prints to the given print stream. + */ + public WarningPrinter(PrintStream printStream) + { + this.printStream = printStream; + this.classFilter = null; + } + + + /** + * Creates a new WarningPrinter that prints to the given print stream, + * except if the names of any involved classes matches the given filter. + */ + public WarningPrinter(PrintStream printStream, List classFilter) + { + this.printStream = printStream; + this.classFilter = classFilter == null ? null : + new ListParser(new ClassNameParser()).parse(classFilter); + } + + + /** + * Prints out the given warning and increments the warning count, if + * the given class name passes the class name filter. + */ + public void print(String className, String warning) + { + if (accepts(className)) + { + print(warning); + } + } + + + /** + * Returns whether the given class name passes the class name filter. + */ + public boolean accepts(String className) + { + return classFilter == null || + !classFilter.matches(className); + } + + + /** + * Prints out the given warning and increments the warning count, if + * the given class names pass the class name filter. + */ + public void print(String className1, String className2, String warning) + { + if (accepts(className1, className2)) + { + print(warning); + } + } + + + /** + * Returns whether the given class names pass the class name filter. + */ + public boolean accepts(String className1, String className2) + { + return classFilter == null || + !(classFilter.matches(className1) || + classFilter.matches(className2)); + } + + + /** + * Prints out the given warning and increments the warning count. + */ + private void print(String warning) + { + printStream.println(warning); + + warningCount++; + } + + + /** + * Returns the number of warnings printed so far. + */ + public int getWarningCount() + { + return warningCount; + } +} diff --git a/src/proguard/classfile/util/package.html b/src/proguard/classfile/util/package.html new file mode 100644 index 0000000..b1b881e --- /dev/null +++ b/src/proguard/classfile/util/package.html @@ -0,0 +1,3 @@ + +This package contains utility classes for processing class files. + diff --git a/src/proguard/classfile/visitor/AllClassVisitor.java b/src/proguard/classfile/visitor/AllClassVisitor.java new file mode 100644 index 0000000..06aca2c --- /dev/null +++ b/src/proguard/classfile/visitor/AllClassVisitor.java @@ -0,0 +1,47 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.ClassPool; + + +/** + * This ClassPoolVisitor lets a given ClassVisitor visit all Clazz + * objects of the class pools it visits. + * + * @author Eric Lafortune + */ +public class AllClassVisitor implements ClassPoolVisitor +{ + private final ClassVisitor classVisitor; + + + public AllClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + public void visitClassPool(ClassPool classPool) + { + classPool.classesAccept(classVisitor); + } +} diff --git a/src/proguard/classfile/visitor/AllFieldVisitor.java b/src/proguard/classfile/visitor/AllFieldVisitor.java new file mode 100644 index 0000000..8bff7d4 --- /dev/null +++ b/src/proguard/classfile/visitor/AllFieldVisitor.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor lets a given MemberVisitor visit all FieldMember + * objects of the classes it visits. + * + * @author Eric Lafortune + */ +public class AllFieldVisitor implements ClassVisitor +{ + private final MemberVisitor memberVisitor; + + + public AllFieldVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.fieldsAccept(memberVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.fieldsAccept(memberVisitor); + } +} diff --git a/src/proguard/classfile/visitor/AllMemberVisitor.java b/src/proguard/classfile/visitor/AllMemberVisitor.java new file mode 100644 index 0000000..448470e --- /dev/null +++ b/src/proguard/classfile/visitor/AllMemberVisitor.java @@ -0,0 +1,57 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor lets a given MemberVisitor visit all Member + * objects of the classes it visits. + * + * @author Eric Lafortune + */ +public class AllMemberVisitor implements ClassVisitor +{ + private final MemberVisitor memberVisitor; + + + public AllMemberVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.fieldsAccept(memberVisitor); + programClass.methodsAccept(memberVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.fieldsAccept(memberVisitor); + libraryClass.methodsAccept(memberVisitor); + } +} diff --git a/src/proguard/classfile/visitor/AllMethodVisitor.java b/src/proguard/classfile/visitor/AllMethodVisitor.java new file mode 100644 index 0000000..75b919d --- /dev/null +++ b/src/proguard/classfile/visitor/AllMethodVisitor.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor lets a given MemberVisitor visit all MethodMember + * objects of the classes it visits. + * + * @author Eric Lafortune + */ +public class AllMethodVisitor implements ClassVisitor +{ + private final MemberVisitor memberVisitor; + + + public AllMethodVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.methodsAccept(memberVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.methodsAccept(memberVisitor); + } +} diff --git a/src/proguard/classfile/visitor/BottomClassFilter.java b/src/proguard/classfile/visitor/BottomClassFilter.java new file mode 100644 index 0000000..8f5bdd1 --- /dev/null +++ b/src/proguard/classfile/visitor/BottomClassFilter.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, but only when visiting classes that don't + * have any subclasses. + * + * @author Eric Lafortune + */ +public class BottomClassFilter implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new ProgramClassFilter. + * @param classVisitor the ClassVisitor to which visits + * will be delegated. + */ + public BottomClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Is this a bottom class in the class hierarchy? + if (programClass.subClasses == null) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Is this a bottom class in the class hierarchy? + if (libraryClass.subClasses == null) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} diff --git a/src/proguard/classfile/visitor/ClassAccessFilter.java b/src/proguard/classfile/visitor/ClassAccessFilter.java new file mode 100644 index 0000000..a8815b6 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassAccessFilter.java @@ -0,0 +1,88 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, but only when the visited class + * has the proper access flags. + * + * @see ClassConstants + * + * @author Eric Lafortune + */ +public class ClassAccessFilter implements ClassVisitor +{ + private final int requiredSetAccessFlags; + private final int requiredUnsetAccessFlags; + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassAccessFilter. + * @param requiredSetAccessFlags the class access flags that should be + * set. + * @param requiredUnsetAccessFlags the class access flags that should be + * unset. + * @param classVisitor the ClassVisitor to + * which visits will be delegated. + */ + public ClassAccessFilter(int requiredSetAccessFlags, + int requiredUnsetAccessFlags, + ClassVisitor classVisitor) + { + this.requiredSetAccessFlags = requiredSetAccessFlags; + this.requiredUnsetAccessFlags = requiredUnsetAccessFlags; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (accepted(programClass.getAccessFlags())) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (accepted(libraryClass.getAccessFlags())) + { + classVisitor.visitLibraryClass(libraryClass); + } + } + + + // Small utility methods. + + private boolean accepted(int accessFlags) + { + return (requiredSetAccessFlags & ~accessFlags) == 0 && + (requiredUnsetAccessFlags & accessFlags) == 0; + } +} diff --git a/src/proguard/classfile/visitor/ClassCleaner.java b/src/proguard/classfile/visitor/ClassCleaner.java new file mode 100644 index 0000000..36165ef --- /dev/null +++ b/src/proguard/classfile/visitor/ClassCleaner.java @@ -0,0 +1,275 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.Constant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ClassVisitor removes all visitor information of the + * classes it visits. + * + * @author Eric Lafortune + */ +public class ClassCleaner +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor, + AttributeVisitor, + ExceptionInfoVisitor, + InnerClassesInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + clean(programClass); + + programClass.constantPoolEntriesAccept(this); + + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + clean(libraryClass); + + libraryClass.fieldsAccept(this); + libraryClass.methodsAccept(this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) + { + clean(constant); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + clean(programMember); + + programMember.attributesAccept(programClass, this); + } + + + public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) + { + clean(libraryMember); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) + { + clean(attribute); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + clean(innerClassesAttribute); + + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + clean(exceptionsAttribute); + + exceptionsAttribute.exceptionEntriesAccept((ProgramClass)clazz, this); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + clean(codeAttribute); + + codeAttribute.exceptionsAccept(clazz, method, this); + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + clean(stackMapAttribute); + + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + clean(stackMapTableAttribute); + + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + clean(annotationsAttribute); + + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + clean(parameterAnnotationsAttribute); + + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + clean(annotationDefaultAttribute); + + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + clean(innerClassesInfo); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + clean(exceptionInfo); + } + + + // Implementations for StackMapFrameVisitor. + + public void visitSameZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameZeroFrame sameZeroFrame) + { + clean(sameZeroFrame); + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + clean(sameOneFrame); + + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitLessZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LessZeroFrame lessZeroFrame) + { + clean(lessZeroFrame); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + clean(moreZeroFrame); + + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + clean(fullFrame); + + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) + { + clean(verificationType); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + clean(annotation); + + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) + { + clean(elementValue); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + clean(annotationElementValue); + + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + clean(arrayElementValue); + } + + + // Small utility methods. + + private void clean(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(null); + } +} diff --git a/src/proguard/classfile/visitor/ClassCollector.java b/src/proguard/classfile/visitor/ClassCollector.java new file mode 100644 index 0000000..a69fe76 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassCollector.java @@ -0,0 +1,58 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.util.SimplifiedVisitor; + +import java.util.Set; + +/** + * This ClassVisitor collects the classes that it visits in the + * given collection. + * + * @author Eric Lafortune + */ +public class ClassCollector +extends SimplifiedVisitor +implements ClassVisitor +{ + private final Set set; + + + /** + * Creates a new ClassCollector. + * @param set the Set in which all class names will be + * collected. + */ + public ClassCollector(Set set) + { + this.set = set; + } + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + set.add(clazz); + } +} diff --git a/src/proguard/classfile/visitor/ClassCounter.java b/src/proguard/classfile/visitor/ClassCounter.java new file mode 100644 index 0000000..c58c090 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassCounter.java @@ -0,0 +1,56 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor counts the number of classes that has been visited. + * + * @author Eric Lafortune + */ +public class ClassCounter implements ClassVisitor +{ + private int count; + + + /** + * Returns the number of classes that has been visited so far. + */ + public int getCount() + { + return count; + } + + + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) + { + count++; + } + + + public void visitProgramClass(ProgramClass programClass) + { + count++; + } +} diff --git a/src/proguard/classfile/visitor/ClassForNameClassVisitor.java b/src/proguard/classfile/visitor/ClassForNameClassVisitor.java new file mode 100644 index 0000000..ee028f8 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassForNameClassVisitor.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + + +/** + * This ConstantVisitor lets a given ClassVisitor visit all + * constant classes involved in any Class.forName constructs that + * it visits. + * + * @see DotClassClassVisitor + * + * @author Eric Lafortune + */ +public class ClassForNameClassVisitor +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassHierarchyTraveler. + * @param classVisitor the ClassVisitor to which visits will + * be delegated. + */ + public ClassForNameClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Visit the referenced class from the Class.forName construct, if any. + stringConstant.referencedClassAccept(classVisitor); + } +} diff --git a/src/proguard/classfile/visitor/ClassHierarchyTraveler.java b/src/proguard/classfile/visitor/ClassHierarchyTraveler.java new file mode 100644 index 0000000..2e1755e --- /dev/null +++ b/src/proguard/classfile/visitor/ClassHierarchyTraveler.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor lets a given ClassVisitor + * optionally travel to the visited class, its superclass, its interfaces, and + * its subclasses. + * + * @author Eric Lafortune + */ +public class ClassHierarchyTraveler implements ClassVisitor +{ + private final boolean visitThisClass; + private final boolean visitSuperClass; + private final boolean visitInterfaces; + private final boolean visitSubclasses; + + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassHierarchyTraveler. + * @param visitThisClass specifies whether to visit the originally visited + * classes. + * @param visitSuperClass specifies whether to visit the super classes of + * the visited classes. + * @param visitInterfaces specifies whether to visit the interfaces of + * the visited classes. + * @param visitSubclasses specifies whether to visit the subclasses of + * the visited classes. + * @param classVisitor the ClassVisitor to + * which visits will be delegated. + */ + public ClassHierarchyTraveler(boolean visitThisClass, + boolean visitSuperClass, + boolean visitInterfaces, + boolean visitSubclasses, + ClassVisitor classVisitor) + { + this.visitThisClass = visitThisClass; + this.visitSuperClass = visitSuperClass; + this.visitInterfaces = visitInterfaces; + this.visitSubclasses = visitSubclasses; + + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.hierarchyAccept(visitThisClass, + visitSuperClass, + visitInterfaces, + visitSubclasses, + classVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.hierarchyAccept(visitThisClass, + visitSuperClass, + visitInterfaces, + visitSubclasses, + classVisitor); + } +} diff --git a/src/proguard/classfile/visitor/ClassNameFilter.java b/src/proguard/classfile/visitor/ClassNameFilter.java new file mode 100644 index 0000000..c016a34 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassNameFilter.java @@ -0,0 +1,112 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.util.*; + +import java.util.List; + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, but only when the visited class has a name that + * matches a given regular expression. + * + * @author Eric Lafortune + */ +public class ClassNameFilter implements ClassVisitor +{ + private final StringMatcher regularExpressionMatcher; + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassNameFilter. + * @param regularExpression the regular expression against which class names + * will be matched. + * @param classVisitor the ClassVisitor to which visits + * will be delegated. + */ + public ClassNameFilter(String regularExpression, + ClassVisitor classVisitor) + { + this(new ListParser(new ClassNameParser()).parse(regularExpression), + classVisitor); + } + + + /** + * Creates a new ClassNameFilter. + * @param regularExpression the regular expression against which class names + * will be matched. + * @param classVisitor the ClassVisitor to which visits + * will be delegated. + */ + public ClassNameFilter(List regularExpression, + ClassVisitor classVisitor) + { + this(new ListParser(new ClassNameParser()).parse(regularExpression), + classVisitor); + } + + + /** + * Creates a new ClassNameFilter. + * @param regularExpressionMatcher the regular expression against which + * class names will be matched. + * @param classVisitor the ClassVisitor to which + * visits will be delegated. + */ + public ClassNameFilter(StringMatcher regularExpressionMatcher, + ClassVisitor classVisitor) + { + this.regularExpressionMatcher = regularExpressionMatcher; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (accepted(programClass.getName())) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (accepted(libraryClass.getName())) + { + classVisitor.visitLibraryClass(libraryClass); + } + } + + + // Small utility methods. + + private boolean accepted(String name) + { + return regularExpressionMatcher.matches(name); + } +} diff --git a/src/proguard/classfile/visitor/ClassPoolFiller.java b/src/proguard/classfile/visitor/ClassPoolFiller.java new file mode 100644 index 0000000..e1773de --- /dev/null +++ b/src/proguard/classfile/visitor/ClassPoolFiller.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; + + +/** + * This ClassVisitor collects all the classes it visits in a given + * class pool. + * + * @author Eric Lafortune + */ +public class ClassPoolFiller +extends SimplifiedVisitor +implements ClassVisitor +{ + private final ClassPool classPool; + + + /** + * Creates a new ClassPoolFiller. + */ + public ClassPoolFiller(ClassPool classPool) + { + this.classPool = classPool; + } + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + classPool.addClass(clazz); + } +} diff --git a/src/proguard/classfile/visitor/ClassPoolVisitor.java b/src/proguard/classfile/visitor/ClassPoolVisitor.java new file mode 100644 index 0000000..0b659dc --- /dev/null +++ b/src/proguard/classfile/visitor/ClassPoolVisitor.java @@ -0,0 +1,37 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.ClassPool; + + +/** + * This interface specifies the methods for a visitor of + * ClassPool objects. Note that there is only a single + * implementation of ClassPool, such that this interface + * is not strictly necessary as a visitor. + * + * @author Eric Lafortune + */ +public interface ClassPoolVisitor +{ + public void visitClassPool(ClassPool classPool); +} diff --git a/src/proguard/classfile/visitor/ClassPresenceFilter.java b/src/proguard/classfile/visitor/ClassPresenceFilter.java new file mode 100644 index 0000000..429c340 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassPresenceFilter.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor delegates its visits to one of two + * ClassVisitor instances, depending on whether the name of + * the visited class file is present in a given ClassPool or not. + * + * @author Eric Lafortune + */ +public class ClassPresenceFilter implements ClassVisitor +{ + private final ClassPool classPool; + private final ClassVisitor presentClassVisitor; + private final ClassVisitor missingClassVisitor; + + + /** + * Creates a new ClassPresenceFilter. + * @param classPool the ClassPool in which the + * presence will be tested. + * @param presentClassVisitor the ClassVisitor to which visits + * of present class files will be delegated. + * @param missingClassVisitor the ClassVisitor to which visits + * of missing class files will be delegated. + */ + public ClassPresenceFilter(ClassPool classPool, + ClassVisitor presentClassVisitor, + ClassVisitor missingClassVisitor) + { + this.classPool = classPool; + this.presentClassVisitor = presentClassVisitor; + this.missingClassVisitor = missingClassVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + ClassVisitor classFileVisitor = classFileVisitor(programClass); + + if (classFileVisitor != null) + { + classFileVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + ClassVisitor classFileVisitor = classFileVisitor(libraryClass); + + if (classFileVisitor != null) + { + classFileVisitor.visitLibraryClass(libraryClass); + } + } + + + // Small utility methods. + + /** + * Returns the appropriate ClassVisitor. + */ + private ClassVisitor classFileVisitor(Clazz clazz) + { + return classPool.getClass(clazz.getName()) != null ? + presentClassVisitor : + missingClassVisitor; + } +} diff --git a/src/proguard/classfile/visitor/ClassPrinter.java b/src/proguard/classfile/visitor/ClassPrinter.java new file mode 100644 index 0000000..1da7d16 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassPrinter.java @@ -0,0 +1,954 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; + +import java.io.PrintStream; + + +/** + * This ClassVisitor prints out the complete internal + * structure of the classes it visits. + * + * @author Eric Lafortune + */ +public class ClassPrinter +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor, + AttributeVisitor, + ExceptionInfoVisitor, + InnerClassesInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LineNumberInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor, + InstructionVisitor +{ + private static final String INDENTATION = " "; + + private final PrintStream ps; + private int indentation; + + + /** + * Creates a new ClassPrinter that prints to System.out. + */ + public ClassPrinter() + { + this(System.out); + } + + + /** + * Creates a new ClassPrinter that prints to the given + * PrintStream. + */ + public ClassPrinter(PrintStream printStream) + { + ps = printStream; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + println("_____________________________________________________________________"); + println(visitorInfo(programClass) + " " + + "Program class: " + programClass.getName()); + indent(); + println("Superclass: " + programClass.getSuperName()); + println("Major version: 0x" + Integer.toHexString(ClassUtil.internalMajorClassVersion(programClass.u4version))); + println("Minor version: 0x" + Integer.toHexString(ClassUtil.internalMinorClassVersion(programClass.u4version))); + println("Access flags: 0x" + Integer.toHexString(programClass.u2accessFlags)); + println(" = " + + ((programClass.u2accessFlags & ClassConstants.INTERNAL_ACC_ANNOTATTION) != 0 ? "@ " : "") + + ClassUtil.externalClassAccessFlags(programClass.u2accessFlags) + + ((programClass.u2accessFlags & ClassConstants.INTERNAL_ACC_ENUM) != 0 ? "enum " : + (programClass.u2accessFlags & ClassConstants.INTERNAL_ACC_INTERFACE) == 0 ? "class " : + "") + + ClassUtil.externalClassName(programClass.getName()) + + (programClass.u2superClass == 0 ? "" : " extends " + + ClassUtil.externalClassName(programClass.getSuperName()))); + outdent(); + println(); + + println("Interfaces (count = " + programClass.u2interfacesCount + "):"); + indent(); + programClass.interfaceConstantsAccept(this); + outdent(); + println(); + + println("Constant Pool (count = " + programClass.u2constantPoolCount + "):"); + indent(); + programClass.constantPoolEntriesAccept(this); + outdent(); + println(); + + println("Fields (count = " + programClass.u2fieldsCount + "):"); + indent(); + programClass.fieldsAccept(this); + outdent(); + println(); + + println("Methods (count = " + programClass.u2methodsCount + "):"); + indent(); + programClass.methodsAccept(this); + outdent(); + println(); + + println("Class file attributes (count = " + programClass.u2attributesCount + "):"); + indent(); + programClass.attributesAccept(this); + outdent(); + println(); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + println("_____________________________________________________________________"); + println(visitorInfo(libraryClass) + " " + + "Library class: " + libraryClass.getName()); + indent(); + println("Superclass: " + libraryClass.getSuperName()); + println("Access flags: 0x" + Integer.toHexString(libraryClass.u2accessFlags)); + println(" = " + + ((libraryClass.u2accessFlags & ClassConstants.INTERNAL_ACC_ANNOTATTION) != 0 ? "@ " : "") + + ClassUtil.externalClassAccessFlags(libraryClass.u2accessFlags) + + ((libraryClass.u2accessFlags & ClassConstants.INTERNAL_ACC_ENUM) != 0 ? "enum " : + (libraryClass.u2accessFlags & ClassConstants.INTERNAL_ACC_INTERFACE) == 0 ? "class " : + "") + + ClassUtil.externalClassName(libraryClass.getName()) + + (libraryClass.getSuperName() == null ? "" : " extends " + + ClassUtil.externalClassName(libraryClass.getSuperName()))); + outdent(); + println(); + + println("Interfaces (count = " + libraryClass.interfaceClasses.length + "):"); + for (int index = 0; index < libraryClass.interfaceClasses.length; index++) + { + Clazz interfaceClass = libraryClass.interfaceClasses[index]; + if (interfaceClass != null) + { + println(" + " + interfaceClass.getName()); + } + } + + println("Fields (count = " + libraryClass.fields.length + "):"); + libraryClass.fieldsAccept(this); + + println("Methods (count = " + libraryClass.methods.length + "):"); + libraryClass.methodsAccept(this); + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + println(visitorInfo(integerConstant) + " Integer [" + + integerConstant.getValue() + "]"); + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + println(visitorInfo(longConstant) + " Long [" + + longConstant.getValue() + "]"); + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + println(visitorInfo(floatConstant) + " Float [" + + floatConstant.getValue() + "]"); + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + println(visitorInfo(doubleConstant) + " Double [" + + doubleConstant.getValue() + "]"); + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + println(visitorInfo(stringConstant) + " String [" + + clazz.getString(stringConstant.u2stringIndex) + "]"); + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + println(visitorInfo(utf8Constant) + " Utf8 [" + + utf8Constant.getString() + "]"); + } + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + println(visitorInfo(fieldrefConstant) + " Fieldref [" + + clazz.getClassName(fieldrefConstant.u2classIndex) + "." + + clazz.getName(fieldrefConstant.u2nameAndTypeIndex) + " " + + clazz.getType(fieldrefConstant.u2nameAndTypeIndex) + "]"); + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + println(visitorInfo(interfaceMethodrefConstant) + " InterfaceMethodref [" + + clazz.getClassName(interfaceMethodrefConstant.u2classIndex) + "." + + clazz.getName(interfaceMethodrefConstant.u2nameAndTypeIndex) + " " + + clazz.getType(interfaceMethodrefConstant.u2nameAndTypeIndex) + "]"); + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + println(visitorInfo(methodrefConstant) + " Methodref [" + + clazz.getClassName(methodrefConstant.u2classIndex) + "." + + clazz.getName(methodrefConstant.u2nameAndTypeIndex) + " " + + clazz.getType(methodrefConstant.u2nameAndTypeIndex) + "]"); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + println(visitorInfo(classConstant) + " Class [" + + clazz.getString(classConstant.u2nameIndex) + "]"); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + println(visitorInfo(nameAndTypeConstant) + " NameAndType [" + + clazz.getString(nameAndTypeConstant.u2nameIndex) + " " + + clazz.getString(nameAndTypeConstant.u2descriptorIndex) + "]"); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + println(visitorInfo(programField) + " " + + "Field: " + + programField.getName(programClass) + " " + + programField.getDescriptor(programClass)); + + indent(); + println("Access flags: 0x" + Integer.toHexString(programField.u2accessFlags)); + println(" = " + + ClassUtil.externalFullFieldDescription(programField.u2accessFlags, + programField.getName(programClass), + programField.getDescriptor(programClass))); + + visitMember(programClass, programField); + outdent(); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + println(visitorInfo(programMethod) + " " + + "Method: " + + programMethod.getName(programClass) + + programMethod.getDescriptor(programClass)); + + indent(); + println("Access flags: 0x" + Integer.toHexString(programMethod.u2accessFlags)); + println(" = " + + ClassUtil.externalFullMethodDescription(programClass.getName(), + programMethod.u2accessFlags, + programMethod.getName(programClass), + programMethod.getDescriptor(programClass))); + + visitMember(programClass, programMethod); + outdent(); + } + + + private void visitMember(ProgramClass programClass, ProgramMember programMember) + { + if (programMember.u2attributesCount > 0) + { + println("Class member attributes (count = " + programMember.u2attributesCount + "):"); + programMember.attributesAccept(programClass, this); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + println(visitorInfo(libraryField) + " " + + "Field: " + + libraryField.getName(libraryClass) + " " + + libraryField.getDescriptor(libraryClass)); + + indent(); + println("Access flags: 0x" + Integer.toHexString(libraryField.u2accessFlags)); + println(" = " + + ClassUtil.externalFullFieldDescription(libraryField.u2accessFlags, + libraryField.getName(libraryClass), + libraryField.getDescriptor(libraryClass))); + outdent(); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + println(visitorInfo(libraryMethod) + " " + + "Method: " + + libraryMethod.getName(libraryClass) + " " + + libraryMethod.getDescriptor(libraryClass)); + + indent(); + println("Access flags: 0x" + Integer.toHexString(libraryMethod.u2accessFlags)); + println(" = " + + ClassUtil.externalFullMethodDescription(libraryClass.getName(), + libraryMethod.u2accessFlags, + libraryMethod.getName(libraryClass), + libraryMethod.getDescriptor(libraryClass))); + outdent(); + } + + + // Implementations for AttributeVisitor. + // Note that attributes are typically only referenced once, so we don't + // test if they are marked already. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + println(visitorInfo(unknownAttribute) + + " Unknown attribute (" + clazz.getString(unknownAttribute.u2attributeNameIndex) + ")"); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + println(visitorInfo(sourceFileAttribute) + + " Source file attribute:"); + + indent(); + clazz.constantPoolEntryAccept(sourceFileAttribute.u2sourceFileIndex, this); + outdent(); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + println(visitorInfo(sourceDirAttribute) + + " Source dir attribute:"); + + indent(); + clazz.constantPoolEntryAccept(sourceDirAttribute.u2sourceDirIndex, this); + outdent(); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + println(visitorInfo(innerClassesAttribute) + + " Inner classes attribute (count = " + innerClassesAttribute.u2classesCount + ")"); + + indent(); + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + outdent(); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + println(visitorInfo(enclosingMethodAttribute) + + " Enclosing method attribute:"); + + indent(); + clazz.constantPoolEntryAccept(enclosingMethodAttribute.u2classIndex, this); + + if (enclosingMethodAttribute.u2nameAndTypeIndex != 0) + { + clazz.constantPoolEntryAccept(enclosingMethodAttribute.u2nameAndTypeIndex, this); + } + outdent(); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + println(visitorInfo(deprecatedAttribute) + + " Deprecated attribute"); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + println(visitorInfo(syntheticAttribute) + + " Synthetic attribute"); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + println(visitorInfo(signatureAttribute) + + " Signature attribute:"); + + indent(); + clazz.constantPoolEntryAccept(signatureAttribute.u2signatureIndex, this); + outdent(); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + println(visitorInfo(constantValueAttribute) + + " Constant value attribute:"); + + clazz.constantPoolEntryAccept(constantValueAttribute.u2constantValueIndex, this); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + println(visitorInfo(exceptionsAttribute) + + " Exceptions attribute (count = " + exceptionsAttribute.u2exceptionIndexTableLength + ")"); + + indent(); + exceptionsAttribute.exceptionEntriesAccept((ProgramClass)clazz, this); + outdent(); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + println(visitorInfo(codeAttribute) + + " Code attribute instructions (code length = "+ codeAttribute.u4codeLength + + ", locals = "+ codeAttribute.u2maxLocals + + ", stack = "+ codeAttribute.u2maxStack + "):"); + + indent(); + + codeAttribute.instructionsAccept(clazz, method, this); + + println("Code attribute exceptions (count = " + + codeAttribute.u2exceptionTableLength + "):"); + + codeAttribute.exceptionsAccept(clazz, method, this); + + println("Code attribute attributes (attribute count = " + + codeAttribute.u2attributesCount + "):"); + + codeAttribute.attributesAccept(clazz, method, this); + + outdent(); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + println(visitorInfo(codeAttribute) + + " Stack map attribute (count = "+ + stackMapAttribute.u2stackMapFramesCount + "):"); + + indent(); + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + outdent(); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + println(visitorInfo(codeAttribute) + + " Stack map table attribute (count = "+ + stackMapTableAttribute.u2stackMapFramesCount + "):"); + + indent(); + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + outdent(); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + println(visitorInfo(lineNumberTableAttribute) + + " Line number table attribute (count = " + + lineNumberTableAttribute.u2lineNumberTableLength + ")"); + + indent(); + lineNumberTableAttribute.lineNumbersAccept(clazz, method, codeAttribute, this); + outdent(); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + println(visitorInfo(localVariableTableAttribute) + + " Local variable table attribute (count = " + + localVariableTableAttribute.u2localVariableTableLength + ")"); + + indent(); + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + outdent(); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + println(visitorInfo(localVariableTypeTableAttribute) + + " Local variable type table attribute (count = "+ + localVariableTypeTableAttribute.u2localVariableTypeTableLength + ")"); + + indent(); + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + outdent(); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + println(visitorInfo(runtimeVisibleAnnotationsAttribute) + + " Runtime visible annotations attribute:"); + + indent(); + runtimeVisibleAnnotationsAttribute.annotationsAccept(clazz, this); + outdent(); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + println(visitorInfo(runtimeInvisibleAnnotationsAttribute) + + " Runtime invisible annotations attribute:"); + + indent(); + runtimeInvisibleAnnotationsAttribute.annotationsAccept(clazz, this); + outdent(); + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + println(visitorInfo(runtimeVisibleParameterAnnotationsAttribute) + + " Runtime visible parameter annotations attribute (parameter count = " + runtimeVisibleParameterAnnotationsAttribute.u2parametersCount + "):"); + + indent(); + runtimeVisibleParameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + outdent(); + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + println(visitorInfo(runtimeInvisibleParameterAnnotationsAttribute) + + " Runtime invisible parameter annotations attribute (parameter count = " + runtimeInvisibleParameterAnnotationsAttribute.u2parametersCount + "):"); + + indent(); + runtimeInvisibleParameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + outdent(); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + println(visitorInfo(annotationDefaultAttribute) + + " Annotation default attribute:"); + + indent(); + annotationDefaultAttribute.defaultValueAccept(clazz, this); + outdent(); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + println(visitorInfo(innerClassesInfo) + + " InnerClassesInfo:"); + + indent(); + innerClassesInfo.innerClassConstantAccept(clazz, this); + innerClassesInfo.outerClassConstantAccept(clazz, this); + innerClassesInfo.innerNameConstantAccept(clazz, this); + outdent(); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + println(instruction.toString(offset)); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + println(constantInstruction.toString(offset)); + + indent(); + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + outdent(); + } + + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + println(tableSwitchInstruction.toString(offset)); + + indent(); + + int[] jumpOffsets = tableSwitchInstruction.jumpOffsets; + + for (int index = 0; index < jumpOffsets.length; index++) + { + int jumpOffset = jumpOffsets[index]; + println(Integer.toString(tableSwitchInstruction.lowCase + index) + ": offset = " + jumpOffset + ", target = " + (offset + jumpOffset)); + } + + int defaultOffset = tableSwitchInstruction.defaultOffset; + println("default: offset = " + defaultOffset + ", target = "+ (offset + defaultOffset)); + + outdent(); + } + + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + println(lookUpSwitchInstruction.toString(offset)); + + indent(); + + int[] cases = lookUpSwitchInstruction.cases; + int[] jumpOffsets = lookUpSwitchInstruction.jumpOffsets; + + for (int index = 0; index < jumpOffsets.length; index++) + { + int jumpOffset = jumpOffsets[index]; + println(Integer.toString(cases[index]) + ": offset = " + jumpOffset + ", target = " + (offset + jumpOffset)); + } + + int defaultOffset = lookUpSwitchInstruction.defaultOffset; + println("default: offset = " + defaultOffset + ", target = "+ (offset + defaultOffset)); + + outdent(); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + println(visitorInfo(exceptionInfo) + + " ExceptionInfo (" + + exceptionInfo.u2startPC + " -> " + + exceptionInfo.u2endPC + ": " + + exceptionInfo.u2handlerPC + "):"); + + if (exceptionInfo.u2catchType != 0) + { + clazz.constantPoolEntryAccept(exceptionInfo.u2catchType, this); + } + } + + + // Implementations for StackMapFrameVisitor. + + public void visitSameZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameZeroFrame sameZeroFrame) + { + println(visitorInfo(sameZeroFrame) + + " [" + offset + "]" + + " Var: ..., Stack: (empty)"); + } + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + print(visitorInfo(sameOneFrame) + + " [" + offset + "]" + + " Var: ..., Stack: "); + + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + + println(); + } + + + public void visitLessZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LessZeroFrame lessZeroFrame) + { + println(visitorInfo(lessZeroFrame) + + " [" + offset + "]" + + " Var: -" + lessZeroFrame.choppedVariablesCount + + ", Stack: (empty)"); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + print(visitorInfo(moreZeroFrame) + + " [" + offset + "]" + + " Var: ..."); + + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + + ps.println(", Stack: (empty)"); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + print(visitorInfo(fullFrame) + + " [" + offset + "]" + + " Var: "); + + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + + ps.print(", Stack: "); + + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + + println(); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitIntegerType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, IntegerType integerType) + { + ps.print("[i]"); + } + + + public void visitFloatType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FloatType floatType) + { + ps.print("[f]"); + } + + + public void visitLongType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LongType longType) + { + ps.print("[l]"); + } + + + public void visitDoubleType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, DoubleType doubleType) + { + ps.print("[d]"); + } + + + public void visitTopType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TopType topType) + { + ps.print("[T]"); + } + + + public void visitObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType) + { + ps.print("[a:" + clazz.getClassName(objectType.u2classIndex) + "]"); + } + + + public void visitNullType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, NullType nullType) + { + ps.print("[n]"); + } + + + public void visitUninitializedType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedType uninitializedType) + { + ps.print("[u:" + uninitializedType.u2newInstructionOffset + "]"); + } + + + public void visitUninitializedThisType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, UninitializedThisType uninitializedThisType) + { + ps.print("[u:this]"); + } + + + // Implementations for LineNumberInfoVisitor. + + public void visitLineNumberInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberInfo lineNumberInfo) + { + println("[" + lineNumberInfo.u2startPC + "] -> line " + + lineNumberInfo.u2lineNumber); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + println("#" + localVariableInfo.u2index + ": " + + localVariableInfo.u2startPC + " -> " + + (localVariableInfo.u2startPC + localVariableInfo.u2length) + " [" + + clazz.getString(localVariableInfo.u2descriptorIndex) + " " + + clazz.getString(localVariableInfo.u2nameIndex) + "]"); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + println("#" + localVariableTypeInfo.u2index + ": " + + localVariableTypeInfo.u2startPC + " -> " + + (localVariableTypeInfo.u2startPC + localVariableTypeInfo.u2length) + " [" + + clazz.getString(localVariableTypeInfo.u2signatureIndex) + " " + + clazz.getString(localVariableTypeInfo.u2nameIndex) + "]"); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + println(visitorInfo(annotation) + + " Annotation [" + clazz.getString(annotation.u2typeIndex) + "]:"); + + indent(); + annotation.elementValuesAccept(clazz, this); + outdent(); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + println(visitorInfo(constantElementValue) + + " Constant element value [" + + (constantElementValue.u2elementNameIndex == 0 ? "(default)" : + clazz.getString(constantElementValue.u2elementNameIndex)) + " '" + + constantElementValue.u1tag + "']"); + + indent(); + clazz.constantPoolEntryAccept(constantElementValue.u2constantValueIndex, this); + outdent(); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + println(visitorInfo(enumConstantElementValue) + + " Enum constant element value [" + + (enumConstantElementValue.u2elementNameIndex == 0 ? "(default)" : + clazz.getString(enumConstantElementValue.u2elementNameIndex)) + ", " + + clazz.getString(enumConstantElementValue.u2typeNameIndex) + ", " + + clazz.getString(enumConstantElementValue.u2constantNameIndex) + "]"); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + println(visitorInfo(classElementValue) + + " Class element value [" + + (classElementValue.u2elementNameIndex == 0 ? "(default)" : + clazz.getString(classElementValue.u2elementNameIndex)) + ", " + + clazz.getString(classElementValue.u2classInfoIndex) + "]"); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + println(visitorInfo(annotationElementValue) + + " Annotation element value [" + + (annotationElementValue.u2elementNameIndex == 0 ? "(default)" : + clazz.getString(annotationElementValue.u2elementNameIndex)) + "]:"); + + indent(); + annotationElementValue.annotationAccept(clazz, this); + outdent(); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + println(visitorInfo(arrayElementValue) + + " Array element value [" + + (arrayElementValue.u2elementNameIndex == 0 ? "(default)" : + clazz.getString(arrayElementValue.u2elementNameIndex)) + "]:"); + + indent(); + arrayElementValue.elementValuesAccept(clazz, annotation, this); + outdent(); + } + + + // Small utility methods. + + private void indent() + { + indentation++; + } + + private void outdent() + { + indentation--; + } + + private void println(String string) + { + print(string); + println(); + + } + + private void print(String string) + { + for (int index = 0; index < indentation; index++) + { + ps.print(INDENTATION); + } + + ps.print(string); + } + + private void println() + { + ps.println(); + } + + + private String visitorInfo(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() == null ? "-" : "+"; + } +} diff --git a/src/proguard/classfile/visitor/ClassVersionFilter.java b/src/proguard/classfile/visitor/ClassVersionFilter.java new file mode 100644 index 0000000..578cabf --- /dev/null +++ b/src/proguard/classfile/visitor/ClassVersionFilter.java @@ -0,0 +1,72 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor delegates its visits to program classes to + * another given ClassVisitor, but only when the class version + * number of the visited program class lies in a given range. + * + * @author Eric Lafortune + */ +public class ClassVersionFilter implements ClassVisitor +{ + private final int minimumClassVersion; + private final int maximumClassVersion; + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassVersionFilter. + * @param minimumClassVersion the minimum class version number. + * @param maximumClassVersion the maximum class version number. + * @param classVisitor the ClassVisitor to which visits + * will be delegated. + */ + public ClassVersionFilter(int minimumClassVersion, + int maximumClassVersion, + ClassVisitor classVisitor) + { + this.minimumClassVersion = minimumClassVersion; + this.maximumClassVersion = maximumClassVersion; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (programClass.u4version >= minimumClassVersion && + programClass.u4version <= maximumClassVersion) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Library classes don't have version numbers. + } +} diff --git a/src/proguard/classfile/visitor/ClassVersionSetter.java b/src/proguard/classfile/visitor/ClassVersionSetter.java new file mode 100644 index 0000000..34dfbc1 --- /dev/null +++ b/src/proguard/classfile/visitor/ClassVersionSetter.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +import java.util.Set; + +/** + * This ClassVisitor sets the version number of the program classes + * that it visits. + * + * @author Eric Lafortune + */ +public class ClassVersionSetter implements ClassVisitor +{ + private final int classVersion; + + private final Set newerClassVersions; + + + /** + * Creates a new ClassVersionSetter. + * @param classVersion the class version number. + */ + public ClassVersionSetter(int classVersion) + { + this(classVersion, null); + } + + + /** + * Creates a new ClassVersionSetter that also stores any newer class version + * numbers that it encounters while visiting program classes. + * @param classVersion the class version number. + * @param newerClassVersions the Set in which newer class + * version numbers can be collected. + */ + public ClassVersionSetter(int classVersion, + Set newerClassVersions) + { + this.classVersion = classVersion; + this.newerClassVersions = newerClassVersions; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (programClass.u4version > classVersion && + newerClassVersions != null) + { + newerClassVersions.add(new Integer(programClass.u4version)); + } + + programClass.u4version = classVersion; + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Library classes don't have version numbers. + } +} diff --git a/src/proguard/classfile/visitor/ClassVisitor.java b/src/proguard/classfile/visitor/ClassVisitor.java new file mode 100644 index 0000000..fdba2df --- /dev/null +++ b/src/proguard/classfile/visitor/ClassVisitor.java @@ -0,0 +1,36 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This interface specifies the methods for a visitor of + * Clazz objects. + * + * @author Eric Lafortune + */ +public interface ClassVisitor +{ + public void visitProgramClass(ProgramClass programClass); + public void visitLibraryClass(LibraryClass libraryClass); +} diff --git a/src/proguard/classfile/visitor/ConcreteClassDownTraveler.java b/src/proguard/classfile/visitor/ConcreteClassDownTraveler.java new file mode 100644 index 0000000..ec3fe68 --- /dev/null +++ b/src/proguard/classfile/visitor/ConcreteClassDownTraveler.java @@ -0,0 +1,100 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor lets a given ClassVisitor + * travel to the first concrete subclasses down in its hierarchy of abstract + * classes and concrete classes. + * + * @author Eric Lafortune + */ +public class ConcreteClassDownTraveler +implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new ConcreteClassDownTraveler. + * @param classVisitor the ClassVisitor to + * which visits will be delegated. + */ + public ConcreteClassDownTraveler(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Is this an abstract class or an interface? + if ((programClass.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) != 0) + { + // Travel down the hierarchy. + Clazz[] subClasses = programClass.subClasses; + if (subClasses != null) + { + for (int index = 0; index < subClasses.length; index++) + { + subClasses[index].accept(this); + } + } + } + else + { + // Visit the class. Don't descend any further. + programClass.accept(classVisitor); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Is this an abstract class or interface? + if ((libraryClass.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) != 0) + { + // Travel down the hierarchy. + Clazz[] subClasses = libraryClass.subClasses; + if (subClasses != null) + { + for (int index = 0; index < subClasses.length; index++) + { + subClasses[index].accept(this); + } + } + } + else + { + // Visit the class. Don't descend any further. + libraryClass.accept(classVisitor); + } + } +} diff --git a/src/proguard/classfile/visitor/DotClassClassVisitor.java b/src/proguard/classfile/visitor/DotClassClassVisitor.java new file mode 100644 index 0000000..263dbd5 --- /dev/null +++ b/src/proguard/classfile/visitor/DotClassClassVisitor.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + + +/** + * This InstructionVisitor lets a given ClassVisitor visit all + * classes involved in any .class constructs that it visits. + *

    + * Note that before JDK 1.5, .class constructs are actually + * compiled differently, using Class.forName constructs. + * + * @see ClassForNameClassVisitor + * + * @author Eric Lafortune + */ +public class DotClassClassVisitor +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassHierarchyTraveler. + * @param classVisitor the ClassVisitor to which visits will + * be delegated. + */ + public DotClassClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + byte opcode = constantInstruction.opcode; + + // Could this instruction be a .class construct? + if (opcode == InstructionConstants.OP_LDC || + opcode == InstructionConstants.OP_LDC_W) + { + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, + this); + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Visit the referenced class from the .class construct. + classConstant.referencedClassAccept(classVisitor); + } +} diff --git a/src/proguard/classfile/visitor/ExceptClassFilter.java b/src/proguard/classfile/visitor/ExceptClassFilter.java new file mode 100644 index 0000000..924485e --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptClassFilter.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, except for one given class. + * + * @author Eric Lafortune + */ +public class ExceptClassFilter implements ClassVisitor +{ + private final Clazz exceptClass; + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassNameFilter. + * @param exceptClass the class that will not be visited. + * @param classVisitor the ClassVisitor to which visits will + * be delegated. + */ + public ExceptClassFilter(Clazz exceptClass, + ClassVisitor classVisitor) + { + this.exceptClass = exceptClass; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (!programClass.equals(exceptClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (!libraryClass.equals(exceptClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/ExceptClassesFilter.java b/src/proguard/classfile/visitor/ExceptClassesFilter.java new file mode 100644 index 0000000..7380c40 --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptClassesFilter.java @@ -0,0 +1,90 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, except for classes are in a given list. + * + * @author Eric Lafortune + */ +public class ExceptClassesFilter implements ClassVisitor +{ + private final Clazz[] exceptClasses; + private final ClassVisitor classVisitor; + + + /** + * Creates a new ExceptClassesFilter. + * @param exceptClasses the classes that will not be visited. + * @param classVisitor the ClassVisitor to which visits will + * be delegated. + */ + public ExceptClassesFilter(Clazz[] exceptClasses, + ClassVisitor classVisitor) + { + this.exceptClasses = exceptClasses; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (!present(programClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (!present(libraryClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } + + + // Small utility methods. + + private boolean present(Clazz clazz) + { + if (exceptClasses == null) + { + return false; + } + + for (int index = 0; index < exceptClasses.length; index++) + { + if (exceptClasses[index].equals(clazz)) + { + return true; + } + } + + return false; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/ExceptionCounter.java b/src/proguard/classfile/visitor/ExceptionCounter.java new file mode 100644 index 0000000..c324129 --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptionCounter.java @@ -0,0 +1,52 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor counts the number of exceptions that has been visited. + * + * @author Eric Lafortune + */ +public class ExceptionCounter implements ExceptionInfoVisitor +{ + private int count; + + + /** + * Returns the number of exceptions that has been visited so far. + */ + public int getCount() + { + return count; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + count++; + } +} diff --git a/src/proguard/classfile/visitor/ExceptionExcludedOffsetFilter.java b/src/proguard/classfile/visitor/ExceptionExcludedOffsetFilter.java new file mode 100644 index 0000000..3911e39 --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptionExcludedOffsetFilter.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor delegates its visits to another given + * ExceptionInfoVisitor, but only when the visited exception + * does not cover the instruction at the given offset. + * + * @author Eric Lafortune + */ +public class ExceptionExcludedOffsetFilter +implements ExceptionInfoVisitor +{ + private final int instructionOffset; + private final ExceptionInfoVisitor exceptionInfoVisitor; + + + /** + * Creates a new ExceptionExcludedOffsetFilter. + * @param instructionOffset the instruction offset. + * @param exceptionInfoVisitor the ExceptionInfoVisitor to which visits + * will be delegated. + */ + public ExceptionExcludedOffsetFilter(int instructionOffset, + ExceptionInfoVisitor exceptionInfoVisitor) + { + this.instructionOffset = instructionOffset; + this.exceptionInfoVisitor = exceptionInfoVisitor; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + if (!exceptionInfo.isApplicable(instructionOffset)) + { + exceptionInfoVisitor.visitExceptionInfo(clazz, method, codeAttribute, exceptionInfo); + } + } +} diff --git a/src/proguard/classfile/visitor/ExceptionHandlerConstantVisitor.java b/src/proguard/classfile/visitor/ExceptionHandlerConstantVisitor.java new file mode 100644 index 0000000..e0fdec3 --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptionHandlerConstantVisitor.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor lets a given + * ConstantVisitor visit all catch class constants of exceptions + * that it visits. + * + * @author Eric Lafortune + */ +public class ExceptionHandlerConstantVisitor +implements ExceptionInfoVisitor +{ + private final ConstantVisitor constantVisitor; + + + /** + * Creates a new ExceptionHandlerConstantVisitor. + * @param constantVisitor the ConstantVisitor that will visit the catch + * class constants. + */ + public ExceptionHandlerConstantVisitor(ConstantVisitor constantVisitor) + { + this.constantVisitor = constantVisitor; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + int catchType = exceptionInfo.u2catchType; + if (catchType != 0) + { + clazz.constantPoolEntryAccept(catchType, constantVisitor); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/ExceptionHandlerFilter.java b/src/proguard/classfile/visitor/ExceptionHandlerFilter.java new file mode 100644 index 0000000..a90fb56 --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptionHandlerFilter.java @@ -0,0 +1,70 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor delegates its visits to another given + * ExceptionInfoVisitor, but only when the visited exception + * targets an instruction in the given range of offsets. + * + * @author Eric Lafortune + */ +public class ExceptionHandlerFilter +implements ExceptionInfoVisitor +{ + private final int startOffset; + private final int endOffset; + private final ExceptionInfoVisitor exceptionInfoVisitor; + + + /** + * Creates a new ExceptionHandlerFilter. + * @param startOffset the start of the instruction offset range. + * @param endOffset the end of the instruction offset range. + * @param exceptionInfoVisitor the ExceptionInfoVisitor to which visits + * will be delegated. + */ + public ExceptionHandlerFilter(int startOffset, + int endOffset, + ExceptionInfoVisitor exceptionInfoVisitor) + { + this.startOffset = startOffset; + this.endOffset = endOffset; + this.exceptionInfoVisitor = exceptionInfoVisitor; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + int handlerPC = exceptionInfo.u2handlerPC; + if (handlerPC >= startOffset && + handlerPC < endOffset) + { + exceptionInfoVisitor.visitExceptionInfo(clazz, method, codeAttribute, exceptionInfo); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/ExceptionOffsetFilter.java b/src/proguard/classfile/visitor/ExceptionOffsetFilter.java new file mode 100644 index 0000000..e2a4fc9 --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptionOffsetFilter.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor delegates its visits to another given + * ExceptionInfoVisitor, but only when the visited exception + * covers the instruction at the given offset. + * + * @author Eric Lafortune + */ +public class ExceptionOffsetFilter +implements ExceptionInfoVisitor +{ + private final int instructionOffset; + private final ExceptionInfoVisitor exceptionInfoVisitor; + + + /** + * Creates a new ExceptionOffsetFilter. + * @param instructionOffset the instruction offset. + * @param exceptionInfoVisitor the ExceptionInfoVisitor to which visits + * will be delegated. + */ + public ExceptionOffsetFilter(int instructionOffset, + ExceptionInfoVisitor exceptionInfoVisitor) + { + this.instructionOffset = instructionOffset; + this.exceptionInfoVisitor = exceptionInfoVisitor; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + if (exceptionInfo.isApplicable(instructionOffset)) + { + exceptionInfoVisitor.visitExceptionInfo(clazz, method, codeAttribute, exceptionInfo); + } + } +} diff --git a/src/proguard/classfile/visitor/ExceptionRangeFilter.java b/src/proguard/classfile/visitor/ExceptionRangeFilter.java new file mode 100644 index 0000000..c541b1f --- /dev/null +++ b/src/proguard/classfile/visitor/ExceptionRangeFilter.java @@ -0,0 +1,68 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.ExceptionInfoVisitor; + +/** + * This ExceptionInfoVisitor delegates its visits to another given + * ExceptionInfoVisitor, but only when the visited exception + * overlaps with the given instruction range. + * + * @author Eric Lafortune + */ +public class ExceptionRangeFilter +implements ExceptionInfoVisitor +{ + private final int startOffset; + private final int endOffset; + private final ExceptionInfoVisitor exceptionInfoVisitor; + + + /** + * Creates a new ExceptionRangeFilter. + * @param startOffset the start offset of the instruction range. + * @param endOffset the end offset of the instruction range. + * @param exceptionInfoVisitor the ExceptionInfoVisitor to which visits + * will be delegated. + */ + public ExceptionRangeFilter(int startOffset, + int endOffset, + ExceptionInfoVisitor exceptionInfoVisitor) + { + this.startOffset = startOffset; + this.endOffset = endOffset; + this.exceptionInfoVisitor = exceptionInfoVisitor; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + if (exceptionInfo.isApplicable(startOffset, endOffset)) + { + exceptionInfoVisitor.visitExceptionInfo(clazz, method, codeAttribute, exceptionInfo); + } + } +} diff --git a/src/proguard/classfile/visitor/ImplementedClassConstantFilter.java b/src/proguard/classfile/visitor/ImplementedClassConstantFilter.java new file mode 100644 index 0000000..6fe2e7d --- /dev/null +++ b/src/proguard/classfile/visitor/ImplementedClassConstantFilter.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor delegates its visits to class constants + * to another given ConstantVisitor, except for classes that + * extend or implement a given class. This exception includes the class itself. + * + * @author Eric Lafortune + */ +public class ImplementedClassConstantFilter +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final Clazz implementedClass; + private final ConstantVisitor constantVisitor; + + + /** + * Creates a new ImplementedClassConstantFilter. + * @param implementedClass the class whose implementations will not be + * visited. + * @param constantVisitor the ConstantVisitor to which visits + * will be delegated. + */ + public ImplementedClassConstantFilter(Clazz implementedClass, + ConstantVisitor constantVisitor) + { + this.implementedClass = implementedClass; + this.constantVisitor = constantVisitor; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + Clazz referencedClass = classConstant.referencedClass; + if (referencedClass == null || + !referencedClass.extendsOrImplements(implementedClass)) + { + constantVisitor.visitClassConstant(clazz, classConstant); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/ImplementedClassFilter.java b/src/proguard/classfile/visitor/ImplementedClassFilter.java new file mode 100644 index 0000000..955a74e --- /dev/null +++ b/src/proguard/classfile/visitor/ImplementedClassFilter.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, except for classes that extend or implement + * a given class. + * + * @author Eric Lafortune + */ +public class ImplementedClassFilter implements ClassVisitor +{ + private final Clazz implementedClass; + private final ClassVisitor classVisitor; + + + /** + * Creates a new ImplementedClassFilter. + * @param implementedClass the class whose implementations will not be + * visited. + * @param classVisitor the ClassVisitor to which visits will + * be delegated. + */ + public ImplementedClassFilter(Clazz implementedClass, + ClassVisitor classVisitor) + { + this.implementedClass = implementedClass; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (!programClass.extendsOrImplements(implementedClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (!libraryClass.extendsOrImplements(implementedClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/ImplementingClassConstantFilter.java b/src/proguard/classfile/visitor/ImplementingClassConstantFilter.java new file mode 100644 index 0000000..9e9cea3 --- /dev/null +++ b/src/proguard/classfile/visitor/ImplementingClassConstantFilter.java @@ -0,0 +1,70 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor delegates its visits to class constants + * to another given ConstantVisitor, except for classes that + * are extended or implemented by a given class. This exception includes the + * class itself. + * + * @author Eric Lafortune + */ +public class ImplementingClassConstantFilter +extends SimplifiedVisitor +implements ConstantVisitor +{ + private final Clazz implementingClass; + private final ConstantVisitor constantVisitor; + + + /** + * Creates a new ImplementingClassConstantFilter. + * @param implementingClass the class whose superclasses and interfaces will + * not be visited. + * @param constantVisitor the ConstantVisitor to which visits + * will be delegated. + */ + public ImplementingClassConstantFilter(Clazz implementingClass, + ConstantVisitor constantVisitor) + { + this.implementingClass = implementingClass; + this.constantVisitor = constantVisitor; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + Clazz referencedClass = classConstant.referencedClass; + if (referencedClass == null || + !implementingClass.extendsOrImplements(referencedClass)) + { + constantVisitor.visitClassConstant(clazz, classConstant); + } + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/LibraryClassFilter.java b/src/proguard/classfile/visitor/LibraryClassFilter.java new file mode 100644 index 0000000..0e40f2f --- /dev/null +++ b/src/proguard/classfile/visitor/LibraryClassFilter.java @@ -0,0 +1,60 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, but only when visiting library classes. + * + * @author Eric Lafortune + */ +public class LibraryClassFilter implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new LibraryClassFilter. + * @param classVisitor the ClassVisitor to which visits + * will be delegated. + */ + public LibraryClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Don't delegate visits to program classes. + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + classVisitor.visitLibraryClass(libraryClass); + } +} diff --git a/src/proguard/classfile/visitor/LibraryMemberFilter.java b/src/proguard/classfile/visitor/LibraryMemberFilter.java new file mode 100644 index 0000000..0ee80e5 --- /dev/null +++ b/src/proguard/classfile/visitor/LibraryMemberFilter.java @@ -0,0 +1,73 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when visiting members of library + * classes. + * + * @author Eric Lafortune + */ +public class LibraryMemberFilter implements MemberVisitor +{ + private final MemberVisitor memberVisitor; + + + /** + * Creates a new ProgramMemberFilter. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public LibraryMemberFilter(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Don't delegate visits to program members. + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Don't delegate visits to program members. + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } +} diff --git a/src/proguard/classfile/visitor/MemberAccessFilter.java b/src/proguard/classfile/visitor/MemberAccessFilter.java new file mode 100644 index 0000000..6fd32e3 --- /dev/null +++ b/src/proguard/classfile/visitor/MemberAccessFilter.java @@ -0,0 +1,122 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when the visited member has the proper + * access flags. + *

    + * If conflicting access flags (public/private/protected) are specified, + * having one of them set will be considered sufficient. + * + * @see ClassConstants + * + * @author Eric Lafortune + */ +public class MemberAccessFilter +implements MemberVisitor +{ + // A mask of conflicting access flags. These are interpreted in a special + // way if more of them are required at the same time. In that case, one + // of them being set is sufficient. + private static final int ACCESS_MASK = + ClassConstants.INTERNAL_ACC_PUBLIC | + ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_PROTECTED; + + private final int requiredSetAccessFlags; + private final int requiredUnsetAccessFlags; + private final int requiredOneSetAccessFlags; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MemberAccessFilter. + * @param requiredSetAccessFlags the class access flags that should be + * set. + * @param requiredUnsetAccessFlags the class access flags that should be + * unset. + * @param memberVisitor the MemberVisitor to + * which visits will be delegated. + */ + public MemberAccessFilter(int requiredSetAccessFlags, + int requiredUnsetAccessFlags, + MemberVisitor memberVisitor) + { + this.requiredSetAccessFlags = requiredSetAccessFlags & ~ACCESS_MASK; + this.requiredUnsetAccessFlags = requiredUnsetAccessFlags; + this.requiredOneSetAccessFlags = requiredSetAccessFlags & ACCESS_MASK; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (accepted(programField.getAccessFlags())) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (accepted(programMethod.getAccessFlags())) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (accepted(libraryField.getAccessFlags())) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (accepted(libraryMethod.getAccessFlags())) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } + + + // Small utility methods. + + private boolean accepted(int accessFlags) + { + return (requiredSetAccessFlags & ~accessFlags) == 0 && + (requiredUnsetAccessFlags & accessFlags) == 0 && + (requiredOneSetAccessFlags == 0 || + (requiredOneSetAccessFlags & accessFlags) != 0); + } +} diff --git a/src/proguard/classfile/visitor/MemberClassAccessFilter.java b/src/proguard/classfile/visitor/MemberClassAccessFilter.java new file mode 100644 index 0000000..85272ff --- /dev/null +++ b/src/proguard/classfile/visitor/MemberClassAccessFilter.java @@ -0,0 +1,106 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.util.*; + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when the visited member is accessible + * from the given referencing class. + * + * @author Eric Lafortune + */ +public class MemberClassAccessFilter +implements MemberVisitor +{ + private final Clazz referencingClass; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MemberAccessFilter. + * @param referencingClass the class that is accessing the member. + * @param memberVisitor the MemberVisitor to which visits + * will be delegated. + */ + public MemberClassAccessFilter(Clazz referencingClass, + MemberVisitor memberVisitor) + { + this.referencingClass = referencingClass; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (accepted(programClass, programField.getAccessFlags())) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (accepted(programClass, programMethod.getAccessFlags())) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (accepted(libraryClass, libraryField.getAccessFlags())) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (accepted(libraryClass, libraryMethod.getAccessFlags())) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } + + + // Small utility methods. + + private boolean accepted(Clazz clazz, int memberAccessFlags) + { + int accessLevel = AccessUtil.accessLevel(memberAccessFlags); + + return + (accessLevel >= AccessUtil.PUBLIC ) || + (accessLevel >= AccessUtil.PRIVATE && referencingClass.equals(clazz) ) || + (accessLevel >= AccessUtil.PACKAGE_VISIBLE && (ClassUtil.internalPackageName(referencingClass.getName()).equals( + ClassUtil.internalPackageName(clazz.getName())))) || + (accessLevel >= AccessUtil.PROTECTED && (referencingClass.extends_(clazz) || + referencingClass.extendsOrImplements(clazz)) ); + } +} diff --git a/src/proguard/classfile/visitor/MemberCollector.java b/src/proguard/classfile/visitor/MemberCollector.java new file mode 100644 index 0000000..ec68b2d --- /dev/null +++ b/src/proguard/classfile/visitor/MemberCollector.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; + +import java.util.Set; + +/** + * This MemberVisitor collects the concatenated name/descriptor strings of + * class members that have been visited. + * + * @author Eric Lafortune + */ +public class MemberCollector +extends SimplifiedVisitor +implements MemberVisitor +{ + private final Set set; + + + /** + * Creates a new MemberCollector. + * @param set the Set in which all method names/descriptor + * strings will be collected. + */ + public MemberCollector(Set set) + { + this.set = set; + } + + + // Implementations for MemberVisitor. + + + public void visitAnyMember(Clazz clazz, Member member) + { + set.add(member.getName(clazz) + member.getDescriptor(clazz)); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/MemberCounter.java b/src/proguard/classfile/visitor/MemberCounter.java new file mode 100644 index 0000000..c2da72e --- /dev/null +++ b/src/proguard/classfile/visitor/MemberCounter.java @@ -0,0 +1,72 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This MemberVisitor counts the number of class members that have been visited. + * + * @author Eric Lafortune + */ +public class MemberCounter implements MemberVisitor +{ + private int count; + + + /** + * Returns the number of class members that has been visited so far. + */ + public int getCount() + { + return count; + } + + + // Implementations for MemberVisitor. + + public void visitLibraryField(LibraryClass libraryClass, + LibraryField libraryField) + { + count++; + } + + + public void visitLibraryMethod(LibraryClass libraryClass, + LibraryMethod libraryMethod) + { + count++; + } + + + public void visitProgramField(ProgramClass programClass, + ProgramField programField) + { + count++; + } + + + public void visitProgramMethod(ProgramClass programClass, + ProgramMethod programMethod) + { + count++; + } +} diff --git a/src/proguard/classfile/visitor/MemberDescriptorFilter.java b/src/proguard/classfile/visitor/MemberDescriptorFilter.java new file mode 100644 index 0000000..bd69304 --- /dev/null +++ b/src/proguard/classfile/visitor/MemberDescriptorFilter.java @@ -0,0 +1,113 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.util.*; + + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when the visited member + * has a descriptor that matches a given regular expression. + * + * @author Eric Lafortune + */ +public class MemberDescriptorFilter implements MemberVisitor +{ + private final StringMatcher regularExpressionMatcher; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MemberDescriptorFilter. + * @param regularExpression the regular expression against which member + * descriptors will be matched. + * @param memberVisitor the MemberVisitor to which visits + * will be delegated. + */ + public MemberDescriptorFilter(String regularExpression, + MemberVisitor memberVisitor) + { + this(new ClassNameParser().parse(regularExpression), memberVisitor); + } + + + /** + * Creates a new MemberDescriptorFilter. + * @param regularExpressionMatcher the regular expression against which + * member descriptors will be matched. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public MemberDescriptorFilter(StringMatcher regularExpressionMatcher, + MemberVisitor memberVisitor) + { + this.regularExpressionMatcher = regularExpressionMatcher; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (accepted(programField.getDescriptor(programClass))) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (accepted(programMethod.getDescriptor(programClass))) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (accepted(libraryField.getDescriptor(libraryClass))) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (accepted(libraryMethod.getDescriptor(libraryClass))) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } + + + // Small utility methods. + + private boolean accepted(String name) + { + return regularExpressionMatcher.matches(name); + } +} diff --git a/src/proguard/classfile/visitor/MemberNameFilter.java b/src/proguard/classfile/visitor/MemberNameFilter.java new file mode 100644 index 0000000..0fe450e --- /dev/null +++ b/src/proguard/classfile/visitor/MemberNameFilter.java @@ -0,0 +1,113 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.util.*; + + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when the visited member + * has a name that matches a given regular expression. + * + * @author Eric Lafortune + */ +public class MemberNameFilter implements MemberVisitor +{ + private final StringMatcher regularExpressionMatcher; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MemberNameFilter. + * @param regularExpression the regular expression against which member + * names will be matched. + * @param memberVisitor the MemberVisitor to which visits + * will be delegated. + */ + public MemberNameFilter(String regularExpression, + MemberVisitor memberVisitor) + { + this(new NameParser().parse(regularExpression), memberVisitor); + } + + + /** + * Creates a new MemberNameFilter. + * @param regularExpressionMatcher the regular expression against which + * member names will be matched. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public MemberNameFilter(StringMatcher regularExpressionMatcher, + MemberVisitor memberVisitor) + { + this.regularExpressionMatcher = regularExpressionMatcher; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (accepted(programField.getName(programClass))) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (accepted(programMethod.getName(programClass))) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (accepted(libraryField.getName(libraryClass))) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (accepted(libraryMethod.getName(libraryClass))) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } + + + // Small utility methods. + + private boolean accepted(String name) + { + return regularExpressionMatcher.matches(name); + } +} diff --git a/src/proguard/classfile/visitor/MemberToClassVisitor.java b/src/proguard/classfile/visitor/MemberToClassVisitor.java new file mode 100644 index 0000000..a405cfc --- /dev/null +++ b/src/proguard/classfile/visitor/MemberToClassVisitor.java @@ -0,0 +1,90 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This MemberVisitor delegates all visits to a given ClassVisitor. + * The latter visits the class of each visited class member, although + * never twice in a row. + * + * @author Eric Lafortune + */ +public class MemberToClassVisitor implements MemberVisitor +{ + private final ClassVisitor classVisitor; + + private Clazz lastVisitedClass; + + + public MemberToClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (!programClass.equals(lastVisitedClass)) + { + classVisitor.visitProgramClass(programClass); + + lastVisitedClass = programClass; + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (!programClass.equals(lastVisitedClass)) + { + classVisitor.visitProgramClass(programClass); + + lastVisitedClass = programClass; + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (!libraryClass.equals(lastVisitedClass)) + { + classVisitor.visitLibraryClass(libraryClass); + + lastVisitedClass = libraryClass; + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (!libraryClass.equals(lastVisitedClass)) + { + classVisitor.visitLibraryClass(libraryClass); + + lastVisitedClass = libraryClass; + } + } +} diff --git a/src/proguard/classfile/visitor/MemberVisitor.java b/src/proguard/classfile/visitor/MemberVisitor.java new file mode 100644 index 0000000..01fdf71 --- /dev/null +++ b/src/proguard/classfile/visitor/MemberVisitor.java @@ -0,0 +1,40 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This interface specifies the methods for a visitor of + * ProgramMember objects and LibraryMember + * objects. + * + * @author Eric Lafortune + */ +public interface MemberVisitor +{ + public void visitProgramField( ProgramClass programClass, ProgramField programField); + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod); + + public void visitLibraryField( LibraryClass libraryClass, LibraryField libraryField); + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod); +} diff --git a/src/proguard/classfile/visitor/MethodImplementationFilter.java b/src/proguard/classfile/visitor/MethodImplementationFilter.java new file mode 100644 index 0000000..57d923a --- /dev/null +++ b/src/proguard/classfile/visitor/MethodImplementationFilter.java @@ -0,0 +1,70 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This MemberVisitor delegates its visits to methods to + * another given MemberVisitor, but only when the visited + * method may have implementations. + * + * @see Clazz#mayHaveImplementations(Method) + * @author Eric Lafortune + */ +public class MethodImplementationFilter +extends SimplifiedVisitor +implements MemberVisitor +{ + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MethodImplementationFilter. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public MethodImplementationFilter(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (programClass.mayHaveImplementations(programMethod)) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (libraryClass.mayHaveImplementations(libraryMethod)) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } +} diff --git a/src/proguard/classfile/visitor/MethodImplementationTraveler.java b/src/proguard/classfile/visitor/MethodImplementationTraveler.java new file mode 100644 index 0000000..dc0ea36 --- /dev/null +++ b/src/proguard/classfile/visitor/MethodImplementationTraveler.java @@ -0,0 +1,128 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This MemberVisitor lets a given MemberVisitor + * travel to all concrete and abstract implementations of the visited methods + * in their class hierarchies. + * + * @author Eric Lafortune + */ +public class MethodImplementationTraveler +extends SimplifiedVisitor +implements MemberVisitor +{ + private final boolean visitThisMethod; + private final boolean visitSuperMethods; + private final boolean visitInterfaceMethods; + private final boolean visitOverridingMethods; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MethodImplementationTraveler. + * @param visitThisMethod specifies whether to visit the originally + * visited methods. + * @param visitSuperMethods specifies whether to visit the method in + * the super classes. + * @param visitInterfaceMethods specifies whether to visit the method in + * the interface classes. + * @param visitOverridingMethods specifies whether to visit the method in + * the subclasses. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public MethodImplementationTraveler(boolean visitThisMethod, + boolean visitSuperMethods, + boolean visitInterfaceMethods, + boolean visitOverridingMethods, + MemberVisitor memberVisitor) + { + this.visitThisMethod = visitThisMethod; + this.visitSuperMethods = visitSuperMethods; + this.visitInterfaceMethods = visitInterfaceMethods; + this.visitOverridingMethods = visitOverridingMethods; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (visitThisMethod) + { + programMethod.accept(programClass, memberVisitor); + } + + if (!isSpecial(programClass, programMethod)) + { + programClass.hierarchyAccept(false, + visitSuperMethods, + visitInterfaceMethods, + visitOverridingMethods, + new NamedMethodVisitor(programMethod.getName(programClass), + programMethod.getDescriptor(programClass), + new MemberAccessFilter(0, + ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC, + memberVisitor))); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (visitThisMethod) + { + libraryMethod.accept(libraryClass, memberVisitor); + } + + if (!isSpecial(libraryClass, libraryMethod)) + { + libraryClass.hierarchyAccept(false, + visitSuperMethods, + visitInterfaceMethods, + visitOverridingMethods, + new NamedMethodVisitor(libraryMethod.getName(libraryClass), + libraryMethod.getDescriptor(libraryClass), + new MemberAccessFilter(0, + ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC, + memberVisitor))); + } + } + + + // Small utility methods. + + private boolean isSpecial(Clazz clazz, Method method) + { + return (method.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC)) != 0 || + method.getName(clazz).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT); + } +} diff --git a/src/proguard/classfile/visitor/MultiClassPoolVisitor.java b/src/proguard/classfile/visitor/MultiClassPoolVisitor.java new file mode 100644 index 0000000..044d55a --- /dev/null +++ b/src/proguard/classfile/visitor/MultiClassPoolVisitor.java @@ -0,0 +1,88 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.ClassPool; + + +/** + * This ClassPoolVisitor delegates all visits to each ClassPoolVisitor + * in a given list. + * + * @author Eric Lafortune + */ +public class MultiClassPoolVisitor implements ClassPoolVisitor +{ + private static final int ARRAY_SIZE_INCREMENT = 5; + + private ClassPoolVisitor[] classPoolVisitors; + private int classPoolVisitorCount; + + + public MultiClassPoolVisitor() + { + } + + + public MultiClassPoolVisitor(ClassPoolVisitor[] classPoolVisitors) + { + this.classPoolVisitors = classPoolVisitors; + this.classPoolVisitorCount = classPoolVisitors.length; + } + + + public void addClassPoolVisitor(ClassPoolVisitor classPoolVisitor) + { + ensureArraySize(); + + classPoolVisitors[classPoolVisitorCount++] = classPoolVisitor; + } + + + private void ensureArraySize() + { + if (classPoolVisitors == null) + { + classPoolVisitors = new ClassPoolVisitor[ARRAY_SIZE_INCREMENT]; + } + else if (classPoolVisitors.length == classPoolVisitorCount) + { + ClassPoolVisitor[] newClassPoolVisitors = + new ClassPoolVisitor[classPoolVisitorCount + + ARRAY_SIZE_INCREMENT]; + System.arraycopy(classPoolVisitors, 0, + newClassPoolVisitors, 0, + classPoolVisitorCount); + classPoolVisitors = newClassPoolVisitors; + } + } + + + // Implementations for ClassPoolVisitor. + + public void visitClassPool(ClassPool classPool) + { + for (int index = 0; index < classPoolVisitorCount; index++) + { + classPoolVisitors[index].visitClassPool(classPool); + } + } +} diff --git a/src/proguard/classfile/visitor/MultiClassVisitor.java b/src/proguard/classfile/visitor/MultiClassVisitor.java new file mode 100644 index 0000000..d34d91e --- /dev/null +++ b/src/proguard/classfile/visitor/MultiClassVisitor.java @@ -0,0 +1,97 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor delegates all visits to each ClassVisitor + * in a given list. + * + * @author Eric Lafortune + */ +public class MultiClassVisitor implements ClassVisitor +{ + private static final int ARRAY_SIZE_INCREMENT = 5; + + private ClassVisitor[] classVisitors; + private int classVisitorCount; + + + public MultiClassVisitor() + { + } + + + public MultiClassVisitor(ClassVisitor[] classVisitors) + { + this.classVisitors = classVisitors; + this.classVisitorCount = classVisitors.length; + } + + + public void addClassVisitor(ClassVisitor classVisitor) + { + ensureArraySize(); + + classVisitors[classVisitorCount++] = classVisitor; + } + + + private void ensureArraySize() + { + if (classVisitors == null) + { + classVisitors = new ClassVisitor[ARRAY_SIZE_INCREMENT]; + } + else if (classVisitors.length == classVisitorCount) + { + ClassVisitor[] newClassVisitors = + new ClassVisitor[classVisitorCount + + ARRAY_SIZE_INCREMENT]; + System.arraycopy(classVisitors, 0, + newClassVisitors, 0, + classVisitorCount); + classVisitors = newClassVisitors; + } + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + for (int index = 0; index < classVisitorCount; index++) + { + classVisitors[index].visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + for (int index = 0; index < classVisitorCount; index++) + { + classVisitors[index].visitLibraryClass(libraryClass); + } + } +} diff --git a/src/proguard/classfile/visitor/MultiMemberVisitor.java b/src/proguard/classfile/visitor/MultiMemberVisitor.java new file mode 100644 index 0000000..cc4629c --- /dev/null +++ b/src/proguard/classfile/visitor/MultiMemberVisitor.java @@ -0,0 +1,113 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This MemberVisitor delegates all visits to each MemberVisitor + * in a given list. + * + * @author Eric Lafortune + */ +public class MultiMemberVisitor implements MemberVisitor +{ + private static final int ARRAY_SIZE_INCREMENT = 5; + + private MemberVisitor[] memberVisitors; + private int memberVisitorCount; + + + public MultiMemberVisitor() + { + } + + + public MultiMemberVisitor(MemberVisitor[] memberVisitors) + { + this.memberVisitors = memberVisitors; + this.memberVisitorCount = memberVisitors.length; + } + + + public void addMemberVisitor(MemberVisitor memberVisitor) + { + ensureArraySize(); + + memberVisitors[memberVisitorCount++] = memberVisitor; + } + + + private void ensureArraySize() + { + if (memberVisitors == null) + { + memberVisitors = new MemberVisitor[ARRAY_SIZE_INCREMENT]; + } + else if (memberVisitors.length == memberVisitorCount) + { + MemberVisitor[] newMemberVisitors = + new MemberVisitor[memberVisitorCount + + ARRAY_SIZE_INCREMENT]; + System.arraycopy(memberVisitors, 0, + newMemberVisitors, 0, + memberVisitorCount); + memberVisitors = newMemberVisitors; + } + } + + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + for (int index = 0; index < memberVisitorCount; index++) + { + memberVisitors[index].visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + for (int index = 0; index < memberVisitorCount; index++) + { + memberVisitors[index].visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + for (int index = 0; index < memberVisitorCount; index++) + { + memberVisitors[index].visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + for (int index = 0; index < memberVisitorCount; index++) + { + memberVisitors[index].visitLibraryMethod(libraryClass, libraryMethod); + } + } +} diff --git a/src/proguard/classfile/visitor/NamedClassVisitor.java b/src/proguard/classfile/visitor/NamedClassVisitor.java new file mode 100644 index 0000000..a14d04a --- /dev/null +++ b/src/proguard/classfile/visitor/NamedClassVisitor.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.ClassPool; + + +/** + * This class visits Clazz objects with the given name. + * + * @author Eric Lafortune + */ +public class NamedClassVisitor implements ClassPoolVisitor +{ + private final ClassVisitor classVisitor; + private final String name; + + + public NamedClassVisitor(ClassVisitor classVisitor, + String name) + { + this.classVisitor = classVisitor; + this.name = name; + } + + + public void visitClassPool(ClassPool classPool) + { + classPool.classAccept(name, classVisitor); + } +} diff --git a/src/proguard/classfile/visitor/NamedFieldVisitor.java b/src/proguard/classfile/visitor/NamedFieldVisitor.java new file mode 100644 index 0000000..76b66c6 --- /dev/null +++ b/src/proguard/classfile/visitor/NamedFieldVisitor.java @@ -0,0 +1,61 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This class visits ProgramMember objects referring to fields, identified by + * a name and descriptor pair. + * + * @author Eric Lafortune + */ +public class NamedFieldVisitor implements ClassVisitor +{ + private final String name; + private final String descriptor; + private final MemberVisitor memberVisitor; + + + public NamedFieldVisitor(String name, + String descriptor, + MemberVisitor memberVisitor) + { + this.name = name; + this.descriptor = descriptor; + this.memberVisitor = memberVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.fieldAccept(name, descriptor, memberVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.fieldAccept(name, descriptor, memberVisitor); + } +} diff --git a/src/proguard/classfile/visitor/NamedMethodVisitor.java b/src/proguard/classfile/visitor/NamedMethodVisitor.java new file mode 100644 index 0000000..d4611c1 --- /dev/null +++ b/src/proguard/classfile/visitor/NamedMethodVisitor.java @@ -0,0 +1,61 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This class visits ProgramMember objects referring to methods, identified by + * a name and descriptor pair. + * + * @author Eric Lafortune + */ +public class NamedMethodVisitor implements ClassVisitor +{ + private final String name; + private final String descriptor; + private final MemberVisitor memberVisitor; + + + public NamedMethodVisitor(String name, + String descriptor, + MemberVisitor memberVisitor) + { + this.name = name; + this.descriptor = descriptor; + this.memberVisitor = memberVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.methodAccept(name, descriptor, memberVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.methodAccept(name, descriptor, memberVisitor); + } +} diff --git a/src/proguard/classfile/visitor/ProgramClassFilter.java b/src/proguard/classfile/visitor/ProgramClassFilter.java new file mode 100644 index 0000000..fba3b21 --- /dev/null +++ b/src/proguard/classfile/visitor/ProgramClassFilter.java @@ -0,0 +1,60 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, but only when visiting program classes. + * + * @author Eric Lafortune + */ +public class ProgramClassFilter implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new ProgramClassFilter. + * @param classVisitor the ClassVisitor to which visits + * will be delegated. + */ + public ProgramClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + classVisitor.visitProgramClass(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Don't delegate visits to library classes. + } +} diff --git a/src/proguard/classfile/visitor/ProgramMemberFilter.java b/src/proguard/classfile/visitor/ProgramMemberFilter.java new file mode 100644 index 0000000..048a1e6 --- /dev/null +++ b/src/proguard/classfile/visitor/ProgramMemberFilter.java @@ -0,0 +1,73 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when visiting members of program + * classes. + * + * @author Eric Lafortune + */ +public class ProgramMemberFilter implements MemberVisitor +{ + private final MemberVisitor memberVisitor; + + + /** + * Creates a new ProgramMemberFilter. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public ProgramMemberFilter(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + memberVisitor.visitProgramField(programClass, programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + // Don't delegate visits to library members. + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Don't delegate visits to library members. + } +} diff --git a/src/proguard/classfile/visitor/ReferencedClassVisitor.java b/src/proguard/classfile/visitor/ReferencedClassVisitor.java new file mode 100644 index 0000000..986c3f9 --- /dev/null +++ b/src/proguard/classfile/visitor/ReferencedClassVisitor.java @@ -0,0 +1,248 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ClassVisitor, MemberVisitor, ConstantVisitor, AttributeVisitor, etc. + * lets a given ClassVisitor visit all the referenced classes of the elements + * that it visits. Only downstream elements are considered (in order to avoid + * loops and repeated visits). + * + * @author Eric Lafortune + */ +public class ReferencedClassVisitor +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor, + AttributeVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private final ClassVisitor classVisitor; + + + public ReferencedClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Visit the constant pool entries. + programClass.constantPoolEntriesAccept(this); + + // Visit the fields and methods. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + // Visit the attributes. + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Visit the superclass and interfaces. + libraryClass.superClassAccept(classVisitor); + libraryClass.interfacesAccept(classVisitor); + + // Visit the fields and methods. + libraryClass.fieldsAccept(this); + libraryClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + // Let the visitor visit the classes referenced in the descriptor string. + programMember.referencedClassesAccept(classVisitor); + + // Visit the attributes. + programMember.attributesAccept(programClass, this); + } + + + public void visitLibraryMember(LibraryClass programClass, LibraryMember libraryMember) + { + // Let the visitor visit the classes referenced in the descriptor string. + libraryMember.referencedClassesAccept(classVisitor); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Let the visitor visit the class referenced in the string constant. + stringConstant.referencedClassAccept(classVisitor); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + // Let the visitor visit the class referenced in the reference constant. + refConstant.referencedClassAccept(classVisitor); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Let the visitor visit the class referenced in the class constant. + classConstant.referencedClassAccept(classVisitor); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + // Let the visitor visit the class of the enclosing method. + enclosingMethodAttribute.referencedClassAccept(classVisitor); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Visit the attributes of the code attribute. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Visit the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Visit the local variable types. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + // Let the visitor visit the classes referenced in the signature string. + signatureAttribute.referencedClassesAccept(classVisitor); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Visit the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Visit the parameter annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Visit the default element value. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + // Let the visitor visit the class referenced in the local variable. + localVariableInfo.referencedClassAccept(classVisitor); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + // Let the visitor visit the classes referenced in the local variable type. + localVariableTypeInfo.referencedClassesAccept(classVisitor); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Let the visitor visit the classes referenced in the annotation. + annotation.referencedClassesAccept(classVisitor); + + // Visit the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) {} + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + // Let the visitor visit the classes referenced in the constant element value. + enumConstantElementValue.referencedClassesAccept(classVisitor); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + // Let the visitor visit the classes referenced in the class element value. + classElementValue.referencedClassesAccept(classVisitor); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Visit the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } +} diff --git a/src/proguard/classfile/visitor/ReferencedMemberVisitor.java b/src/proguard/classfile/visitor/ReferencedMemberVisitor.java new file mode 100644 index 0000000..c4d34b8 --- /dev/null +++ b/src/proguard/classfile/visitor/ReferencedMemberVisitor.java @@ -0,0 +1,73 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.ElementValueVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor and ElementValueVisitor lets a given MemberVisitor + * visit all the referenced class members of the elements that it visits. + * + * @author Eric Lafortune + */ +public class ReferencedMemberVisitor +extends SimplifiedVisitor +implements ConstantVisitor, + ElementValueVisitor +{ + private final MemberVisitor memberVisitor; + + + public ReferencedMemberVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + stringConstant.referencedMemberAccept(memberVisitor); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + refConstant.referencedMemberAccept(memberVisitor); + } + + + // Implementations for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) + { + elementValue.referencedMethodAccept(memberVisitor); + } +} diff --git a/src/proguard/classfile/visitor/SimilarMemberVisitor.java b/src/proguard/classfile/visitor/SimilarMemberVisitor.java new file mode 100644 index 0000000..6dc06af --- /dev/null +++ b/src/proguard/classfile/visitor/SimilarMemberVisitor.java @@ -0,0 +1,125 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This MemberVisitor lets a given MemberVisitor + * visit all members that have the same name and type as the visited methods + * in the class hierarchy of a given target class. + * + * @author Eric Lafortune + */ +public class SimilarMemberVisitor +implements MemberVisitor +{ + private final Clazz targetClass; + private final boolean visitThisMember; + private final boolean visitSuperMembers; + private final boolean visitInterfaceMembers; + private final boolean visitOverridingMembers; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new SimilarMemberVisitor. + * @param targetClass the class in whose hierarchy to look for + * the visited class members. + * @param visitThisMember specifies whether to visit the class + * members in the target class itself. + * @param visitSuperMembers specifies whether to visit the class + * members in the super classes of the target + * class. + * @param visitInterfaceMembers specifies whether to visit the class + * members in the interface classes of the + * target class. + * @param visitOverridingMembers specifies whether to visit the class + * members in the subclasses of the target + * class. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public SimilarMemberVisitor(Clazz targetClass, + boolean visitThisMember, + boolean visitSuperMembers, + boolean visitInterfaceMembers, + boolean visitOverridingMembers, + MemberVisitor memberVisitor) + { + this.targetClass = targetClass; + this.visitThisMember = visitThisMember; + this.visitSuperMembers = visitSuperMembers; + this.visitInterfaceMembers = visitInterfaceMembers; + this.visitOverridingMembers = visitOverridingMembers; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + targetClass.hierarchyAccept(visitThisMember, + visitSuperMembers, + visitInterfaceMembers, + visitOverridingMembers, + new NamedFieldVisitor(programField.getName(programClass), + programField.getDescriptor(programClass), + memberVisitor)); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + targetClass.hierarchyAccept(visitThisMember, + visitSuperMembers, + visitInterfaceMembers, + visitOverridingMembers, + new NamedFieldVisitor(libraryField.getName(libraryClass), + libraryField.getDescriptor(libraryClass), + memberVisitor)); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + targetClass.hierarchyAccept(visitThisMember, + visitSuperMembers, + visitInterfaceMembers, + visitOverridingMembers, + new NamedMethodVisitor(programMethod.getName(programClass), + programMethod.getDescriptor(programClass), + memberVisitor)); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + targetClass.hierarchyAccept(visitThisMember, + visitSuperMembers, + visitInterfaceMembers, + visitOverridingMembers, + new NamedMethodVisitor(libraryMethod.getName(libraryClass), + libraryMethod.getDescriptor(libraryClass), + memberVisitor)); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/SimpleClassPrinter.java b/src/proguard/classfile/visitor/SimpleClassPrinter.java new file mode 100644 index 0000000..a661110 --- /dev/null +++ b/src/proguard/classfile/visitor/SimpleClassPrinter.java @@ -0,0 +1,167 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; +import proguard.classfile.util.ClassUtil; + +import java.io.PrintStream; + + +/** + * This ClassVisitor and MemberVisitor + * prints out the class names of the classes it visits, and the full class + * member descriptions of the class members it visits. The names are printed + * in a readable, Java-like format. The access modifiers can be included or not. + * + * @author Eric Lafortune + */ +public class SimpleClassPrinter +implements ClassVisitor, + MemberVisitor +{ + private final boolean printAccessModifiers; + private final PrintStream ps; + + + /** + * Creates a new SimpleClassPrinter that prints to + * System.out, including the access modifiers. + */ + public SimpleClassPrinter() + { + this(true); + } + + /** + * Creates a new SimpleClassPrinter that prints to + * System.out, with or without the access modifiers. + */ + public SimpleClassPrinter(boolean printAccessModifiers) + { + this(printAccessModifiers, System.out); + } + + /** + * Creates a new SimpleClassPrinter that prints to the given + * PrintStream, with or without the access modifiers. + */ + public SimpleClassPrinter(boolean printAccessModifiers, + PrintStream printStream) + { + this.printAccessModifiers = printAccessModifiers; + this.ps = printStream; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + ps.println(ClassUtil.externalFullClassDescription( + printAccessModifiers ? + programClass.getAccessFlags() : + 0, + programClass.getName())); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + ps.println(ClassUtil.externalFullClassDescription( + printAccessModifiers ? + libraryClass.getAccessFlags() : + 0, + libraryClass.getName())); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + ps.println(ClassUtil.externalFullClassDescription( + printAccessModifiers ? + programClass.getAccessFlags() : + 0, + programClass.getName()) + + ": " + + ClassUtil.externalFullFieldDescription( + printAccessModifiers ? + programField.getAccessFlags() : + 0, + programField.getName(programClass), + programField.getDescriptor(programClass))); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + ps.println(ClassUtil.externalFullClassDescription( + printAccessModifiers ? + programClass.getAccessFlags() : + 0, + programClass.getName()) + + ": " + + ClassUtil.externalFullMethodDescription( + programClass.getName(), + printAccessModifiers ? + programMethod.getAccessFlags() : + 0, + programMethod.getName(programClass), + programMethod.getDescriptor(programClass))); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + ps.println(ClassUtil.externalFullClassDescription( + printAccessModifiers ? + libraryClass.getAccessFlags() : + 0, + libraryClass.getName()) + + ": " + + ClassUtil.externalFullFieldDescription( + printAccessModifiers ? + libraryField.getAccessFlags() : + 0, + libraryField.getName(libraryClass), + libraryField.getDescriptor(libraryClass))); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + ps.println(ClassUtil.externalFullClassDescription( + printAccessModifiers ? + libraryClass.getAccessFlags() : + 0, + libraryClass.getName()) + + ": " + + ClassUtil.externalFullMethodDescription( + libraryClass.getName(), + printAccessModifiers ? + libraryMethod.getAccessFlags() : + 0, + libraryMethod.getName(libraryClass), + libraryMethod.getDescriptor(libraryClass))); + } +} diff --git a/src/proguard/classfile/visitor/SubclassFilter.java b/src/proguard/classfile/visitor/SubclassFilter.java new file mode 100644 index 0000000..69ea1a1 --- /dev/null +++ b/src/proguard/classfile/visitor/SubclassFilter.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + +/** + * This ClassVisitor delegates its visits to another given + * ClassVisitor, except for classes that have a given class as + * direct subclass. + * + * @author Eric Lafortune + */ +public class SubclassFilter implements ClassVisitor +{ + private final Clazz subclass; + private final ClassVisitor classVisitor; + + + /** + * Creates a new SubclassFilter. + * @param subclass the class whose superclasses will not be visited. + * @param classVisitor the ClassVisitor to which visits will + * be delegated. + */ + public SubclassFilter(Clazz subclass, + ClassVisitor classVisitor) + { + this.subclass = subclass; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (!present(programClass.subClasses)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (!present(libraryClass.subClasses)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } + + + // Small utility methods. + + private boolean present(Clazz[] subclasses) + { + if (subclasses == null) + { + return false; + } + + for (int index = 0; index < subclasses.length; index++) + { + if (subclasses[index].equals(subclass)) + { + return true; + } + } + + return false; + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/SubclassTraveler.java b/src/proguard/classfile/visitor/SubclassTraveler.java new file mode 100644 index 0000000..4170341 --- /dev/null +++ b/src/proguard/classfile/visitor/SubclassTraveler.java @@ -0,0 +1,60 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor lets a given ClassVisitor + * travel to direct subclasses of the visited class. + * + * @author Eric Lafortune + */ +public class SubclassTraveler implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + /** + * Creates a new ClassHierarchyTraveler. + * @param classVisitor the ClassVisitor to + * which visits will be delegated. + */ + public SubclassTraveler(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.subclassesAccept(classVisitor); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.subclassesAccept(classVisitor); + } +} \ No newline at end of file diff --git a/src/proguard/classfile/visitor/VariableClassVisitor.java b/src/proguard/classfile/visitor/VariableClassVisitor.java new file mode 100644 index 0000000..2f575c4 --- /dev/null +++ b/src/proguard/classfile/visitor/VariableClassVisitor.java @@ -0,0 +1,78 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This ClassVisitor delegates all method calls to a ClassVisitor + * that can be changed at any time. + * + * @author Eric Lafortune + */ +public class VariableClassVisitor implements ClassVisitor +{ + private ClassVisitor classVisitor; + + + public VariableClassVisitor() + { + this(null); + } + + + public VariableClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + public void setClassVisitor(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + public ClassVisitor getClassVisitor() + { + return classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (classVisitor != null) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (classVisitor != null) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} diff --git a/src/proguard/classfile/visitor/VariableMemberVisitor.java b/src/proguard/classfile/visitor/VariableMemberVisitor.java new file mode 100644 index 0000000..c58cff3 --- /dev/null +++ b/src/proguard/classfile/visitor/VariableMemberVisitor.java @@ -0,0 +1,96 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.classfile.visitor; + +import proguard.classfile.*; + + +/** + * This MemberVisitor delegates all method calls to a MemberVisitor + * that can be changed at any time. + * + * @author Eric Lafortune + */ +public class VariableMemberVisitor implements MemberVisitor +{ + private MemberVisitor memberVisitor; + + + public VariableMemberVisitor() + { + this(null); + } + + + public VariableMemberVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + public void setMemberVisitor(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + public MemberVisitor getMemberVisitor() + { + return memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (memberVisitor != null) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (memberVisitor != null) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (memberVisitor != null) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (memberVisitor != null) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } +} diff --git a/src/proguard/classfile/visitor/package.html b/src/proguard/classfile/visitor/package.html new file mode 100644 index 0000000..d3be40c --- /dev/null +++ b/src/proguard/classfile/visitor/package.html @@ -0,0 +1,40 @@ + +This package contains interfaces and classes for processing class files from +the {@link proguard.classfile proguard.classfile} package using +the visitor pattern. Cfr., for instance, "Design Patterns, Elements of +Reusable OO Software", by Gamma, Helm, Johnson, and Vlissider. +

    +Why the visitor pattern? Class files frequently contain lists of elements of +various mixed types: class items, constant pool entries, attributes,... +These lists and types are largely fixed; they won't change much in future +releases of the Java class file specifications. On the other hand, the kinds +of operations that we may wish to perform on the class files may change and +expand. We want to separate the objects and the operations performed upon them. +This is a good place to use the visitor pattern. +

    +Visitor interfaces avoid having to do series of instanceof tests +on the elements of a list, followed by type casts and the proper operations. +Every list element is a visitor accepter. When its accept method +is called by a visitor, it calls its corresponding visitX method +in the visitor, passing itself as an argument. This technique is called +double-dispatch. +

    +As already mentioned, the main advantage is avoiding lots of +instanceof tests and type casts. Also, implementing a visitor +interface ensures you're handling all possible visitor accepter types. Each +type has its own method, which you simply have to implement. +

    +A disadvantage is that the visitor methods always get the same names, specified +by the visitor interface. These names aren't descriptive at all, making code +harder to read. It's the visitor classes that describe the operations now. +

    +Also, the visitor methods always have the same parameters and return values, as +specified by the visitor interfaces. Passing additional parameters is done by +means of extra fields in the visitor, which is somewhat of a kludge. +

    +Because objects (the visitor accepters) and the operations performed upon them +(the visitors) are now separated, it becomes harder to associate some state +with the objects. For convenience, we always provide an extra visitor +info field in visitor accepters, in which visitors can put any temporary +information they want. + diff --git a/src/proguard/evaluation/BasicBranchUnit.java b/src/proguard/evaluation/BasicBranchUnit.java new file mode 100644 index 0000000..3a2db76 --- /dev/null +++ b/src/proguard/evaluation/BasicBranchUnit.java @@ -0,0 +1,126 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.CodeAttribute; +import proguard.evaluation.value.InstructionOffsetValue; + +/** + * This BranchUnit remembers the branch unit commands that are invoked on it. + * I doesn't consider conditions when branching. + * + * @author Eric Lafortune + */ +public class BasicBranchUnit +implements BranchUnit +{ + private boolean wasCalled; + private InstructionOffsetValue traceBranchTargets; + + + /** + * Resets the flag that tells whether any of the branch unit commands was + * called. + */ + public void resetCalled() + { + wasCalled = false; + } + + /** + * Sets the flag that tells whether any of the branch unit commands was + * called. + */ + protected void setCalled() + { + wasCalled = true; + } + + /** + * Returns whether any of the branch unit commands was called. + */ + public boolean wasCalled() + { + return wasCalled; + } + + + /** + * Sets the initial branch targets, which will be updated as the branch + * methods of the branch unit are called. + */ + public void setTraceBranchTargets(InstructionOffsetValue branchTargets) + { + this.traceBranchTargets = branchTargets; + } + + public InstructionOffsetValue getTraceBranchTargets() + { + return traceBranchTargets; + } + + + // Implementations for BranchUnit. + + public void branch(Clazz clazz, + CodeAttribute codeAttribute, + int offset, + int branchTarget) + { + // Override the branch targets. + traceBranchTargets = new InstructionOffsetValue(branchTarget); + + wasCalled = true; + } + + + public void branchConditionally(Clazz clazz, + CodeAttribute codeAttribute, + int offset, + int branchTarget, + int conditional) + { + // Accumulate the branch targets. + traceBranchTargets = + traceBranchTargets.generalize(new InstructionOffsetValue(branchTarget)).instructionOffsetValue(); + + wasCalled = true; + } + + + public void returnFromMethod() + { + // Stop processing this block. + traceBranchTargets = InstructionOffsetValue.EMPTY_VALUE; + + wasCalled = true; + } + + + public void throwException() + { + // Stop processing this block. + traceBranchTargets = InstructionOffsetValue.EMPTY_VALUE; + + wasCalled = true; + } +} diff --git a/src/proguard/evaluation/BasicInvocationUnit.java b/src/proguard/evaluation/BasicInvocationUnit.java new file mode 100644 index 0000000..bccd866 --- /dev/null +++ b/src/proguard/evaluation/BasicInvocationUnit.java @@ -0,0 +1,380 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.evaluation.value.*; + +/** + * This InvocationUnit sets up the variables for entering a method, + * and it updates the stack for the invocation of a class member, + * using simple values. + * + * @author Eric Lafortune + */ +public class BasicInvocationUnit +extends SimplifiedVisitor +implements InvocationUnit, + ConstantVisitor, + MemberVisitor +{ + protected final ValueFactory valueFactory; + + // Fields acting as parameters between the visitor methods. + private boolean isStatic; + private boolean isLoad; + private Stack stack; + private Clazz returnTypeClass; + + + /** + * Creates a new BasicInvocationUnit with the given value factory. + */ + public BasicInvocationUnit(ValueFactory valueFactory) + { + this.valueFactory = valueFactory; + } + + + // Implementations for InvocationUnit. + + public void enterMethod(Clazz clazz, Method method, Variables variables) + { + String descriptor = method.getDescriptor(clazz); + + // Initialize the parameters. + boolean isStatic = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0; + + // Count the number of parameters, taking into account their categories. + int parameterSize = ClassUtil.internalMethodParameterSize(descriptor, isStatic); + + // Reuse the existing parameters object, ensuring the right size. + variables.reset(parameterSize); + + // Go over the parameters again. + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + int parameterIndex = 0; + int variableIndex = 0; + + // Put the 'this' reference in variable 0. + if (!isStatic) + { + // Get the reference value. + Value value = getMethodParameterValue(clazz, + method, + parameterIndex++, + ClassUtil.internalTypeFromClassName(clazz.getName()), + clazz); + + // Store the value in variable 0. + variables.store(variableIndex++, value); + } + + Clazz[] referencedClasses = ((ProgramMethod)method).referencedClasses; + int referencedClassIndex = 0; + + // Set up the variables corresponding to the parameter types and values. + while (internalTypeEnumeration.hasMoreTypes()) + { + String type = internalTypeEnumeration.nextType(); + + Clazz referencedClass = referencedClasses != null && + ClassUtil.isInternalClassType(type) ? + referencedClasses[referencedClassIndex++] : + null; + + // Get the parameter value. + Value value = getMethodParameterValue(clazz, + method, + parameterIndex++, + type, + referencedClass); + + // Store the value in the corresponding variable. + variables.store(variableIndex++, value); + + // Increment the variable index again for Category 2 values. + if (value.isCategory2()) + { + variableIndex++; + } + } + } + + + public void exitMethod(Clazz clazz, Method method, Value returnValue) + { + setMethodReturnValue(clazz, method, returnValue); + } + + + public void invokeMember(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction, Stack stack) + { + int constantIndex = constantInstruction.constantIndex; + + switch (constantInstruction.opcode) + { + case InstructionConstants.OP_GETSTATIC: + isStatic = true; + isLoad = true; + break; + + case InstructionConstants.OP_PUTSTATIC: + isStatic = true; + isLoad = false; + break; + + case InstructionConstants.OP_GETFIELD: + isStatic = false; + isLoad = true; + break; + + case InstructionConstants.OP_PUTFIELD: + isStatic = false; + isLoad = false; + break; + + case InstructionConstants.OP_INVOKESTATIC: + isStatic = true; + break; + + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKEINTERFACE: + isStatic = false; + break; + } + + // Pop the parameters and push the return value. + this.stack = stack; + clazz.constantPoolEntryAccept(constantIndex, this); + this.stack = null; + } + + + // Implementations for ConstantVisitor. + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + // Pop the field value, if applicable. + if (!isLoad) + { + setFieldValue(clazz, fieldrefConstant, stack.pop()); + } + + // Pop the reference value, if applicable. + if (!isStatic) + { + setFieldClassValue(clazz, fieldrefConstant, stack.apop()); + } + + // Push the field value, if applicable. + if (isLoad) + { + String type = fieldrefConstant.getType(clazz); + + stack.push(getFieldValue(clazz, fieldrefConstant, type)); + } + } + + + public void visitAnyMethodrefConstant(Clazz clazz, RefConstant methodrefConstant) + { + String type = methodrefConstant.getType(clazz); + + // Count the number of parameters. + int parameterCount = ClassUtil.internalMethodParameterCount(type); + if (!isStatic) + { + parameterCount++; + } + + // Pop the parameters and the class reference, in reverse order. + for (int parameterIndex = parameterCount-1; parameterIndex >= 0; parameterIndex--) + { + setMethodParameterValue(clazz, methodrefConstant, parameterIndex, stack.pop()); + } + + // Push the return value, if applicable. + String returnType = ClassUtil.internalMethodReturnType(type); + if (returnType.charAt(0) != ClassConstants.INTERNAL_TYPE_VOID) + { + stack.push(getMethodReturnValue(clazz, methodrefConstant, returnType)); + } + } + + + /** + * Sets the class through which the specified field is accessed. + */ + protected void setFieldClassValue(Clazz clazz, + RefConstant refConstant, + ReferenceValue value) + { + // We don't care about the new value. + } + + + /** + * Returns the class though which the specified field is accessed. + */ + protected Value getFieldClassValue(Clazz clazz, + RefConstant refConstant, + String type) + { + // Try to figure out the class of the return type. + returnTypeClass = null; + refConstant.referencedMemberAccept(this); + + return valueFactory.createValue(type, + returnTypeClass, + true); + } + + + /** + * Sets the value of the specified field. + */ + protected void setFieldValue(Clazz clazz, + RefConstant refConstant, + Value value) + { + // We don't care about the new field value. + } + + + /** + * Returns the value of the specified field. + */ + protected Value getFieldValue(Clazz clazz, + RefConstant refConstant, + String type) + { + // Try to figure out the class of the return type. + returnTypeClass = null; + refConstant.referencedMemberAccept(this); + + return valueFactory.createValue(type, + returnTypeClass, + true); + } + + + /** + * Sets the value of the specified method parameter. + */ + protected void setMethodParameterValue(Clazz clazz, + RefConstant refConstant, + int parameterIndex, + Value value) + { + // We don't care about the parameter value. + } + + + /** + * Returns the value of the specified method parameter. + */ + protected Value getMethodParameterValue(Clazz clazz, + Method method, + int parameterIndex, + String type, + Clazz referencedClass) + { + return valueFactory.createValue(type, referencedClass, true); + } + + + /** + * Sets the return value of the specified method. + */ + protected void setMethodReturnValue(Clazz clazz, + Method method, + Value value) + { + // We don't care about the return value. + } + + + /** + * Returns the return value of the specified method. + */ + protected Value getMethodReturnValue(Clazz clazz, + RefConstant refConstant, + String type) + { + // Try to figure out the class of the return type. + returnTypeClass = null; + refConstant.referencedMemberAccept(this); + + return valueFactory.createValue(type, + returnTypeClass, + true); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + returnTypeClass = programField.referencedClass; + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + Clazz[] referencedClasses = programMethod.referencedClasses; + if (referencedClasses != null) + { + returnTypeClass = referencedClasses[referencedClasses.length - 1]; + } + } + + + public void visitLibraryField(LibraryClass programClass, LibraryField programField) + { + returnTypeClass = programField.referencedClass; + } + + + public void visitLibraryMethod(LibraryClass programClass, LibraryMethod programMethod) + { + Clazz[] referencedClasses = programMethod.referencedClasses; + if (referencedClasses != null) + { + returnTypeClass = referencedClasses[referencedClasses.length - 1]; + } + } + + +// public void visitLibraryMember(LibraryClass libraryClass, LibraryMember libraryMember) +// { +// } +} diff --git a/src/proguard/evaluation/BranchUnit.java b/src/proguard/evaluation/BranchUnit.java new file mode 100644 index 0000000..b709807 --- /dev/null +++ b/src/proguard/evaluation/BranchUnit.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.CodeAttribute; + +/** + * This InstructionVisitor evaluates the instructions that it visits. + * + * @author Eric Lafortune + */ +public interface BranchUnit +{ + /** + * Sets the new instruction offset. + */ + public void branch(Clazz clazz, + CodeAttribute codeAttribute, + int offset, + int branchTarget); + + + /** + * Sets the new instruction offset, depending on the certainty of the + * conditional branch. + */ + public void branchConditionally(Clazz clazz, + CodeAttribute codeAttribute, + int offset, + int branchTarget, + int conditional); + + + /** + * Returns from the method with the given value. + */ + public void returnFromMethod(); + + + /** + * Handles the throwing of an exception. + */ + public void throwException(); +} diff --git a/src/proguard/evaluation/InvocationUnit.java b/src/proguard/evaluation/InvocationUnit.java new file mode 100644 index 0000000..cb4d3c5 --- /dev/null +++ b/src/proguard/evaluation/InvocationUnit.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.ConstantInstruction; +import proguard.evaluation.value.Value; + +/** + * This interface sets up the variables for entering a method, + * and it updates the stack for the invocation of a class member. + * + * @author Eric Lafortune + */ +public interface InvocationUnit +{ + /** + * Sets up the given variables for entering the given method. + */ + public void enterMethod(Clazz clazz, + Method method, + Variables variables); + + + /** + * Exits the given method with the given return value. + */ + public void exitMethod(Clazz clazz, + Method method, + Value returnValue); + + + /** + * Updates the given stack corresponding to the execution of the given + * field or method reference instruction. + */ + public void invokeMember(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int offset, + ConstantInstruction constantInstruction, + Stack stack); +} diff --git a/src/proguard/evaluation/Processor.java b/src/proguard/evaluation/Processor.java new file mode 100644 index 0000000..74afd0b --- /dev/null +++ b/src/proguard/evaluation/Processor.java @@ -0,0 +1,979 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.evaluation.value.*; + +/** + * This InstructionVisitor executes the instructions that it visits on a given + * local variable frame and stack. + * + * @author Eric Lafortune + */ +public class Processor +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor +{ + private final Variables variables; + private final Stack stack; + private final ValueFactory valueFactory; + private final BranchUnit branchUnit; + private final InvocationUnit invocationUnit; + + // Fields acting as parameters for the ConstantVisitor methods. + private boolean handleClassConstantAsClassValue; + private Value cpValue; + + + /** + * Creates a new processor that operates on the given environment. + * @param variables the local variable frame. + * @param stack the local stack. + * @param branchUnit the class that can affect the program counter. + * @param invocationUnit the class that can access other program members. + */ + public Processor(Variables variables, + Stack stack, + ValueFactory valueFactory, + BranchUnit branchUnit, + InvocationUnit invocationUnit) + { + this.variables = variables; + this.stack = stack; + this.valueFactory = valueFactory; + this.branchUnit = branchUnit; + this.invocationUnit = invocationUnit; + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + switch (simpleInstruction.opcode) + { + case InstructionConstants.OP_NOP: + break; + + case InstructionConstants.OP_ACONST_NULL: + stack.push(valueFactory.createReferenceValueNull()); + break; + + case InstructionConstants.OP_ICONST_M1: + case InstructionConstants.OP_ICONST_0: + case InstructionConstants.OP_ICONST_1: + case InstructionConstants.OP_ICONST_2: + case InstructionConstants.OP_ICONST_3: + case InstructionConstants.OP_ICONST_4: + case InstructionConstants.OP_ICONST_5: + case InstructionConstants.OP_BIPUSH: + case InstructionConstants.OP_SIPUSH: + stack.push(valueFactory.createIntegerValue(simpleInstruction.constant)); + break; + + case InstructionConstants.OP_LCONST_0: + case InstructionConstants.OP_LCONST_1: + stack.push(valueFactory.createLongValue(simpleInstruction.constant)); + break; + + case InstructionConstants.OP_FCONST_0: + case InstructionConstants.OP_FCONST_1: + case InstructionConstants.OP_FCONST_2: + stack.push(valueFactory.createFloatValue((float)simpleInstruction.constant)); + break; + + case InstructionConstants.OP_DCONST_0: + case InstructionConstants.OP_DCONST_1: + stack.push(valueFactory.createDoubleValue((double)simpleInstruction.constant)); + break; + + case InstructionConstants.OP_IALOAD: + case InstructionConstants.OP_BALOAD: + case InstructionConstants.OP_CALOAD: + case InstructionConstants.OP_SALOAD: + stack.ipop(); + stack.apop(); + stack.push(valueFactory.createIntegerValue()); + break; + + case InstructionConstants.OP_LALOAD: + stack.ipop(); + stack.apop(); + stack.push(valueFactory.createLongValue()); + break; + + case InstructionConstants.OP_FALOAD: + stack.ipop(); + stack.apop(); + stack.push(valueFactory.createFloatValue()); + break; + + case InstructionConstants.OP_DALOAD: + stack.ipop(); + stack.apop(); + stack.push(valueFactory.createDoubleValue()); + break; + + case InstructionConstants.OP_AALOAD: + { + IntegerValue arrayIndex = stack.ipop(); + ReferenceValue arrayReference = stack.apop(); + stack.push(arrayReference.arrayLoad(arrayIndex, valueFactory)); + break; + } + + case InstructionConstants.OP_IASTORE: + case InstructionConstants.OP_BASTORE: + case InstructionConstants.OP_CASTORE: + case InstructionConstants.OP_SASTORE: + stack.ipop(); + stack.ipop(); + stack.apop(); + break; + + case InstructionConstants.OP_LASTORE: + stack.lpop(); + stack.ipop(); + stack.apop(); + break; + + case InstructionConstants.OP_FASTORE: + stack.fpop(); + stack.ipop(); + stack.apop(); + break; + + case InstructionConstants.OP_DASTORE: + stack.dpop(); + stack.ipop(); + stack.apop(); + break; + + case InstructionConstants.OP_AASTORE: + stack.apop(); + stack.ipop(); + stack.apop(); + break; + + case InstructionConstants.OP_POP: + stack.pop1(); + break; + + case InstructionConstants.OP_POP2: + stack.pop2(); + break; + + case InstructionConstants.OP_DUP: + stack.dup(); + break; + + case InstructionConstants.OP_DUP_X1: + stack.dup_x1(); + break; + + case InstructionConstants.OP_DUP_X2: + stack.dup_x2(); + break; + + case InstructionConstants.OP_DUP2: + stack.dup2(); + break; + + case InstructionConstants.OP_DUP2_X1: + stack.dup2_x1(); + break; + + case InstructionConstants.OP_DUP2_X2: + stack.dup2_x2(); + break; + + case InstructionConstants.OP_SWAP: + stack.swap(); + break; + + case InstructionConstants.OP_IADD: + stack.push(stack.ipop().add(stack.ipop())); + break; + + case InstructionConstants.OP_LADD: + stack.push(stack.lpop().add(stack.lpop())); + break; + + case InstructionConstants.OP_FADD: + stack.push(stack.fpop().add(stack.fpop())); + break; + + case InstructionConstants.OP_DADD: + stack.push(stack.dpop().add(stack.dpop())); + break; + + case InstructionConstants.OP_ISUB: + stack.push(stack.ipop().subtractFrom(stack.ipop())); + break; + + case InstructionConstants.OP_LSUB: + stack.push(stack.lpop().subtractFrom(stack.lpop())); + break; + + case InstructionConstants.OP_FSUB: + stack.push(stack.fpop().subtractFrom(stack.fpop())); + break; + + case InstructionConstants.OP_DSUB: + stack.push(stack.dpop().subtractFrom(stack.dpop())); + break; + + case InstructionConstants.OP_IMUL: + stack.push(stack.ipop().multiply(stack.ipop())); + break; + + case InstructionConstants.OP_LMUL: + stack.push(stack.lpop().multiply(stack.lpop())); + break; + + case InstructionConstants.OP_FMUL: + stack.push(stack.fpop().multiply(stack.fpop())); + break; + + case InstructionConstants.OP_DMUL: + stack.push(stack.dpop().multiply(stack.dpop())); + break; + + case InstructionConstants.OP_IDIV: + try + { + stack.push(stack.ipop().divideOf(stack.ipop())); + } + catch (ArithmeticException ex) + { + stack.push(valueFactory.createIntegerValue()); + // TODO: Forward ArithmeticExceptions. + //stack.clear(); + //stack.push(valueFactory.createReference(false)); + //branchUnit.throwException(); + } + break; + + case InstructionConstants.OP_LDIV: + try + { + stack.push(stack.lpop().divideOf(stack.lpop())); + } + catch (ArithmeticException ex) + { + stack.push(valueFactory.createLongValue()); + // TODO: Forward ArithmeticExceptions. + //stack.clear(); + //stack.push(valueFactory.createReference(false)); + //branchUnit.throwException(); + } + break; + + case InstructionConstants.OP_FDIV: + stack.push(stack.fpop().divideOf(stack.fpop())); + break; + + case InstructionConstants.OP_DDIV: + stack.push(stack.dpop().divideOf(stack.dpop())); + break; + + case InstructionConstants.OP_IREM: + try + { + stack.push(stack.ipop().remainderOf(stack.ipop())); + } + catch (ArithmeticException ex) + { + stack.push(valueFactory.createIntegerValue()); + // TODO: Forward ArithmeticExceptions. + //stack.clear(); + //stack.push(valueFactory.createReference(false)); + //branchUnit.throwException(); + } + break; + + case InstructionConstants.OP_LREM: + try + { + stack.push(stack.lpop().remainderOf(stack.lpop())); + } + catch (ArithmeticException ex) + { + stack.push(valueFactory.createLongValue()); + // TODO: Forward ArithmeticExceptions. + //stack.clear(); + //stack.push(valueFactory.createReference(false)); + //branchUnit.throwException(); + } + break; + + case InstructionConstants.OP_FREM: + stack.push(stack.fpop().remainderOf(stack.fpop())); + break; + + case InstructionConstants.OP_DREM: + stack.push(stack.dpop().remainderOf(stack.dpop())); + break; + + case InstructionConstants.OP_INEG: + stack.push(stack.ipop().negate()); + break; + + case InstructionConstants.OP_LNEG: + stack.push(stack.lpop().negate()); + break; + + case InstructionConstants.OP_FNEG: + stack.push(stack.fpop().negate()); + break; + + case InstructionConstants.OP_DNEG: + stack.push(stack.dpop().negate()); + break; + + case InstructionConstants.OP_ISHL: + stack.push(stack.ipop().shiftLeftOf(stack.ipop())); + break; + + case InstructionConstants.OP_LSHL: + stack.push(stack.ipop().shiftLeftOf(stack.lpop())); + break; + + case InstructionConstants.OP_ISHR: + stack.push(stack.ipop().shiftRightOf(stack.ipop())); + break; + + case InstructionConstants.OP_LSHR: + stack.push(stack.ipop().shiftRightOf(stack.lpop())); + break; + + case InstructionConstants.OP_IUSHR: + stack.push(stack.ipop().unsignedShiftRightOf(stack.ipop())); + break; + + case InstructionConstants.OP_LUSHR: + stack.push(stack.ipop().unsignedShiftRightOf(stack.lpop())); + break; + + case InstructionConstants.OP_IAND: + stack.push(stack.ipop().and(stack.ipop())); + break; + + case InstructionConstants.OP_LAND: + stack.push(stack.lpop().and(stack.lpop())); + break; + + case InstructionConstants.OP_IOR: + stack.push(stack.ipop().or(stack.ipop())); + break; + + case InstructionConstants.OP_LOR: + stack.push(stack.lpop().or(stack.lpop())); + break; + + case InstructionConstants.OP_IXOR: + stack.push(stack.ipop().xor(stack.ipop())); + break; + + case InstructionConstants.OP_LXOR: + stack.push(stack.lpop().xor(stack.lpop())); + break; + + case InstructionConstants.OP_I2L: + stack.push(stack.ipop().convertToLong()); + break; + + case InstructionConstants.OP_I2F: + stack.push(stack.ipop().convertToFloat()); + break; + + case InstructionConstants.OP_I2D: + stack.push(stack.ipop().convertToDouble()); + break; + + case InstructionConstants.OP_L2I: + stack.push(stack.lpop().convertToInteger()); + break; + + case InstructionConstants.OP_L2F: + stack.push(stack.lpop().convertToFloat()); + break; + + case InstructionConstants.OP_L2D: + stack.push(stack.lpop().convertToDouble()); + break; + + case InstructionConstants.OP_F2I: + stack.push(stack.fpop().convertToInteger()); + break; + + case InstructionConstants.OP_F2L: + stack.push(stack.fpop().convertToLong()); + break; + + case InstructionConstants.OP_F2D: + stack.push(stack.fpop().convertToDouble()); + break; + + case InstructionConstants.OP_D2I: + stack.push(stack.dpop().convertToInteger()); + break; + + case InstructionConstants.OP_D2L: + stack.push(stack.dpop().convertToLong()); + break; + + case InstructionConstants.OP_D2F: + stack.push(stack.dpop().convertToFloat()); + break; + + case InstructionConstants.OP_I2B: + stack.push(stack.ipop().convertToByte()); + break; + + case InstructionConstants.OP_I2C: + stack.push(stack.ipop().convertToCharacter()); + break; + + case InstructionConstants.OP_I2S: + stack.push(stack.ipop().convertToShort()); + break; + + case InstructionConstants.OP_LCMP: +// stack.push(stack.lpop().compareReverse(stack.lpop())); + + LongValue longValue1 = stack.lpop(); + LongValue longValue2 = stack.lpop(); + stack.push(longValue2.compare(longValue1)); + break; + + case InstructionConstants.OP_FCMPL: + FloatValue floatValue1 = stack.fpop(); + FloatValue floatValue2 = stack.fpop(); + stack.push(floatValue2.compare(floatValue1)); + break; + + case InstructionConstants.OP_FCMPG: + stack.push(stack.fpop().compareReverse(stack.fpop())); + break; + + case InstructionConstants.OP_DCMPL: + DoubleValue doubleValue1 = stack.dpop(); + DoubleValue doubleValue2 = stack.dpop(); + stack.push(doubleValue2.compare(doubleValue1)); + break; + + case InstructionConstants.OP_DCMPG: + stack.push(stack.dpop().compareReverse(stack.dpop())); + break; + + case InstructionConstants.OP_IRETURN: + invocationUnit.exitMethod(clazz, method, stack.ipop()); + branchUnit.returnFromMethod(); + break; + + case InstructionConstants.OP_LRETURN: + invocationUnit.exitMethod(clazz, method, stack.lpop()); + branchUnit.returnFromMethod(); + break; + + case InstructionConstants.OP_FRETURN: + invocationUnit.exitMethod(clazz, method, stack.fpop()); + branchUnit.returnFromMethod(); + break; + + case InstructionConstants.OP_DRETURN: + invocationUnit.exitMethod(clazz, method, stack.dpop()); + branchUnit.returnFromMethod(); + break; + + case InstructionConstants.OP_ARETURN: + invocationUnit.exitMethod(clazz, method, stack.apop()); + branchUnit.returnFromMethod(); + break; + + case InstructionConstants.OP_RETURN: + branchUnit.returnFromMethod(); + break; + + case InstructionConstants.OP_NEWARRAY: + IntegerValue arrayLength = stack.ipop(); + stack.push(valueFactory.createArrayReferenceValue(String.valueOf(InstructionUtil.internalTypeFromArrayType((byte)simpleInstruction.constant)), + null, + arrayLength)); + break; + + case InstructionConstants.OP_ARRAYLENGTH: + stack.apop(); + stack.push(valueFactory.createIntegerValue()); + break; + + case InstructionConstants.OP_ATHROW: + ReferenceValue exceptionReferenceValue = stack.apop(); + stack.clear(); + stack.push(exceptionReferenceValue); + branchUnit.throwException(); + break; + + case InstructionConstants.OP_MONITORENTER: + case InstructionConstants.OP_MONITOREXIT: + stack.apop(); + break; + + default: + throw new IllegalArgumentException("Unknown simple instruction ["+simpleInstruction.opcode+"]"); + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + int constantIndex = constantInstruction.constantIndex; + + switch (constantInstruction.opcode) + { + case InstructionConstants.OP_LDC: + case InstructionConstants.OP_LDC_W: + case InstructionConstants.OP_LDC2_W: + stack.push(cpValue(clazz, constantIndex, true)); + break; + + case InstructionConstants.OP_GETSTATIC: + case InstructionConstants.OP_PUTSTATIC: + case InstructionConstants.OP_GETFIELD: + case InstructionConstants.OP_PUTFIELD: + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + invocationUnit.invokeMember(clazz, method, codeAttribute, offset, constantInstruction, stack); + break; + + case InstructionConstants.OP_NEW: + stack.push(cpValue(clazz, constantIndex).referenceValue()); + break; + + case InstructionConstants.OP_ANEWARRAY: + { + ReferenceValue referenceValue = cpValue(clazz, constantIndex).referenceValue(); + + stack.push(valueFactory.createArrayReferenceValue(referenceValue.internalType(), + referenceValue.getReferencedClass(), + stack.ipop())); + break; + } + + case InstructionConstants.OP_CHECKCAST: + // TODO: Check cast. + ReferenceValue castValue = stack.apop(); + ReferenceValue castResultValue = + castValue.isNull() == Value.ALWAYS ? castValue : + castValue.isNull() == Value.NEVER ? cpValue(clazz, constantIndex).referenceValue() : + cpValue(clazz, constantIndex).referenceValue().generalize(valueFactory.createReferenceValueNull()); + stack.push(castResultValue); + break; + + case InstructionConstants.OP_INSTANCEOF: + { + ReferenceValue referenceValue = cpValue(clazz, constantIndex).referenceValue(); + + int instanceOf = stack.apop().instanceOf(referenceValue.getType(), + referenceValue.getReferencedClass()); + + stack.push(instanceOf == Value.NEVER ? valueFactory.createIntegerValue(0) : + instanceOf == Value.ALWAYS ? valueFactory.createIntegerValue(1) : + valueFactory.createIntegerValue()); + break; + } + + case InstructionConstants.OP_MULTIANEWARRAY: + { + int dimensionCount = constantInstruction.constant; + for (int dimension = 0; dimension < dimensionCount; dimension++) + { + // TODO: Use array lengths. + IntegerValue arrayLength = stack.ipop(); + } + + stack.push(cpValue(clazz, constantIndex).referenceValue()); + break; + } + + default: + throw new IllegalArgumentException("Unknown constant pool instruction ["+constantInstruction.opcode+"]"); + } + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + int variableIndex = variableInstruction.variableIndex; + + switch (variableInstruction.opcode) + { + case InstructionConstants.OP_ILOAD: + case InstructionConstants.OP_ILOAD_0: + case InstructionConstants.OP_ILOAD_1: + case InstructionConstants.OP_ILOAD_2: + case InstructionConstants.OP_ILOAD_3: + stack.push(variables.iload(variableIndex)); + break; + + case InstructionConstants.OP_LLOAD: + case InstructionConstants.OP_LLOAD_0: + case InstructionConstants.OP_LLOAD_1: + case InstructionConstants.OP_LLOAD_2: + case InstructionConstants.OP_LLOAD_3: + stack.push(variables.lload(variableIndex)); + break; + + case InstructionConstants.OP_FLOAD: + case InstructionConstants.OP_FLOAD_0: + case InstructionConstants.OP_FLOAD_1: + case InstructionConstants.OP_FLOAD_2: + case InstructionConstants.OP_FLOAD_3: + stack.push(variables.fload(variableIndex)); + break; + + case InstructionConstants.OP_DLOAD: + case InstructionConstants.OP_DLOAD_0: + case InstructionConstants.OP_DLOAD_1: + case InstructionConstants.OP_DLOAD_2: + case InstructionConstants.OP_DLOAD_3: + stack.push(variables.dload(variableIndex)); + break; + + case InstructionConstants.OP_ALOAD: + case InstructionConstants.OP_ALOAD_0: + case InstructionConstants.OP_ALOAD_1: + case InstructionConstants.OP_ALOAD_2: + case InstructionConstants.OP_ALOAD_3: + stack.push(variables.aload(variableIndex)); + break; + + case InstructionConstants.OP_ISTORE: + case InstructionConstants.OP_ISTORE_0: + case InstructionConstants.OP_ISTORE_1: + case InstructionConstants.OP_ISTORE_2: + case InstructionConstants.OP_ISTORE_3: + variables.store(variableIndex, stack.ipop()); + break; + + case InstructionConstants.OP_LSTORE: + case InstructionConstants.OP_LSTORE_0: + case InstructionConstants.OP_LSTORE_1: + case InstructionConstants.OP_LSTORE_2: + case InstructionConstants.OP_LSTORE_3: + variables.store(variableIndex, stack.lpop()); + break; + + case InstructionConstants.OP_FSTORE: + case InstructionConstants.OP_FSTORE_0: + case InstructionConstants.OP_FSTORE_1: + case InstructionConstants.OP_FSTORE_2: + case InstructionConstants.OP_FSTORE_3: + variables.store(variableIndex, stack.fpop()); + break; + + case InstructionConstants.OP_DSTORE: + case InstructionConstants.OP_DSTORE_0: + case InstructionConstants.OP_DSTORE_1: + case InstructionConstants.OP_DSTORE_2: + case InstructionConstants.OP_DSTORE_3: + variables.store(variableIndex, stack.dpop()); + break; + + case InstructionConstants.OP_ASTORE: + case InstructionConstants.OP_ASTORE_0: + case InstructionConstants.OP_ASTORE_1: + case InstructionConstants.OP_ASTORE_2: + case InstructionConstants.OP_ASTORE_3: + // The operand on the stack can be a reference or a return + // address, so we'll relax the pop operation. + //variables.store(variableIndex, stack.apop()); + variables.store(variableIndex, stack.pop()); + break; + + case InstructionConstants.OP_IINC: + variables.store(variableIndex, + variables.iload(variableIndex).add( + valueFactory.createIntegerValue(variableInstruction.constant))); + break; + + case InstructionConstants.OP_RET: + // The return address should be in the last offset of the + // given instruction offset variable (even though there may + // be other offsets). + InstructionOffsetValue instructionOffsetValue = variables.oload(variableIndex); + branchUnit.branch(clazz, + codeAttribute, + offset, + instructionOffsetValue.instructionOffset(instructionOffsetValue.instructionOffsetCount()-1)); + break; + + default: + throw new IllegalArgumentException("Unknown variable instruction ["+variableInstruction.opcode+"]"); + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + int branchTarget = offset + branchInstruction.branchOffset; + + switch (branchInstruction.opcode) + { + case InstructionConstants.OP_IFEQ: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().equal(valueFactory.createIntegerValue(0))); + break; + + case InstructionConstants.OP_IFNE: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().notEqual(valueFactory.createIntegerValue(0))); + break; + + case InstructionConstants.OP_IFLT: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().lessThan(valueFactory.createIntegerValue(0))); + break; + + case InstructionConstants.OP_IFGE: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().greaterThanOrEqual(valueFactory.createIntegerValue(0))); + break; + + case InstructionConstants.OP_IFGT: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().greaterThan(valueFactory.createIntegerValue(0))); + break; + + case InstructionConstants.OP_IFLE: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().lessThanOrEqual(valueFactory.createIntegerValue(0))); + break; + + + case InstructionConstants.OP_IFICMPEQ: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().equal(stack.ipop())); + break; + + case InstructionConstants.OP_IFICMPNE: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().notEqual(stack.ipop())); + break; + + case InstructionConstants.OP_IFICMPLT: + // Note that the stack entries are popped in reverse order. + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().greaterThan(stack.ipop())); + break; + + case InstructionConstants.OP_IFICMPGE: + // Note that the stack entries are popped in reverse order. + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().lessThanOrEqual(stack.ipop())); + break; + + case InstructionConstants.OP_IFICMPGT: + // Note that the stack entries are popped in reverse order. + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().lessThan(stack.ipop())); + break; + + case InstructionConstants.OP_IFICMPLE: + // Note that the stack entries are popped in reverse order. + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.ipop().greaterThanOrEqual(stack.ipop())); + break; + + case InstructionConstants.OP_IFACMPEQ: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.apop().equal(stack.apop())); + break; + + case InstructionConstants.OP_IFACMPNE: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.apop().notEqual(stack.apop())); + break; + + case InstructionConstants.OP_GOTO: + case InstructionConstants.OP_GOTO_W: + branchUnit.branch(clazz, codeAttribute, offset, branchTarget); + break; + + + case InstructionConstants.OP_JSR: + case InstructionConstants.OP_JSR_W: + stack.push(new InstructionOffsetValue(offset + + branchInstruction.length(offset))); + branchUnit.branch(clazz, codeAttribute, offset, branchTarget); + break; + + case InstructionConstants.OP_IFNULL: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.apop().isNull()); + break; + + case InstructionConstants.OP_IFNONNULL: + branchUnit.branchConditionally(clazz, codeAttribute, offset, branchTarget, + stack.apop().isNotNull()); + break; + + default: + throw new IllegalArgumentException("Unknown branch instruction ["+branchInstruction.opcode+"]"); + } + } + + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + IntegerValue indexValue = stack.ipop(); + + // If there is no definite branch in any of the cases below, + // branch to the default offset. + branchUnit.branch(clazz, codeAttribute, + offset, + offset + tableSwitchInstruction.defaultOffset); + + for (int index = 0; index < tableSwitchInstruction.jumpOffsets.length; index++) + { + int conditional = indexValue.equal(valueFactory.createIntegerValue( + tableSwitchInstruction.lowCase + index)); + branchUnit.branchConditionally(clazz, codeAttribute, + offset, + offset + tableSwitchInstruction.jumpOffsets[index], + conditional); + + // If this branch is always taken, we can skip the rest. + if (conditional == Value.ALWAYS) + { + break; + } + } + } + + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + IntegerValue indexValue = stack.ipop(); + + // If there is no definite branch in any of the cases below, + // branch to the default offset. + branchUnit.branch(clazz, codeAttribute, + offset, + offset + lookUpSwitchInstruction.defaultOffset); + + for (int index = 0; index < lookUpSwitchInstruction.jumpOffsets.length; index++) + { + int conditional = indexValue.equal(valueFactory.createIntegerValue( + lookUpSwitchInstruction.cases[index])); + branchUnit.branchConditionally(clazz, codeAttribute, + offset, + offset + lookUpSwitchInstruction.jumpOffsets[index], + conditional); + + // If this branch is always taken, we can skip the rest. + if (conditional == Value.ALWAYS) + { + break; + } + } + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + cpValue = valueFactory.createIntegerValue(integerConstant.getValue()); + } + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + cpValue = valueFactory.createLongValue(longConstant.getValue()); + } + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + cpValue = valueFactory.createFloatValue(floatConstant.getValue()); + } + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + cpValue = valueFactory.createDoubleValue(doubleConstant.getValue()); + } + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + cpValue = valueFactory.createReferenceValue(ClassConstants.INTERNAL_NAME_JAVA_LANG_STRING, + stringConstant.javaLangStringClass, + false); + } + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + cpValue = handleClassConstantAsClassValue ? + valueFactory.createReferenceValue(ClassConstants.INTERNAL_NAME_JAVA_LANG_CLASS, + classConstant.javaLangClassClass, + false) : + valueFactory.createReferenceValue(classConstant.getName(clazz), + classConstant.referencedClass, + false); + } + + + // Small utility methods. + + /** + * Returns the Value of the constant pool element at the given index. + */ + private Value cpValue(Clazz clazz, + int constantIndex) + { + return cpValue(clazz, constantIndex, false); + } + + + /** + * Returns the Value of the constant pool element at the given index. + */ + private Value cpValue(Clazz clazz, + int constantIndex, + boolean handleClassConstantAsClassValue) + { + this.handleClassConstantAsClassValue = handleClassConstantAsClassValue; + + // Visit the constant pool entry to get its return value. + clazz.constantPoolEntryAccept(constantIndex, this); + + return cpValue; + } +} diff --git a/src/proguard/evaluation/Stack.java b/src/proguard/evaluation/Stack.java new file mode 100644 index 0000000..2808e62 --- /dev/null +++ b/src/proguard/evaluation/Stack.java @@ -0,0 +1,561 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.evaluation.value.*; + +/** + * This class represents an operand stack that contains Value + * objects. + * + * @author Eric Lafortune + */ +public class Stack +{ + private static final TopValue TOP_VALUE = new TopValue(); + + + protected Value[] values; + protected int currentSize; + protected int actualMaxSize; + + + /** + * Creates a new Stack with a given maximum size, accounting for the double + * space required by Category 2 values. + */ + public Stack(int maxSize) + { + values = new Value[maxSize]; + } + + + /** + * Creates a Stack that is a copy of the given Stack. + */ + public Stack(Stack stack) + { + // Create the values array. + this(stack.values.length); + + // Copy the stack contents. + copy(stack); + } + + + /** + * Returns the actual maximum stack size that was required for all stack + * operations, accounting for the double space required by Category 2 values. + */ + public int getActualMaxSize() + { + return actualMaxSize; + } + + + /** + * Resets this Stack, so that it can be reused. + */ + public void reset(int maxSize) + { + // Is the values array large enough? + if (maxSize > values.length) + { + // Create a new one. + values = new Value[maxSize]; + } + + // Clear the sizes. + clear(); + + actualMaxSize = 0; + } + + + /** + * Copies the values of the given Stack into this Stack. + */ + public void copy(Stack other) + { + // Is the values array large enough? + if (other.values.length > values.length) + { + // Create a new one. + values = new Value[other.values.length]; + } + + // Copy the stack contents. + System.arraycopy(other.values, 0, this.values, 0, other.currentSize); + + // Copy the sizes. + currentSize = other.currentSize; + actualMaxSize = other.actualMaxSize; + } + + + /** + * Generalizes the values of this Stack with the values of the given Stack. + * The stacks must have the same current sizes. + * @return whether the generalization has made any difference. + */ + public boolean generalize(Stack other) + { + if (this.currentSize != other.currentSize) + { + throw new IllegalArgumentException("Stacks have different current sizes ["+this.currentSize+"] and ["+other.currentSize+"]"); + } + + boolean changed = false; + + // Generalize the stack values. + for (int index = 0; index < currentSize; index++) + { + Value thisValue = this.values[index]; + + if (thisValue != null) + { + Value newValue = null; + + Value otherValue = other.values[index]; + + if (otherValue != null) + { + newValue = thisValue.generalize(otherValue); + } + + changed = changed || !thisValue.equals(newValue); + + values[index] = newValue; + } + } + + // Check if the other stack extends beyond this one. + if (this.actualMaxSize < other.actualMaxSize) + { + this.actualMaxSize = other.actualMaxSize; + } + + return changed; + } + + + /** + * Clears the stack. + */ + public void clear() + { + // Clear the stack contents. + for (int index = 0; index < currentSize; index++) + { + values[index] = null; + } + + currentSize = 0; + } + + + /** + * Returns the number of elements currently on the stack, accounting for the + * double space required by Category 2 values. + */ + public int size() + { + return currentSize; + } + + + /** + * Gets the specified Value from the stack, without disturbing it. + * @param index the index of the stack element, counting from the bottom + * of the stack. + * @return the value at the specified position. + */ + public Value getBottom(int index) + { + return values[index]; + } + + + /** + * Sets the specified Value on the stack, without disturbing it. + * @param index the index of the stack element, counting from the bottom + * of the stack. + * @param value the value to set. + */ + public void setBottom(int index, Value value) + { + values[index] = value; + } + + + /** + * Gets the specified Value from the stack, without disturbing it. + * @param index the index of the stack element, counting from the top + * of the stack. + * @return the value at the specified position. + */ + public Value getTop(int index) + { + return values[currentSize - index - 1]; + } + + + /** + * Sets the specified Value on the stack, without disturbing it. + * @param index the index of the stack element, counting from the top + * of the stack. + * @param value the value to set. + */ + public void setTop(int index, Value value) + { + values[currentSize - index - 1] = value; + } + + + /** + * Removes the specified Value from the stack. + * @param index the index of the stack element, counting from the top + * of the stack. + */ + public void removeTop(int index) + { + System.arraycopy(values, currentSize - index, + values, currentSize - index - 1, + index); + currentSize--; + } + + + /** + * Pushes the given Value onto the stack. + */ + public void push(Value value) + { + // Account for the extra space required by Category 2 values. + if (value.isCategory2()) + { + values[currentSize++] = TOP_VALUE; + } + + // Push the value. + values[currentSize++] = value; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + + /** + * Pops the top Value from the stack. + */ + public Value pop() + { + Value value = values[--currentSize]; + + values[currentSize] = null; + + // Account for the extra space required by Category 2 values. + if (value.isCategory2()) + { + values[--currentSize] = null; + } + + return value; + } + + + // Pop methods that provide convenient casts to the expected value types. + + /** + * Pops the top IntegerValue from the stack. + */ + public IntegerValue ipop() + { + return pop().integerValue(); + } + + + /** + * Pops the top LongValue from the stack. + */ + public LongValue lpop() + { + return pop().longValue(); + } + + + /** + * Pops the top FloatValue from the stack. + */ + public FloatValue fpop() + { + return pop().floatValue(); + } + + + /** + * Pops the top DoubleValue from the stack. + */ + public DoubleValue dpop() + { + return pop().doubleValue(); + } + + + /** + * Pops the top ReferenceValue from the stack. + */ + public ReferenceValue apop() + { + return pop().referenceValue(); + } + + + /** + * Pops the top InstructionOffsetValue from the stack. + */ + public InstructionOffsetValue opop() + { + return pop().instructionOffsetValue(); + } + + + /** + * Pops the top category 1 value from the stack. + */ + public void pop1() + { + values[--currentSize] = null; + } + + + /** + * Pops the top category 2 value from the stack (or alternatively, two + * Category 1 stack elements). + */ + public void pop2() + { + values[--currentSize] = null; + values[--currentSize] = null; + } + + + /** + * Duplicates the top Category 1 value. + */ + public void dup() + { + values[currentSize] = values[currentSize - 1].category1Value(); + + currentSize++; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + + /** + * Duplicates the top Category 1 value, one Category 1 element down the + * stack. + */ + public void dup_x1() + { + values[currentSize] = values[currentSize - 1].category1Value(); + values[currentSize - 1] = values[currentSize - 2].category1Value(); + values[currentSize - 2] = values[currentSize ]; + + currentSize++; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + + /** + * Duplicates the top Category 1 value, two Category 1 elements (or one + * Category 2 element) down the stack. + */ + public void dup_x2() + { + values[currentSize] = values[currentSize - 1].category1Value(); + values[currentSize - 1] = values[currentSize - 2]; + values[currentSize - 2] = values[currentSize - 3]; + values[currentSize - 3] = values[currentSize ]; + + currentSize++; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + /** + * Duplicates the top Category 2 value (or alternatively, the equivalent + * Category 1 stack elements). + */ + public void dup2() + { + values[currentSize ] = values[currentSize - 2]; + values[currentSize + 1] = values[currentSize - 1]; + + currentSize += 2; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + + /** + * Duplicates the top Category 2 value, one Category 1 element down the + * stack (or alternatively, the equivalent Category 1 stack values). + */ + public void dup2_x1() + { + values[currentSize + 1] = values[currentSize - 1]; + values[currentSize ] = values[currentSize - 2]; + values[currentSize - 1] = values[currentSize - 3]; + values[currentSize - 2] = values[currentSize + 1]; + values[currentSize - 3] = values[currentSize ]; + + currentSize += 2; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + + /** + * Duplicates the top Category 2 value, one Category 2 stack element down + * the stack (or alternatively, the equivalent Category 1 stack values). + */ + public void dup2_x2() + { + values[currentSize + 1] = values[currentSize - 1]; + values[currentSize ] = values[currentSize - 2]; + values[currentSize - 1] = values[currentSize - 3]; + values[currentSize - 2] = values[currentSize - 4]; + values[currentSize - 3] = values[currentSize + 1]; + values[currentSize - 4] = values[currentSize ]; + + currentSize += 2; + + // Update the maximum actual size; + if (actualMaxSize < currentSize) + { + actualMaxSize = currentSize; + } + } + + + /** + * Swaps the top two Category 1 values. + */ + public void swap() + { + Value value1 = values[currentSize - 1].category1Value(); + Value value2 = values[currentSize - 2].category1Value(); + + values[currentSize - 1] = value2; + values[currentSize - 2] = value1; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + Stack other = (Stack)object; + + if (this.currentSize != other.currentSize) + { + return false; + } + + for (int index = 0; index < currentSize; index++) + { + Value thisValue = this.values[index]; + Value otherValue = other.values[index]; + if (thisValue == null ? otherValue != null : + !thisValue.equals(otherValue)) + { + return false; + } + } + + return true; + } + + + public int hashCode() + { + int hashCode = currentSize; + + for (int index = 0; index < currentSize; index++) + { + Value value = values[index]; + if (value != null) + { + hashCode ^= value.hashCode(); + } + } + + return hashCode; + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(); + + for (int index = 0; index < currentSize; index++) + { + Value value = values[index]; + buffer = buffer.append('[') + .append(value == null ? "empty" : value.toString()) + .append(']'); + } + + return buffer.toString(); + } +} diff --git a/src/proguard/evaluation/TracedStack.java b/src/proguard/evaluation/TracedStack.java new file mode 100644 index 0000000..c24f783 --- /dev/null +++ b/src/proguard/evaluation/TracedStack.java @@ -0,0 +1,342 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.evaluation.value.Value; + +/** + * This Stack saves additional information with stack elements, to keep track + * of their origins and destinations. + *

    + * The stack stores a given producer Value along with each Value it stores. + * It then generalizes a given collected Value with the producer Value + * of each Value it loads. The producer Value and the initial collected Value + * can be set; the generalized collected Value can be retrieved. + * + * @author Eric Lafortune + */ +public class TracedStack extends Stack +{ + private Value producerValue; + private Stack producerStack; + + + /** + * Creates a new TracedStack with a given maximum size. + */ + public TracedStack(int maxSize) + { + super(maxSize); + + producerStack = new Stack(maxSize); + } + + + /** + * Creates a new TracedStack that is a copy of the given TracedStack. + */ + public TracedStack(TracedStack tracedStack) + { + super(tracedStack); + + producerStack = new Stack(tracedStack.producerStack); + } + + + /** + * Sets the Value that will be stored along with all push and pop + * instructions. + */ + public void setProducerValue(Value producerValue) + { + this.producerValue = producerValue; + } + + + /** + * Gets the specified producer Value from the stack, without disturbing it. + * @param index the index of the stack element, counting from the bottom + * of the stack. + * @return the producer value at the specified position. + */ + public Value getBottomProducerValue(int index) + { + return producerStack.getBottom(index); + } + + + /** + * Sets the specified producer Value on the stack, without disturbing it. + * @param index the index of the stack element, counting from the bottom + * of the stack. + * @param value the producer value to set. + */ + public void setBottomProducerValue(int index, Value value) + { + producerStack.setBottom(index, value); + } + + + /** + * Gets the specified producer Value from the stack, without disturbing it. + * @param index the index of the stack element, counting from the top + * of the stack. + * @return the producer value at the specified position. + */ + public Value getTopProducerValue(int index) + { + return producerStack.getTop(index); + } + + + /** + * Sets the specified producer Value on the stack, without disturbing it. + * @param index the index of the stack element, counting from the top + * of the stack. + * @param value the producer value to set. + */ + public void setTopProducerValue(int index, Value value) + { + producerStack.setTop(index, value); + } + + + // Implementations for Stack. + + public void reset(int size) + { + super.reset(size); + + producerStack.reset(size); + } + + public void copy(TracedStack other) + { + super.copy(other); + + producerStack.copy(other.producerStack); + } + + public boolean generalize(TracedStack other) + { + return + super.generalize(other) | + producerStack.generalize(other.producerStack); + } + + public void clear() + { + super.clear(); + + producerStack.clear(); + } + + public void removeTop(int index) + { + super.removeTop(index); + + producerStack.removeTop(index); + } + + public void push(Value value) + { + super.push(value); + + producerPush(); + + // Account for the extra space required by Category 2 values. + if (value.isCategory2()) + { + producerPush(); + } + } + + public Value pop() + { + Value value = super.pop(); + + producerPop(); + + // Account for the extra space required by Category 2 values. + if (value.isCategory2()) + { + producerPop(); + } + + return value; + } + + public void pop1() + { + super.pop1(); + + producerPop(); + } + + public void pop2() + { + super.pop2(); + + producerPop(); + producerPop(); + } + + public void dup() + { + super.dup(); + + producerPop(); + producerPush(); + producerPush(); + } + + public void dup_x1() + { + super.dup_x1(); + + producerPop(); + producerPop(); + producerPush(); + producerPush(); + producerPush(); + } + + public void dup_x2() + { + super.dup_x2(); + + producerPop(); + producerPop(); + producerPop(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + } + + public void dup2() + { + super.dup2(); + + producerPop(); + producerPop(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + } + + public void dup2_x1() + { + super.dup2_x1(); + + producerPop(); + producerPop(); + producerPop(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + } + + public void dup2_x2() + { + super.dup2_x2(); + + producerPop(); + producerPop(); + producerPop(); + producerPop(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + producerPush(); + } + + public void swap() + { + super.swap(); + + producerPop(); + producerPop(); + producerPush(); + producerPush(); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + TracedStack other = (TracedStack)object; + + return super.equals(object) && + this.producerStack.equals(other.producerStack); + } + + + public int hashCode() + { + return super.hashCode() ^ + producerStack.hashCode(); + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(); + + for (int index = 0; index < this.size(); index++) + { + Value value = this.values[index]; + Value producerValue = producerStack.getBottom(index); + buffer = buffer.append('[') + .append(producerValue == null ? "empty:" : producerValue.toString()) + .append(value == null ? "empty" : value.toString()) + .append(']'); + } + + return buffer.toString(); + } + + + // Small utility methods. + + private void producerPush() + { + producerStack.push(producerValue); + } + + + private void producerPop() + { + producerStack.pop(); + } +} diff --git a/src/proguard/evaluation/TracedVariables.java b/src/proguard/evaluation/TracedVariables.java new file mode 100644 index 0000000..1ae6ba6 --- /dev/null +++ b/src/proguard/evaluation/TracedVariables.java @@ -0,0 +1,229 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.evaluation.value.Value; + +/** + * This Variables class saves additional information with variables, to keep + * track of their origins. + *

    + * The Variables class stores a given producer Value along with each Value it + * stores. It then generalizes a given collected Value with the producer Value + * of each Value it loads. The producer Value and the initial collected Value + * can be set; the generalized collected Value can be retrieved. + *

    + * In addition, an initialization index can be reset and retrieved, pointing + * to the most recent variable that has been initialized by a store operation. + * + * @author Eric Lafortune + */ +public class TracedVariables extends Variables +{ + public static final int NONE = -1; + + + private Value producerValue; + private Variables producerVariables; + private int initializationIndex; + + + /** + * Creates a new TracedVariables with a given size. + */ + public TracedVariables(int size) + { + super(size); + + producerVariables = new Variables(size); + } + + + /** + * Creates a new TracedVariables that is a copy of the given TracedVariables. + */ + public TracedVariables(TracedVariables tracedVariables) + { + super(tracedVariables); + + producerVariables = new Variables(tracedVariables.producerVariables); + } + + + /** + * Sets the Value that will be stored along with all store instructions. + */ + public void setProducerValue(Value producerValue) + { + this.producerValue = producerValue; + } + + + /** + * Resets the initialization index. + */ + public void resetInitialization() + { + initializationIndex = NONE; + } + + + /** + * Returns the most recent initialization index since it has been reset. + */ + public int getInitializationIndex() + { + return initializationIndex; + } + + + /** + * Gets the producer Value for the specified variable, without disturbing it. + * @param index the variable index. + * @return the producer value of the given variable. + */ + public Value getProducerValue(int index) + { + return producerVariables.getValue(index); + } + + + /** + * Sets the given producer Value for the specified variable, without + * disturbing it. + * @param index the variable index. + * @param value the producer value to set. + */ + public void setProducerValue(int index, Value value) + { + producerVariables.store(index, value); + } + + + // Implementations for Variables. + + public void reset(int size) + { + super.reset(size); + + producerVariables.reset(size); + } + + public void initialize(TracedVariables other) + { + super.initialize(other); + + producerVariables.initialize(other.producerVariables); + } + + public boolean generalize(TracedVariables other, + boolean clearConflictingOtherVariables) + { + boolean variablesChanged = super.generalize(other, clearConflictingOtherVariables); + boolean producersChanged = producerVariables.generalize(other.producerVariables, clearConflictingOtherVariables); + /* consumerVariables.generalize(other.consumerVariables)*/ + + // Clear any traces if a variable has become null. + if (variablesChanged) + { + for (int index = 0; index < size; index++) + { + if (values[index] == null) + { + producerVariables.values[index] = null; + + if (clearConflictingOtherVariables) + { + other.producerVariables.values[index] = null; + } + } + } + } + + return variablesChanged || producersChanged; + } + + + public void store(int index, Value value) + { + // Is this store operation an initialization of the variable? + Value previousValue = super.load(index); + if (previousValue == null || + previousValue.computationalType() != value.computationalType()) + { + initializationIndex = index; + } + + // Store the value itself in the variable. + super.store(index, value); + + // Store the producer value in its producer variable. + producerVariables.store(index, producerValue); + + // Account for the extra space required by Category 2 values. + if (value.isCategory2()) + { + producerVariables.store(index+1, producerValue); + } + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + TracedVariables other = (TracedVariables)object; + + return super.equals(object) && + this.producerVariables.equals(other.producerVariables); + } + + + public int hashCode() + { + return super.hashCode() ^ + producerVariables.hashCode(); + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(); + + for (int index = 0; index < this.size(); index++) + { + Value value = this.values[index]; + Value producerValue = producerVariables.getValue(index); + buffer = buffer.append('[') + .append(producerValue == null ? "empty:" : producerValue.toString()) + .append(value == null ? "empty" : value.toString()) + .append(']'); + } + + return buffer.toString(); + } +} diff --git a/src/proguard/evaluation/Variables.java b/src/proguard/evaluation/Variables.java new file mode 100644 index 0000000..4496aaa --- /dev/null +++ b/src/proguard/evaluation/Variables.java @@ -0,0 +1,348 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation; + +import proguard.evaluation.value.*; + +/** + * This class represents a local variable frame that contains Value + * objects. Values are generalizations of all values that have been stored in + * the respective variables. + * + * @author Eric Lafortune + */ +public class Variables +{ + private static final TopValue TOP_VALUE = new TopValue(); + + + protected Value[] values; + protected int size; + + + /** + * Creates a new Variables object with a given maximum number of variables. + */ + public Variables(int size) + { + this.values = new Value[size]; + this.size = size; + } + + + /** + * Creates a Variables object that is a copy of the given Variables object. + */ + public Variables(Variables variables) + { + // Create the values array. + this(variables.size); + + // Copy the values. + initialize(variables); + } + + + /** + * Resets this Variables object, so that it can be reused. + */ + public void reset(int size) + { + // Is the values array large enough? + if (size > values.length) + { + // Create a new one. + values = new Value[size]; + } + else + { + // Clear the variables. + for (int index = 0; index < values.length; index++) + { + values[index] = null; + } + } + + this.size = size; + } + + + /** + * Initializes the values of this Variables object with the values of the + * given Variables object. The other object may have fewer values, in which + * case the remaining values are left unchanged. + */ + public void initialize(Variables other) + { + if (this.size < other.size) + { + throw new IllegalArgumentException("Variable frame is too small ["+this.size+"] compared to other frame ["+other.size+"]"); + } + + // Copy the values. + System.arraycopy(other.values, 0, this.values, 0, other.size); + } + + + /** + * Generalizes the values of this Variables object with the values of the + * given Variables object. + * @param clearConflictingOtherVariables specifies whether the other + * variables should be cleared too, + * in case of conflicts. + * @return whether the generalization has made any difference. + */ + public boolean generalize(Variables other, + boolean clearConflictingOtherVariables) + { + if (this.size != other.size) + { + throw new IllegalArgumentException("Variable frames have different sizes ["+this.size+"] and ["+other.size+"]"); + } + + boolean changed = false; + + for (int index = 0; index < size; index++) + { + Value thisValue = this.values[index]; + Value otherValue = other.values[index]; + + // Occasionally, two values of different types might be present + // in the same variable in a variable frame (corresponding to + // two local variables that share the same index), at some point + // outside of their scopes. Don't generalize the variable then, + // but let it clear instead. + if (thisValue != null && + otherValue != null && + thisValue.computationalType() == otherValue.computationalType()) + { + Value newValue = thisValue.generalize(otherValue); + + changed = changed || !thisValue.equals(newValue); + + this.values[index] = newValue; + } + else + { + changed = changed || thisValue != null; + + this.values[index] = null; + + if (clearConflictingOtherVariables) + { + other.values[index] = null; + } + } + } + + return changed; + } + + + /** + * Returns the number of variables. + */ + public int size() + { + return size; + } + + + /** + * Gets the Value of the variable with the given index, without disturbing it. + */ + public Value getValue(int index) + { + if (index < 0 || + index >= size) + { + throw new IndexOutOfBoundsException("Variable index ["+index+"] out of bounds ["+size+"]"); + } + + return values[index]; + } + + + /** + * Stores the given Value at the given variable index. + */ + public void store(int index, Value value) + { + if (index < 0 || + index >= size) + { + throw new IndexOutOfBoundsException("Variable index ["+index+"] out of bounds ["+size+"]"); + } + + // Store the value. + values[index] = value; + + // Account for the extra space required by Category 2 values. + if (value.isCategory2()) + { + values[index + 1] = TOP_VALUE; + } + } + + + /** + * Loads the Value from the variable with the given index. + */ + public Value load(int index) + { + if (index < 0 || + index >= size) + { + throw new IndexOutOfBoundsException("Variable index ["+index+"] out of bounds ["+size+"]"); + } + + return values[index]; + } + + + // Load methods that provide convenient casts to the expected value types. + + /** + * Loads the IntegerValue from the variable with the given index. + */ + public IntegerValue iload(int index) + { + return load(index).integerValue(); + } + + + /** + * Loads the LongValue from the variable with the given index. + */ + public LongValue lload(int index) + { + return load(index).longValue(); + } + + + /** + * Loads the FloatValue from the variable with the given index. + */ + public FloatValue fload(int index) + { + return load(index).floatValue(); + } + + + /** + * Loads the DoubleValue from the variable with the given index. + */ + public DoubleValue dload(int index) + { + return load(index).doubleValue(); + } + + + /** + * Loads the ReferenceValue from the variable with the given index. + */ + public ReferenceValue aload(int index) + { + return load(index).referenceValue(); + } + + + /** + * Loads the InstructionOffsetValue from the variable with the given index. + */ + public InstructionOffsetValue oload(int index) + { + return load(index).instructionOffsetValue(); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + Variables other = (Variables)object; + + if (this.size != other.size) + { + return false; + } + + for (int index = 0; index < size; index++) + { + Value thisValue = this.values[index]; + Value otherValue = other.values[index]; + + // Occasionally, two values of different types might be + // present in the same variable in a variable frame + // (corresponding to two local variables that share the + // same index), at some point outside of their scopes. + // We'll ignore these. + if (thisValue != null && + otherValue != null && + thisValue.computationalType() == otherValue.computationalType() && + !thisValue.equals(otherValue)) + { + return false; + } + } + + return true; + } + + + public int hashCode() + { + int hashCode = size; + + for (int index = 0; index < size; index++) + { + Value value = values[index]; + if (value != null) + { + hashCode ^= value.hashCode(); + } + } + + return hashCode; + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(); + + for (int index = 0; index < size; index++) + { + Value value = values[index]; + buffer = buffer.append('[') + .append(value == null ? "empty" : value.toString()) + .append(']'); + } + + return buffer.toString(); + } +} diff --git a/src/proguard/evaluation/value/Category1Value.java b/src/proguard/evaluation/value/Category1Value.java new file mode 100644 index 0000000..b8c5db2 --- /dev/null +++ b/src/proguard/evaluation/value/Category1Value.java @@ -0,0 +1,41 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This abstract class represents a partially evaluated Category 1 value. + * + * @author Eric Lafortune + */ +public abstract class Category1Value extends Value +{ + // Implementations for Value. + + public final Category1Value category1Value() + { + return this; + } + + public final boolean isCategory2() + { + return false; + } +} diff --git a/src/proguard/evaluation/value/Category2Value.java b/src/proguard/evaluation/value/Category2Value.java new file mode 100644 index 0000000..65916c7 --- /dev/null +++ b/src/proguard/evaluation/value/Category2Value.java @@ -0,0 +1,41 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This abstract class represents a partially evaluated Category 2 value. + * + * @author Eric Lafortune + */ +public abstract class Category2Value extends Value +{ + // Implementations for Value. + + public final Category2Value category2Value() + { + return this; + } + + public final boolean isCategory2() + { + return true; + } +} diff --git a/src/proguard/evaluation/value/ComparisonValue.java b/src/proguard/evaluation/value/ComparisonValue.java new file mode 100644 index 0000000..e4e2e02 --- /dev/null +++ b/src/proguard/evaluation/value/ComparisonValue.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents the result of a comparisons of two scalar + * values. + * + * @author Eric Lafortune + */ +final class ComparisonValue extends SpecificIntegerValue +{ + private final Value value1; + private final Value value2; + + + /** + * Creates a new comparison integer value of the two given scalar values. + */ + public ComparisonValue(Value integerValue1, + Value integerValue2) + { + this.value1 = integerValue1; + this.value2 = integerValue2; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value1.equals(((ComparisonValue)object).value1) && + this.value2.equals(((ComparisonValue)object).value2); + } + + + public int hashCode() + { + return super.hashCode() ^ + value1.hashCode() ^ + value2.hashCode(); + } + + + public String toString() + { + return "("+value1+"~"+ value2 +")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/CompositeDoubleValue.java b/src/proguard/evaluation/value/CompositeDoubleValue.java new file mode 100644 index 0000000..a6d48ef --- /dev/null +++ b/src/proguard/evaluation/value/CompositeDoubleValue.java @@ -0,0 +1,81 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This DoubleValue represents the result of a binary operation on two double + * values. + * + * @author Eric Lafortune + */ +final class CompositeDoubleValue extends SpecificDoubleValue +{ + public static final byte ADD = '+'; + public static final byte SUBTRACT = '-'; + public static final byte MULTIPLY = '*'; + public static final byte DIVIDE = '/'; + public static final byte REMAINDER = '%'; + + + private final DoubleValue doubleValue1; + private final byte operation; + private final DoubleValue doubleValue2; + + + /** + * Creates a new composite double value of the two given double values + * and the given operation. + */ + public CompositeDoubleValue(DoubleValue doubleValue1, + byte operation, + DoubleValue doubleValue2) + { + this.doubleValue1 = doubleValue1; + this.operation = operation; + this.doubleValue2 = doubleValue2; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.doubleValue1.equals(((CompositeDoubleValue)object).doubleValue1) && + this.operation == ((CompositeDoubleValue)object).operation && + this.doubleValue2.equals(((CompositeDoubleValue)object).doubleValue2); + } + + + public int hashCode() + { + return super.hashCode() ^ + doubleValue1.hashCode() ^ + doubleValue2.hashCode(); + } + + + public String toString() + { + return "("+doubleValue1+((char)operation)+doubleValue2+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/CompositeFloatValue.java b/src/proguard/evaluation/value/CompositeFloatValue.java new file mode 100644 index 0000000..4df890a --- /dev/null +++ b/src/proguard/evaluation/value/CompositeFloatValue.java @@ -0,0 +1,81 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This FloatValue represents the result of a binary operation on two float + * values. + * + * @author Eric Lafortune + */ +final class CompositeFloatValue extends SpecificFloatValue +{ + public static final byte ADD = '+'; + public static final byte SUBTRACT = '-'; + public static final byte MULTIPLY = '*'; + public static final byte DIVIDE = '/'; + public static final byte REMAINDER = '%'; + + + private final FloatValue floatValue1; + private final byte operation; + private final FloatValue floatValue2; + + + /** + * Creates a new composite float value of the two given float values + * and the given operation. + */ + public CompositeFloatValue(FloatValue floatValue1, + byte operation, + FloatValue floatValue2) + { + this.floatValue1 = floatValue1; + this.operation = operation; + this.floatValue2 = floatValue2; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.floatValue1.equals(((CompositeFloatValue)object).floatValue1) && + this.operation == ((CompositeFloatValue)object).operation && + this.floatValue2.equals(((CompositeFloatValue)object).floatValue2); + } + + + public int hashCode() + { + return super.hashCode() ^ + floatValue1.hashCode() ^ + floatValue2.hashCode(); + } + + + public String toString() + { + return "("+floatValue1+((char)operation)+floatValue2+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/CompositeIntegerValue.java b/src/proguard/evaluation/value/CompositeIntegerValue.java new file mode 100644 index 0000000..6d4f59c --- /dev/null +++ b/src/proguard/evaluation/value/CompositeIntegerValue.java @@ -0,0 +1,87 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents the result of a binary operation on two integer + * values. + * + * @author Eric Lafortune + */ +final class CompositeIntegerValue extends SpecificIntegerValue +{ + public static final byte ADD = '+'; + public static final byte SUBTRACT = '-'; + public static final byte MULTIPLY = '*'; + public static final byte DIVIDE = '/'; + public static final byte REMAINDER = '%'; + public static final byte SHIFT_LEFT = '<'; + public static final byte SHIFT_RIGHT = '>'; + public static final byte UNSIGNED_SHIFT_RIGHT = '}'; + public static final byte AND = '&'; + public static final byte OR = '|'; + public static final byte XOR = '^'; + + + private final IntegerValue integerValue1; + private final byte operation; + private final IntegerValue integerValue2; + + + /** + * Creates a new composite integer value of the two given integer values + * and the given operation. + */ + public CompositeIntegerValue(IntegerValue integerValue1, + byte operation, + IntegerValue integerValue2) + { + this.integerValue1 = integerValue1; + this.operation = operation; + this.integerValue2 = integerValue2; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.integerValue1.equals(((CompositeIntegerValue)object).integerValue1) && + this.operation == ((CompositeIntegerValue)object).operation && + this.integerValue2.equals(((CompositeIntegerValue)object).integerValue2); + } + + + public int hashCode() + { + return super.hashCode() ^ + integerValue1.hashCode() ^ + integerValue2.hashCode(); + } + + + public String toString() + { + return "("+integerValue1+((char)operation)+integerValue2+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/CompositeLongValue.java b/src/proguard/evaluation/value/CompositeLongValue.java new file mode 100644 index 0000000..7f63211 --- /dev/null +++ b/src/proguard/evaluation/value/CompositeLongValue.java @@ -0,0 +1,87 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This LongValue represents the result of a binary operation on two long + * values. + * + * @author Eric Lafortune + */ +final class CompositeLongValue extends SpecificLongValue +{ + public static final byte ADD = '+'; + public static final byte SUBTRACT = '-'; + public static final byte MULTIPLY = '*'; + public static final byte DIVIDE = '/'; + public static final byte REMAINDER = '%'; + public static final byte SHIFT_LEFT = '<'; + public static final byte SHIFT_RIGHT = '>'; + public static final byte UNSIGNED_SHIFT_RIGHT = '}'; + public static final byte AND = '&'; + public static final byte OR = '|'; + public static final byte XOR = '^'; + + + private final LongValue longValue1; + private final byte operation; + private final Value longValue2; + + + /** + * Creates a new composite long value of the two given long values + * and the given operation. + */ + public CompositeLongValue(LongValue longValue1, + byte operation, + Value longValue2) + { + this.longValue1 = longValue1; + this.operation = operation; + this.longValue2 = longValue2; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.longValue1.equals(((CompositeLongValue)object).longValue1) && + this.operation == ((CompositeLongValue)object).operation && + this.longValue2.equals(((CompositeLongValue)object).longValue2); + } + + + public int hashCode() + { + return super.hashCode() ^ + longValue1.hashCode() ^ + longValue2.hashCode(); + } + + + public String toString() + { + return "("+longValue1+((char)operation)+longValue2+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedByteValue.java b/src/proguard/evaluation/value/ConvertedByteValue.java new file mode 100644 index 0000000..7ab5d0a --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedByteValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a byte value that is converted from an + * integer value. + * + * @author Eric Lafortune + */ +final class ConvertedByteValue extends SpecificIntegerValue +{ + private final IntegerValue value; + + + /** + * Creates a new converted byte value of the given integer value. + */ + public ConvertedByteValue(IntegerValue value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedByteValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(byte)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedCharacterValue.java b/src/proguard/evaluation/value/ConvertedCharacterValue.java new file mode 100644 index 0000000..76568d1 --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedCharacterValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a character value that is converted from an + * integer value. + * + * @author Eric Lafortune + */ +final class ConvertedCharacterValue extends SpecificIntegerValue +{ + private final IntegerValue value; + + + /** + * Creates a new converted character value of the given integer value. + */ + public ConvertedCharacterValue(IntegerValue value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedCharacterValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(char)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedDoubleValue.java b/src/proguard/evaluation/value/ConvertedDoubleValue.java new file mode 100644 index 0000000..a6afe34 --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedDoubleValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This DoubleValue represents a double value that is converted from another + * scalar value. + * + * @author Eric Lafortune + */ +final class ConvertedDoubleValue extends SpecificDoubleValue +{ + private final Value value; + + + /** + * Creates a new converted double value of the given value. + */ + public ConvertedDoubleValue(Value value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedDoubleValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(double)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedFloatValue.java b/src/proguard/evaluation/value/ConvertedFloatValue.java new file mode 100644 index 0000000..33683b7 --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedFloatValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This FloatValue represents a float value that is converted from another + * scalar value. + * + * @author Eric Lafortune + */ +final class ConvertedFloatValue extends SpecificFloatValue +{ + private final Value value; + + + /** + * Creates a new converted float value of the given value. + */ + public ConvertedFloatValue(Value value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedFloatValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(float)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedIntegerValue.java b/src/proguard/evaluation/value/ConvertedIntegerValue.java new file mode 100644 index 0000000..aecb533 --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedIntegerValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a integer value that is converted from another + * scalar value. + * + * @author Eric Lafortune + */ +final class ConvertedIntegerValue extends SpecificIntegerValue +{ + private final Value value; + + + /** + * Creates a new converted integer value of the given value. + */ + public ConvertedIntegerValue(Value value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedIntegerValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(int)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedLongValue.java b/src/proguard/evaluation/value/ConvertedLongValue.java new file mode 100644 index 0000000..ec97008 --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedLongValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This LongValue represents a long value that is converted from another + * scalar value. + * + * @author Eric Lafortune + */ +final class ConvertedLongValue extends SpecificLongValue +{ + private final Value value; + + + /** + * Creates a new converted long value of the given value. + */ + public ConvertedLongValue(Value value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedLongValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(long)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ConvertedShortValue.java b/src/proguard/evaluation/value/ConvertedShortValue.java new file mode 100644 index 0000000..ab79b49 --- /dev/null +++ b/src/proguard/evaluation/value/ConvertedShortValue.java @@ -0,0 +1,64 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a short value that is converted from an + * integer value. + * + * @author Eric Lafortune + */ +final class ConvertedShortValue extends SpecificIntegerValue +{ + private final IntegerValue value; + + + /** + * Creates a new converted short value of the given integer value. + */ + public ConvertedShortValue(IntegerValue value) + { + this.value = value; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.value.equals(((ConvertedShortValue)object).value); + } + + + public int hashCode() + { + return super.hashCode() ^ + value.hashCode(); + } + + + public String toString() + { + return "(short)("+value+")"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/DoubleValue.java b/src/proguard/evaluation/value/DoubleValue.java new file mode 100644 index 0000000..e39ee5c --- /dev/null +++ b/src/proguard/evaluation/value/DoubleValue.java @@ -0,0 +1,364 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.ClassConstants; + +/** + * This class represents a partially evaluated double value. + * + * @author Eric Lafortune + */ +public abstract class DoubleValue extends Category2Value +{ + /** + * Returns the specific double value, if applicable. + */ + public double value() + { + return 0.0; + } + + + // Basic unary methods. + + /** + * Returns the negated value of this DoubleValue. + */ + public abstract DoubleValue negate(); + + /** + * Converts this DoubleValue to an IntegerValue. + */ + public abstract IntegerValue convertToInteger(); + + /** + * Converts this DoubleValue to a LongValue. + */ + public abstract LongValue convertToLong(); + + /** + * Converts this DoubleValue to a FloatValue. + */ + public abstract FloatValue convertToFloat(); + + + // Basic binary methods. + + /** + * Returns the generalization of this DoubleValue and the given other + * DoubleValue. + */ + public abstract DoubleValue generalize(DoubleValue other); + + + /** + * Returns the sum of this DoubleValue and the given DoubleValue. + */ + public abstract DoubleValue add(DoubleValue other); + + /** + * Returns the difference of this DoubleValue and the given DoubleValue. + */ + public abstract DoubleValue subtract(DoubleValue other); + + /** + * Returns the difference of the given DoubleValue and this DoubleValue. + */ + public abstract DoubleValue subtractFrom(DoubleValue other); + + /** + * Returns the product of this DoubleValue and the given DoubleValue. + */ + public abstract DoubleValue multiply(DoubleValue other); + + /** + * Returns the quotient of this DoubleValue and the given DoubleValue. + */ + public abstract DoubleValue divide(DoubleValue other); + + /** + * Returns the quotient of the given DoubleValue and this DoubleValue. + */ + public abstract DoubleValue divideOf(DoubleValue other); + + /** + * Returns the remainder of this DoubleValue divided by the given DoubleValue. + */ + public abstract DoubleValue remainder(DoubleValue other); + + /** + * Returns the remainder of the given DoubleValue divided by this DoubleValue. + */ + public abstract DoubleValue remainderOf(DoubleValue other); + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this DoubleValue is + * less than, equal to, or greater than the given DoubleValue, respectively. + */ + public abstract IntegerValue compare(DoubleValue other); + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this DoubleValue is + * less than, equal to, or greater than the given DoubleValue, respectively. + */ + public final IntegerValue compareReverse(DoubleValue other) + { + return compare(other).negate(); + } + + + // Similar binary methods, but this time with more specific arguments. + + /** + * Returns the generalization of this DoubleValue and the given other + * SpecificDoubleValue. + */ + public DoubleValue generalize(SpecificDoubleValue other) + { + return generalize((DoubleValue)other); + } + + + /** + * Returns the sum of this DoubleValue and the given SpecificDoubleValue. + */ + public DoubleValue add(SpecificDoubleValue other) + { + return add((DoubleValue)other); + } + + /** + * Returns the difference of this DoubleValue and the given SpecificDoubleValue. + */ + public DoubleValue subtract(SpecificDoubleValue other) + { + return subtract((DoubleValue)other); + } + + /** + * Returns the difference of the given SpecificDoubleValue and this DoubleValue. + */ + public DoubleValue subtractFrom(SpecificDoubleValue other) + { + return subtractFrom((DoubleValue)other); + } + + /** + * Returns the product of this DoubleValue and the given SpecificDoubleValue. + */ + public DoubleValue multiply(SpecificDoubleValue other) + { + return multiply((DoubleValue)other); + } + + /** + * Returns the quotient of this DoubleValue and the given SpecificDoubleValue. + */ + public DoubleValue divide(SpecificDoubleValue other) + { + return divide((DoubleValue)other); + } + + /** + * Returns the quotient of the given SpecificDoubleValue and this + * DoubleValue. + */ + public DoubleValue divideOf(SpecificDoubleValue other) + { + return divideOf((DoubleValue)other); + } + + /** + * Returns the remainder of this DoubleValue divided by the given + * SpecificDoubleValue. + */ + public DoubleValue remainder(SpecificDoubleValue other) + { + return remainder((DoubleValue)other); + } + + /** + * Returns the remainder of the given SpecificDoubleValue and this + * DoubleValue. + */ + public DoubleValue remainderOf(SpecificDoubleValue other) + { + return remainderOf((DoubleValue)other); + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this DoubleValue is + * less than, equal to, or greater than the given SpecificDoubleValue, + * respectively. + */ + public IntegerValue compare(SpecificDoubleValue other) + { + return compare((DoubleValue)other); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this DoubleValue is + * less than, equal to, or greater than the given SpecificDoubleValue, + * respectively. + */ + public final IntegerValue compareReverse(SpecificDoubleValue other) + { + return compare(other).negate(); + } + + + // Similar binary methods, but this time with particular arguments. + + /** + * Returns the generalization of this DoubleValue and the given other + * ParticularDoubleValue. + */ + public DoubleValue generalize(ParticularDoubleValue other) + { + return generalize((SpecificDoubleValue)other); + } + + + /** + * Returns the sum of this DoubleValue and the given ParticularDoubleValue. + */ + public DoubleValue add(ParticularDoubleValue other) + { + return add((SpecificDoubleValue)other); + } + + /** + * Returns the difference of this DoubleValue and the given ParticularDoubleValue. + */ + public DoubleValue subtract(ParticularDoubleValue other) + { + return subtract((SpecificDoubleValue)other); + } + + /** + * Returns the difference of the given ParticularDoubleValue and this DoubleValue. + */ + public DoubleValue subtractFrom(ParticularDoubleValue other) + { + return subtractFrom((SpecificDoubleValue)other); + } + + /** + * Returns the product of this DoubleValue and the given ParticularDoubleValue. + */ + public DoubleValue multiply(ParticularDoubleValue other) + { + return multiply((SpecificDoubleValue)other); + } + + /** + * Returns the quotient of this DoubleValue and the given ParticularDoubleValue. + */ + public DoubleValue divide(ParticularDoubleValue other) + { + return divide((SpecificDoubleValue)other); + } + + /** + * Returns the quotient of the given ParticularDoubleValue and this + * DoubleValue. + */ + public DoubleValue divideOf(ParticularDoubleValue other) + { + return divideOf((SpecificDoubleValue)other); + } + + /** + * Returns the remainder of this DoubleValue divided by the given + * ParticularDoubleValue. + */ + public DoubleValue remainder(ParticularDoubleValue other) + { + return remainder((SpecificDoubleValue)other); + } + + /** + * Returns the remainder of the given ParticularDoubleValue and this + * DoubleValue. + */ + public DoubleValue remainderOf(ParticularDoubleValue other) + { + return remainderOf((SpecificDoubleValue)other); + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this DoubleValue is + * less than, equal to, or greater than the given ParticularDoubleValue, + * respectively. + */ + public IntegerValue compare(ParticularDoubleValue other) + { + return compare((SpecificDoubleValue)other); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this DoubleValue is + * less than, equal to, or greater than the given ParticularDoubleValue, + * respectively. + */ + public final IntegerValue compareReverse(ParticularDoubleValue other) + { + return compare(other).negate(); + } + + + // Implementations for Value. + + public final DoubleValue doubleValue() + { + return this; + } + + public Value refresh() + { + return this; + } + + public final Value generalize(Value other) + { + return this.generalize(other.doubleValue()); + } + + public final int computationalType() + { + return TYPE_DOUBLE; + } + + public final String internalType() + { + return String.valueOf(ClassConstants.INTERNAL_TYPE_DOUBLE); + } +} diff --git a/src/proguard/evaluation/value/FloatValue.java b/src/proguard/evaluation/value/FloatValue.java new file mode 100644 index 0000000..b30e395 --- /dev/null +++ b/src/proguard/evaluation/value/FloatValue.java @@ -0,0 +1,359 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.ClassConstants; + +/** + * This class represents a partially evaluated float value. + * + * @author Eric Lafortune + */ +public abstract class FloatValue extends Category1Value +{ + /** + * Returns the specific float value, if applicable. + */ + public float value() + { + return 0f; + } + + + // Basic unary methods. + + /** + * Returns the negated value of this FloatValue. + */ + public abstract FloatValue negate(); + + /** + * Converts this FloatValue to an IntegerValue. + */ + public abstract IntegerValue convertToInteger(); + + /** + * Converts this FloatValue to a LongValue. + */ + public abstract LongValue convertToLong(); + + /** + * Converts this FloatValue to a DoubleValue. + */ + public abstract DoubleValue convertToDouble(); + + + // Basic binary methods. + + /** + * Returns the generalization of this FloatValue and the given other + * FloatValue. + */ + public abstract FloatValue generalize(FloatValue other); + + + /** + * Returns the sum of this FloatValue and the given FloatValue. + */ + public abstract FloatValue add(FloatValue other); + + /** + * Returns the difference of this FloatValue and the given FloatValue. + */ + public abstract FloatValue subtract(FloatValue other); + + /** + * Returns the difference of the given FloatValue and this FloatValue. + */ + public abstract FloatValue subtractFrom(FloatValue other); + + /** + * Returns the product of this FloatValue and the given FloatValue. + */ + public abstract FloatValue multiply(FloatValue other); + + /** + * Returns the quotient of this FloatValue and the given FloatValue. + */ + public abstract FloatValue divide(FloatValue other); + + /** + * Returns the quotient of the given FloatValue and this FloatValue. + */ + public abstract FloatValue divideOf(FloatValue other); + + /** + * Returns the remainder of this FloatValue divided by the given FloatValue. + */ + public abstract FloatValue remainder(FloatValue other); + + /** + * Returns the remainder of the given FloatValue divided by this FloatValue. + */ + public abstract FloatValue remainderOf(FloatValue other); + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this FloatValue is + * less than, equal to, or greater than the given FloatValue, respectively. + */ + public abstract IntegerValue compare(FloatValue other); + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this FloatValue is + * less than, equal to, or greater than the given FloatValue, respectively. + */ + public final IntegerValue compareReverse(FloatValue other) + { + return compare(other).negate(); + } + + + // Similar binary methods, but this time with more specific arguments. + + /** + * Returns the generalization of this FloatValue and the given other + * SpecificFloatValue. + */ + public FloatValue generalize(SpecificFloatValue other) + { + return generalize((FloatValue)other); + } + + + /** + * Returns the sum of this FloatValue and the given SpecificFloatValue. + */ + public FloatValue add(SpecificFloatValue other) + { + return add((FloatValue)other); + } + + /** + * Returns the difference of this FloatValue and the given SpecificFloatValue. + */ + public FloatValue subtract(SpecificFloatValue other) + { + return subtract((FloatValue)other); + } + + /** + * Returns the difference of the given SpecificFloatValue and this FloatValue. + */ + public FloatValue subtractFrom(SpecificFloatValue other) + { + return subtractFrom((FloatValue)other); + } + + /** + * Returns the product of this FloatValue and the given SpecificFloatValue. + */ + public FloatValue multiply(SpecificFloatValue other) + { + return multiply((FloatValue)other); + } + + /** + * Returns the quotient of this FloatValue and the given SpecificFloatValue. + */ + public FloatValue divide(SpecificFloatValue other) + { + return divide((FloatValue)other); + } + + /** + * Returns the quotient of the given SpecificFloatValue and this + * FloatValue. + */ + public FloatValue divideOf(SpecificFloatValue other) + { + return divideOf((FloatValue)other); + } + + /** + * Returns the remainder of this FloatValue divided by the given + * SpecificFloatValue. + */ + public FloatValue remainder(SpecificFloatValue other) + { + return remainder((FloatValue)other); + } + + /** + * Returns the remainder of the given SpecificFloatValue and this + * FloatValue. + */ + public FloatValue remainderOf(SpecificFloatValue other) + { + return remainderOf((FloatValue)other); + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this FloatValue is + * less than, equal to, or greater than the given SpecificFloatValue, + * respectively. + */ + public IntegerValue compare(SpecificFloatValue other) + { + return compare((FloatValue)other); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this FloatValue is + * less than, equal to, or greater than the given SpecificFloatValue, + * respectively. + */ + public final IntegerValue compareReverse(SpecificFloatValue other) + { + return compare(other).negate(); + } + + + // Similar binary methods, but this time with particular arguments. + + /** + * Returns the generalization of this FloatValue and the given other + * ParticularFloatValue. + */ + public FloatValue generalize(ParticularFloatValue other) + { + return generalize((SpecificFloatValue)other); + } + + + /** + * Returns the sum of this FloatValue and the given ParticularFloatValue. + */ + public FloatValue add(ParticularFloatValue other) + { + return add((SpecificFloatValue)other); + } + + /** + * Returns the difference of this FloatValue and the given ParticularFloatValue. + */ + public FloatValue subtract(ParticularFloatValue other) + { + return subtract((SpecificFloatValue)other); + } + + /** + * Returns the difference of the given ParticularFloatValue and this FloatValue. + */ + public FloatValue subtractFrom(ParticularFloatValue other) + { + return subtractFrom((SpecificFloatValue)other); + } + + /** + * Returns the product of this FloatValue and the given ParticularFloatValue. + */ + public FloatValue multiply(ParticularFloatValue other) + { + return multiply((SpecificFloatValue)other); + } + + /** + * Returns the quotient of this FloatValue and the given ParticularFloatValue. + */ + public FloatValue divide(ParticularFloatValue other) + { + return divide((SpecificFloatValue)other); + } + + /** + * Returns the quotient of the given ParticularFloatValue and this + * FloatValue. + */ + public FloatValue divideOf(ParticularFloatValue other) + { + return divideOf((SpecificFloatValue)other); + } + + /** + * Returns the remainder of this FloatValue divided by the given + * ParticularFloatValue. + */ + public FloatValue remainder(ParticularFloatValue other) + { + return remainder((SpecificFloatValue)other); + } + + /** + * Returns the remainder of the given ParticularFloatValue and this + * FloatValue. + */ + public FloatValue remainderOf(ParticularFloatValue other) + { + return remainderOf((SpecificFloatValue)other); + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this FloatValue is + * less than, equal to, or greater than the given ParticularFloatValue, + * respectively. + */ + public IntegerValue compare(ParticularFloatValue other) + { + return compare((SpecificFloatValue)other); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this FloatValue is + * less than, equal to, or greater than the given ParticularFloatValue, + * respectively. + */ + public final IntegerValue compareReverse(ParticularFloatValue other) + { + return compare(other).negate(); + } + + + // Implementations for Value. + + public final FloatValue floatValue() + { + return this; + } + + public final Value generalize(Value other) + { + return this.generalize(other.floatValue()); + } + + public final int computationalType() + { + return TYPE_FLOAT; + } + + public final String internalType() + { + return String.valueOf(ClassConstants.INTERNAL_TYPE_FLOAT); + } +} diff --git a/src/proguard/evaluation/value/IdentifiedDoubleValue.java b/src/proguard/evaluation/value/IdentifiedDoubleValue.java new file mode 100644 index 0000000..4009c6e --- /dev/null +++ b/src/proguard/evaluation/value/IdentifiedDoubleValue.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This DoubleValue represents a double value that is identified by a unique ID. + * + * @author Eric Lafortune + */ +final class IdentifiedDoubleValue extends SpecificDoubleValue +{ + private final ValueFactory valuefactory; + private final int id; + + + /** + * Creates a new double value with the given ID. + */ + public IdentifiedDoubleValue(ValueFactory valuefactory, int id) + { + this.valuefactory = valuefactory; + this.id = id; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.valuefactory.equals(((IdentifiedDoubleValue)object).valuefactory) && + this.id == ((IdentifiedDoubleValue)object).id; + } + + + public int hashCode() + { + return super.hashCode() ^ + valuefactory.hashCode() ^ + id; + } + + + public String toString() + { + return "d"+id; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/IdentifiedFloatValue.java b/src/proguard/evaluation/value/IdentifiedFloatValue.java new file mode 100644 index 0000000..87bed64 --- /dev/null +++ b/src/proguard/evaluation/value/IdentifiedFloatValue.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This FloatValue represents a float value that is identified by a unique ID. + * + * @author Eric Lafortune + */ +final class IdentifiedFloatValue extends SpecificFloatValue +{ + private final ValueFactory valuefactory; + private final int id; + + + /** + * Creates a new float value with the given ID. + */ + public IdentifiedFloatValue(ValueFactory valuefactory, int id) + { + this.valuefactory = valuefactory; + this.id = id; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.valuefactory.equals(((IdentifiedFloatValue)object).valuefactory) && + this.id == ((IdentifiedFloatValue)object).id; + } + + + public int hashCode() + { + return super.hashCode() ^ + valuefactory.hashCode() ^ + id; + } + + + public String toString() + { + return "f"+id; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/IdentifiedIntegerValue.java b/src/proguard/evaluation/value/IdentifiedIntegerValue.java new file mode 100644 index 0000000..66e88ee --- /dev/null +++ b/src/proguard/evaluation/value/IdentifiedIntegerValue.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a integer value that is identified by a unique ID. + * + * @author Eric Lafortune + */ +final class IdentifiedIntegerValue extends SpecificIntegerValue +{ + private final ValueFactory valuefactory; + private final int id; + + + /** + * Creates a new integer value with the given ID. + */ + public IdentifiedIntegerValue(ValueFactory valuefactory, int id) + { + this.valuefactory = valuefactory; + this.id = id; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.valuefactory.equals(((IdentifiedIntegerValue)object).valuefactory) && + this.id == ((IdentifiedIntegerValue)object).id; + } + + + public int hashCode() + { + return super.hashCode() ^ + valuefactory.hashCode() ^ + id; + } + + + public String toString() + { + return "i"+id; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/IdentifiedLongValue.java b/src/proguard/evaluation/value/IdentifiedLongValue.java new file mode 100644 index 0000000..eea1816 --- /dev/null +++ b/src/proguard/evaluation/value/IdentifiedLongValue.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This LongValue represents a long value that is identified by a unique ID. + * + * @author Eric Lafortune + */ +final class IdentifiedLongValue extends SpecificLongValue +{ + private final ValueFactory valuefactory; + private final int id; + + + /** + * Creates a new long value with the given ID. + */ + public IdentifiedLongValue(ValueFactory valuefactory, int id) + { + this.valuefactory = valuefactory; + this.id = id; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.valuefactory.equals(((IdentifiedLongValue)object).valuefactory) && + this.id == ((IdentifiedLongValue)object).id; + } + + + public int hashCode() + { + return super.hashCode() ^ + valuefactory.hashCode() ^ + id; + } + + + public String toString() + { + return "l"+id; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/IdentifiedReferenceValue.java b/src/proguard/evaluation/value/IdentifiedReferenceValue.java new file mode 100644 index 0000000..cb5efc1 --- /dev/null +++ b/src/proguard/evaluation/value/IdentifiedReferenceValue.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.Clazz; + +/** + * This LongValue represents a reference value that is identified by a unique ID. + * + * @author Eric Lafortune + */ +final class IdentifiedReferenceValue extends ReferenceValue +{ + private final ValueFactory valuefactory; + private final int id; + + + /** + * Creates a new long value with the given ID. + */ + public IdentifiedReferenceValue(String type, + Clazz referencedClass, + boolean mayBeNull, + ValueFactory valuefactory, + int id) + { + super(type, referencedClass, mayBeNull); + + this.valuefactory = valuefactory; + this.id = id; + } + + + // Implementations for ReferenceValue. + + public int equal(ReferenceValue other) + { + return this.equals(other) ? ALWAYS : MAYBE; + } + + + // Implementations for Value. + + public boolean isSpecific() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.valuefactory.equals(((IdentifiedReferenceValue)object).valuefactory) && + this.id == ((IdentifiedReferenceValue)object).id; + } + + + public int hashCode() + { + return super.hashCode() ^ + valuefactory.hashCode() ^ + id; + } + + + public String toString() + { + return super.toString()+'#'+id; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/IdentifiedValueFactory.java b/src/proguard/evaluation/value/IdentifiedValueFactory.java new file mode 100644 index 0000000..2b14e72 --- /dev/null +++ b/src/proguard/evaluation/value/IdentifiedValueFactory.java @@ -0,0 +1,75 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.*; +import proguard.classfile.util.ClassUtil; + +/** + * This class provides methods to create and reuse IntegerValue objects. + * + * @author Eric Lafortune + */ +public class IdentifiedValueFactory +extends SpecificValueFactory +{ + private int integerID; + private int longID; + private int floatID; + private int doubleID; + private int referenceID; + + + // Implementations for ValueFactory. + + public IntegerValue createIntegerValue() + { + return new IdentifiedIntegerValue(this, integerID++); + } + + + public LongValue createLongValue() + { + return new IdentifiedLongValue(this, longID++); + } + + + public FloatValue createFloatValue() + { + return new IdentifiedFloatValue(this, floatID++); + } + + + public DoubleValue createDoubleValue() + { + return new IdentifiedDoubleValue(this, doubleID++); + } + + + public ReferenceValue createReferenceValue(String type, + Clazz referencedClass, + boolean mayBeNull) + { + return type == null ? + REFERENCE_VALUE_NULL : + new IdentifiedReferenceValue(type, referencedClass, mayBeNull, this, referenceID++); + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/InstructionOffsetValue.java b/src/proguard/evaluation/value/InstructionOffsetValue.java new file mode 100644 index 0000000..10b5a6f --- /dev/null +++ b/src/proguard/evaluation/value/InstructionOffsetValue.java @@ -0,0 +1,307 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.ClassConstants; + +/** + * This class represents a partially evaluated instruction offset. It can + * contain 0 or more specific instruction offsets. + * + * @author Eric Lafortune + */ +public class InstructionOffsetValue extends Category1Value +{ + public static final InstructionOffsetValue EMPTY_VALUE = new InstructionOffsetValue(); + + + private int[] values; + + + private InstructionOffsetValue() + { + } + + + public InstructionOffsetValue(int value) + { + this.values = new int[] { value }; + } + + + public InstructionOffsetValue(int[] values) + { + this.values = values; + } + + + public int instructionOffsetCount() + { + return values == null ? 0 : values.length; + } + + + public int instructionOffset(int index) + { + return values[index]; + } + + + /** + * Returns whether the given value is present in this list of instruction + * offsets. + */ + public boolean contains(int value) + { + if (values != null) + { + for (int index = 0; index < values.length; index++) + { + if (values[index] == value) + { + return true; + } + } + } + + return false; + } + + + /** + * Returns the minimum value from this list of instruction offsets. + * Returns Integer.MAX_VALUE if the list is empty. + */ + public int minimumValue() + { + int minimumValue = Integer.MAX_VALUE; + + if (values != null) + { + for (int index = 0; index < values.length; index++) + { + int value = values[index]; + + if (minimumValue > value) + { + minimumValue = value; + } + } + } + + return minimumValue; + } + + + /** + * Returns the maximum value from this list of instruction offsets. + * Returns Integer.MIN_VALUE if the list is empty. + */ + public int maximumValue() + { + int maximumValue = Integer.MIN_VALUE; + + if (values != null) + { + for (int index = 0; index < values.length; index++) + { + int value = values[index]; + + if (maximumValue < value) + { + maximumValue = value; + } + } + } + + return maximumValue; + } + + + /** + * Returns the generalization of this InstructionOffsetValue and the given + * other InstructionOffsetValue. The values of the other InstructionOffsetValue + * are guaranteed to remain at the end of the list, in the same order. + */ + public final Value generalize(InstructionOffsetValue other) + { + // If the values array of either is null, return the other one. + if (this.values == null) + { + return other; + } + + if (other.values == null) + { + return this; + } + + // Compute the length of the union of the arrays. + int newLength = this.values.length; + for (int index = 0; index < other.values.length; index++) + { + if (!this.contains(other.values[index])) + { + newLength++; + } + } + + // If the length of the union array is equal to the length of the values + // array of either, return it. + if (newLength == other.values.length) + { + return other; + } + + // The ordering of the this array may not be right, so we can't just + // use it. + //if (newLength == this.values.length) + //{ + // return this; + //} + + // Create the union array. + int[] newValues = new int[newLength]; + + int newIndex = 0; + + // Copy the values that are different from the other array. + for (int index = 0; index < this.values.length; index++) + { + if (!other.contains(this.values[index])) + { + newValues[newIndex++] = this.values[index]; + } + } + + // Copy the values from the other array. + for (int index = 0; index < other.values.length; index++) + { + newValues[newIndex++] = other.values[index]; + } + + return new InstructionOffsetValue(newValues); + } + + + // Implementations for Value. + + public final InstructionOffsetValue instructionOffsetValue() + { + return this; + } + + public boolean isSpecific() + { + return true; + } + + public boolean isParticular() + { + return true; + } + + public final Value generalize(Value other) + { + return this.generalize(other.instructionOffsetValue()); + } + + public final int computationalType() + { + return TYPE_INSTRUCTION_OFFSET; + } + + public final String internalType() + { + return String.valueOf(ClassConstants.INTERNAL_TYPE_INT); + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + InstructionOffsetValue other = (InstructionOffsetValue)object; + if (this.values == other.values) + { + return true; + } + + if (this.values == null || + other.values == null || + this.values.length != other.values.length) + { + return false; + } + + for (int index = 0; index < other.values.length; index++) + { + if (!this.contains(other.values[index])) + { + return false; + } + } + + return true; + } + + + public int hashCode() + { + int hashCode = this.getClass().hashCode(); + + if (values != null) + { + for (int index = 0; index < values.length; index++) + { + hashCode ^= values[index]; + } + } + + return hashCode; + } + + + public String toString() + { + StringBuffer buffer = new StringBuffer(); + + if (values != null) + { + for (int index = 0; index < values.length; index++) + { + if (index > 0) + { + buffer.append(','); + } + buffer.append(values[index]); + } + } + + return buffer.append(':').toString(); + } +} diff --git a/src/proguard/evaluation/value/IntegerValue.java b/src/proguard/evaluation/value/IntegerValue.java new file mode 100644 index 0000000..508c5f5 --- /dev/null +++ b/src/proguard/evaluation/value/IntegerValue.java @@ -0,0 +1,1002 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.ClassConstants; + +/** + * This class represents a partially evaluated integer value. + * + * @author Eric Lafortune + */ +public abstract class IntegerValue extends Category1Value +{ + /** + * Returns the specific integer value, if applicable. + */ + public int value() + { + return 0; + } + + + // Basic unary methods. + + /** + * Returns the negated value of this IntegerValue. + */ + public abstract IntegerValue negate(); + + /** + * Converts this IntegerValue to a byte IntegerValue. + */ + public abstract IntegerValue convertToByte(); + + /** + * Converts this IntegerValue to a character IntegerValue. + */ + public abstract IntegerValue convertToCharacter(); + + /** + * Converts this IntegerValue to a short IntegerValue. + */ + public abstract IntegerValue convertToShort(); + + /** + * Converts this IntegerValue to a LongValue. + */ + public abstract LongValue convertToLong(); + + /** + * Converts this IntegerValue to a FloatValue. + */ + public abstract FloatValue convertToFloat(); + + /** + * Converts this IntegerValue to a DoubleValue. + */ + public abstract DoubleValue convertToDouble(); + + + // Basic binary methods. + + /** + * Returns the generalization of this IntegerValue and the given other + * IntegerValue. + */ + public abstract IntegerValue generalize(IntegerValue other); + + /** + * Returns the sum of this IntegerValue and the given IntegerValue. + */ + public abstract IntegerValue add(IntegerValue other); + + /** + * Returns the difference of this IntegerValue and the given IntegerValue. + */ + public abstract IntegerValue subtract(IntegerValue other); + + /** + * Returns the difference of the given IntegerValue and this IntegerValue. + */ + public abstract IntegerValue subtractFrom(IntegerValue other); + + /** + * Returns the product of this IntegerValue and the given IntegerValue. + */ + public abstract IntegerValue multiply(IntegerValue other) + throws ArithmeticException; + + /** + * Returns the quotient of this IntegerValue and the given IntegerValue. + */ + public abstract IntegerValue divide(IntegerValue other) + throws ArithmeticException; + + /** + * Returns the quotient of the given IntegerValue and this IntegerValue. + */ + public abstract IntegerValue divideOf(IntegerValue other) + throws ArithmeticException; + + /** + * Returns the remainder of this IntegerValue divided by the given + * IntegerValue. + */ + public abstract IntegerValue remainder(IntegerValue other) + throws ArithmeticException; + + /** + * Returns the remainder of the given IntegerValue divided by this + * IntegerValue. + */ + public abstract IntegerValue remainderOf(IntegerValue other) + throws ArithmeticException; + + /** + * Returns this IntegerValue, shifted left by the given IntegerValue. + */ + public abstract IntegerValue shiftLeft(IntegerValue other); + + /** + * Returns this IntegerValue, shifted right by the given IntegerValue. + */ + public abstract IntegerValue shiftRight(IntegerValue other); + + /** + * Returns this unsigned IntegerValue, shifted left by the given + * IntegerValue. + */ + public abstract IntegerValue unsignedShiftRight(IntegerValue other); + + /** + * Returns the given IntegerValue, shifted left by this IntegerValue. + */ + public abstract IntegerValue shiftLeftOf(IntegerValue other); + + /** + * Returns the given IntegerValue, shifted right by this IntegerValue. + */ + public abstract IntegerValue shiftRightOf(IntegerValue other); + + /** + * Returns the given unsigned IntegerValue, shifted left by this + * IntegerValue. + */ + public abstract IntegerValue unsignedShiftRightOf(IntegerValue other); + + /** + * Returns the given LongValue, shifted left by this IntegerValue. + */ + public abstract LongValue shiftLeftOf(LongValue other); + + /** + * Returns the given LongValue, shifted right by this IntegerValue. + */ + public abstract LongValue shiftRightOf(LongValue other); + + /** + * Returns the given unsigned LongValue, shifted right by this IntegerValue. + */ + public abstract LongValue unsignedShiftRightOf(LongValue other); + + /** + * Returns the logical and of this IntegerValue and the given + * IntegerValue. + */ + public abstract IntegerValue and(IntegerValue other); + + /** + * Returns the logical or of this IntegerValue and the given + * IntegerValue. + */ + public abstract IntegerValue or(IntegerValue other); + + /** + * Returns the logical xor of this IntegerValue and the given + * IntegerValue. + */ + public abstract IntegerValue xor(IntegerValue other); + + /** + * Returns whether this IntegerValue and the given IntegerValue are equal: + * NEVER, MAYBE, or ALWAYS. + */ + public abstract int equal(IntegerValue other); + + /** + * Returns whether this IntegerValue is less than the given IntegerValue: + * NEVER, MAYBE, or ALWAYS. + */ + public abstract int lessThan(IntegerValue other); + + /** + * Returns whether this IntegerValue is less than or equal to the given + * IntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public abstract int lessThanOrEqual(IntegerValue other); + + + // Derived binary methods. + + /** + * Returns whether this IntegerValue and the given IntegerValue are different: + * NEVER, MAYBE, or ALWAYS. + */ + public final int notEqual(IntegerValue other) + { + return -equal(other); + } + + /** + * Returns whether this IntegerValue is greater than the given IntegerValue: + * NEVER, MAYBE, or ALWAYS. + */ + public final int greaterThan(IntegerValue other) + { + return -lessThanOrEqual(other); + } + + /** + * Returns whether this IntegerValue is greater than or equal to the given IntegerValue: + * NEVER, MAYBE, or ALWAYS. + */ + public final int greaterThanOrEqual(IntegerValue other) + { + return -lessThan(other); + } + + + // Similar binary methods, but this time with unknown arguments. + + /** + * Returns the generalization of this IntegerValue and the given other + * UnknownIntegerValue. + */ + public IntegerValue generalize(UnknownIntegerValue other) + { + return generalize((IntegerValue)other); + } + + + /** + * Returns the sum of this IntegerValue and the given UnknownIntegerValue. + */ + public IntegerValue add(UnknownIntegerValue other) + { + return add((IntegerValue)other); + } + + /** + * Returns the difference of this IntegerValue and the given UnknownIntegerValue. + */ + public IntegerValue subtract(UnknownIntegerValue other) + { + return subtract((IntegerValue)other); + } + + /** + * Returns the difference of the given UnknownIntegerValue and this IntegerValue. + */ + public IntegerValue subtractFrom(UnknownIntegerValue other) + { + return subtractFrom((IntegerValue)other); + } + + /** + * Returns the product of this IntegerValue and the given UnknownIntegerValue. + */ + public IntegerValue multiply(UnknownIntegerValue other) + { + return multiply((IntegerValue)other); + } + + /** + * Returns the quotient of this IntegerValue and the given + * UnknownIntegerValue. + */ + public IntegerValue divide(UnknownIntegerValue other) + { + return divide((IntegerValue)other); + } + + /** + * Returns the quotient of the given UnknownIntegerValue and this + * IntegerValue. + */ + public IntegerValue divideOf(UnknownIntegerValue other) + { + return divideOf((IntegerValue)other); + } + + /** + * Returns the remainder of this IntegerValue divided by the given + * UnknownIntegerValue. + */ + public IntegerValue remainder(UnknownIntegerValue other) + { + return remainder((IntegerValue)other); + } + + /** + * Returns the remainder of the given UnknownIntegerValue divided by this + * IntegerValue. + */ + public IntegerValue remainderOf(UnknownIntegerValue other) + { + return remainderOf((IntegerValue)other); + } + + /** + * Returns this IntegerValue, shifted left by the given UnknownIntegerValue. + */ + public IntegerValue shiftLeft(UnknownIntegerValue other) + { + return shiftLeft((IntegerValue)other); + } + + /** + * Returns this IntegerValue, shifted right by the given UnknownIntegerValue. + */ + public IntegerValue shiftRight(UnknownIntegerValue other) + { + return shiftRight((IntegerValue)other); + } + + /** + * Returns this unsigned IntegerValue, shifted right by the given + * UnknownIntegerValue. + */ + public IntegerValue unsignedShiftRight(UnknownIntegerValue other) + { + return unsignedShiftRight((IntegerValue)other); + } + + /** + * Returns the given UnknownIntegerValue, shifted left by this IntegerValue. + */ + public IntegerValue shiftLeftOf(UnknownIntegerValue other) + { + return shiftLeftOf((IntegerValue)other); + } + + /** + * Returns the given UnknownIntegerValue, shifted right by this IntegerValue. + */ + public IntegerValue shiftRightOf(UnknownIntegerValue other) + { + return shiftRightOf((IntegerValue)other); + } + + /** + * Returns the given unsigned UnknownIntegerValue, shifted right by this + * IntegerValue. + */ + public IntegerValue unsignedShiftRightOf(UnknownIntegerValue other) + { + return unsignedShiftRightOf((IntegerValue)other); + } + + /** + * Returns the given UnknownLongValue, shifted left by this IntegerValue. + */ + public LongValue shiftLeftOf(UnknownLongValue other) + { + return shiftLeftOf((LongValue)other); + } + + /** + * Returns the given UnknownLongValue, shifted right by this IntegerValue. + */ + public LongValue shiftRightOf(UnknownLongValue other) + { + return shiftRightOf((LongValue)other); + } + + /** + * Returns the given unsigned UnknownLongValue, shifted right by this + * IntegerValue. + */ + public LongValue unsignedShiftRightOf(UnknownLongValue other) + { + return unsignedShiftRightOf((LongValue)other); + } + + /** + * Returns the logical and of this IntegerValue and the given + * UnknownIntegerValue. + */ + public IntegerValue and(UnknownIntegerValue other) + { + return and((IntegerValue)other); + } + + /** + * Returns the logical or of this IntegerValue and the given + * UnknownIntegerValue. + */ + public IntegerValue or(UnknownIntegerValue other) + { + return or((IntegerValue)other); + } + + /** + * Returns the logical xor of this IntegerValue and the given + * UnknownIntegerValue. + */ + public IntegerValue xor(UnknownIntegerValue other) + { + return xor((IntegerValue)other); + } + + /** + * Returns whether this IntegerValue and the given UnknownIntegerValue are + * equal: NEVER, MAYBE, or ALWAYS. + */ + public int equal(UnknownIntegerValue other) + { + return equal((IntegerValue)other); + } + + /** + * Returns whether this IntegerValue is less than the given + * UnknownIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public int lessThan(UnknownIntegerValue other) + { + return lessThan((IntegerValue)other); + } + + /** + * Returns whether this IntegerValue is less than or equal to the given + * UnknownIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public int lessThanOrEqual(UnknownIntegerValue other) + { + return lessThanOrEqual((IntegerValue)other); + } + + + // Derived binary methods. + + /** + * Returns whether this IntegerValue and the given UnknownIntegerValue are + * different: NEVER, MAYBE, or ALWAYS. + */ + public final int notEqual(UnknownIntegerValue other) + { + return -equal(other); + } + + /** + * Returns whether this IntegerValue is greater than the given + * UnknownIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public final int greaterThan(UnknownIntegerValue other) + { + return -lessThanOrEqual(other); + } + + /** + * Returns whether this IntegerValue is greater than or equal to the given + * UnknownIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public final int greaterThanOrEqual(UnknownIntegerValue other) + { + return -lessThan(other); + } + + + // Similar binary methods, but this time with specific arguments. + + /** + * Returns the generalization of this IntegerValue and the given other + * SpecificIntegerValue. + */ + public IntegerValue generalize(SpecificIntegerValue other) + { + return generalize((IntegerValue)other); + } + + + /** + * Returns the sum of this IntegerValue and the given SpecificIntegerValue. + */ + public IntegerValue add(SpecificIntegerValue other) + { + return add((IntegerValue)other); + } + + /** + * Returns the difference of this IntegerValue and the given SpecificIntegerValue. + */ + public IntegerValue subtract(SpecificIntegerValue other) + { + return subtract((IntegerValue)other); + } + + /** + * Returns the difference of the given SpecificIntegerValue and this IntegerValue. + */ + public IntegerValue subtractFrom(SpecificIntegerValue other) + { + return subtractFrom((IntegerValue)other); + } + + /** + * Returns the product of this IntegerValue and the given SpecificIntegerValue. + */ + public IntegerValue multiply(SpecificIntegerValue other) + { + return multiply((IntegerValue)other); + } + + /** + * Returns the quotient of this IntegerValue and the given + * SpecificIntegerValue. + */ + public IntegerValue divide(SpecificIntegerValue other) + { + return divide((IntegerValue)other); + } + + /** + * Returns the quotient of the given SpecificIntegerValue and this + * IntegerValue. + */ + public IntegerValue divideOf(SpecificIntegerValue other) + { + return divideOf((IntegerValue)other); + } + + /** + * Returns the remainder of this IntegerValue divided by the given + * SpecificIntegerValue. + */ + public IntegerValue remainder(SpecificIntegerValue other) + { + return remainder((IntegerValue)other); + } + + /** + * Returns the remainder of the given SpecificIntegerValue divided by this + * IntegerValue. + */ + public IntegerValue remainderOf(SpecificIntegerValue other) + { + return remainderOf((IntegerValue)other); + } + + /** + * Returns this IntegerValue, shifted left by the given SpecificIntegerValue. + */ + public IntegerValue shiftLeft(SpecificIntegerValue other) + { + return shiftLeft((IntegerValue)other); + } + + /** + * Returns this IntegerValue, shifted right by the given SpecificIntegerValue. + */ + public IntegerValue shiftRight(SpecificIntegerValue other) + { + return shiftRight((IntegerValue)other); + } + + /** + * Returns this unsigned IntegerValue, shifted right by the given + * SpecificIntegerValue. + */ + public IntegerValue unsignedShiftRight(SpecificIntegerValue other) + { + return unsignedShiftRight((IntegerValue)other); + } + + /** + * Returns the given SpecificIntegerValue, shifted left by this IntegerValue. + */ + public IntegerValue shiftLeftOf(SpecificIntegerValue other) + { + return shiftLeftOf((IntegerValue)other); + } + + /** + * Returns the given SpecificIntegerValue, shifted right by this IntegerValue. + */ + public IntegerValue shiftRightOf(SpecificIntegerValue other) + { + return shiftRightOf((IntegerValue)other); + } + + /** + * Returns the given unsigned SpecificIntegerValue, shifted right by this + * IntegerValue. + */ + public IntegerValue unsignedShiftRightOf(SpecificIntegerValue other) + { + return unsignedShiftRightOf((IntegerValue)other); + } + + /** + * Returns the given SpecificLongValue, shifted left by this IntegerValue. + */ + public LongValue shiftLeftOf(SpecificLongValue other) + { + return shiftLeftOf((LongValue)other); + } + + /** + * Returns the given SpecificLongValue, shifted right by this IntegerValue. + */ + public LongValue shiftRightOf(SpecificLongValue other) + { + return shiftRightOf((LongValue)other); + } + + /** + * Returns the given unsigned SpecificLongValue, shifted right by this + * IntegerValue. + */ + public LongValue unsignedShiftRightOf(SpecificLongValue other) + { + return unsignedShiftRightOf((LongValue)other); + } + + /** + * Returns the logical and of this IntegerValue and the given + * SpecificIntegerValue. + */ + public IntegerValue and(SpecificIntegerValue other) + { + return and((IntegerValue)other); + } + + /** + * Returns the logical or of this IntegerValue and the given + * SpecificIntegerValue. + */ + public IntegerValue or(SpecificIntegerValue other) + { + return or((IntegerValue)other); + } + + /** + * Returns the logical xor of this IntegerValue and the given + * SpecificIntegerValue. + */ + public IntegerValue xor(SpecificIntegerValue other) + { + return xor((IntegerValue)other); + } + + /** + * Returns whether this IntegerValue and the given SpecificIntegerValue are + * equal: NEVER, MAYBE, or ALWAYS. + */ + public int equal(SpecificIntegerValue other) + { + return equal((IntegerValue)other); + } + + /** + * Returns whether this IntegerValue is less than the given + * SpecificIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public int lessThan(SpecificIntegerValue other) + { + return lessThan((IntegerValue)other); + } + + /** + * Returns whether this IntegerValue is less than or equal to the given + * SpecificIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public int lessThanOrEqual(SpecificIntegerValue other) + { + return lessThanOrEqual((IntegerValue)other); + } + + + // Derived binary methods. + + /** + * Returns whether this IntegerValue and the given SpecificIntegerValue are + * different: NEVER, MAYBE, or ALWAYS. + */ + public final int notEqual(SpecificIntegerValue other) + { + return -equal(other); + } + + /** + * Returns whether this IntegerValue is greater than the given + * SpecificIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public final int greaterThan(SpecificIntegerValue other) + { + return -lessThanOrEqual(other); + } + + /** + * Returns whether this IntegerValue is greater than or equal to the given + * SpecificIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public final int greaterThanOrEqual(SpecificIntegerValue other) + { + return -lessThan(other); + } + + + // Similar binary methods, but this time with particular arguments. + + /** + * Returns the generalization of this IntegerValue and the given other + * ParticularIntegerValue. + */ + public IntegerValue generalize(ParticularIntegerValue other) + { + return generalize((SpecificIntegerValue)other); + } + + + /** + * Returns the sum of this IntegerValue and the given ParticularIntegerValue. + */ + public IntegerValue add(ParticularIntegerValue other) + { + return add((SpecificIntegerValue)other); + } + + /** + * Returns the difference of this IntegerValue and the given ParticularIntegerValue. + */ + public IntegerValue subtract(ParticularIntegerValue other) + { + return subtract((SpecificIntegerValue)other); + } + + /** + * Returns the difference of the given ParticularIntegerValue and this IntegerValue. + */ + public IntegerValue subtractFrom(ParticularIntegerValue other) + { + return subtractFrom((SpecificIntegerValue)other); + } + + /** + * Returns the product of this IntegerValue and the given ParticularIntegerValue. + */ + public IntegerValue multiply(ParticularIntegerValue other) + { + return multiply((SpecificIntegerValue)other); + } + + /** + * Returns the quotient of this IntegerValue and the given + * ParticularIntegerValue. + */ + public IntegerValue divide(ParticularIntegerValue other) + { + return divide((SpecificIntegerValue)other); + } + + /** + * Returns the quotient of the given ParticularIntegerValue and this + * IntegerValue. + */ + public IntegerValue divideOf(ParticularIntegerValue other) + { + return divideOf((SpecificIntegerValue)other); + } + + /** + * Returns the remainder of this IntegerValue divided by the given + * ParticularIntegerValue. + */ + public IntegerValue remainder(ParticularIntegerValue other) + { + return remainder((SpecificIntegerValue)other); + } + + /** + * Returns the remainder of the given ParticularIntegerValue divided by this + * IntegerValue. + */ + public IntegerValue remainderOf(ParticularIntegerValue other) + { + return remainderOf((SpecificIntegerValue)other); + } + + /** + * Returns this IntegerValue, shifted left by the given ParticularIntegerValue. + */ + public IntegerValue shiftLeft(ParticularIntegerValue other) + { + return shiftLeft((SpecificIntegerValue)other); + } + + /** + * Returns this IntegerValue, shifted right by the given ParticularIntegerValue. + */ + public IntegerValue shiftRight(ParticularIntegerValue other) + { + return shiftRight((SpecificIntegerValue)other); + } + + /** + * Returns this unsigned IntegerValue, shifted right by the given + * ParticularIntegerValue. + */ + public IntegerValue unsignedShiftRight(ParticularIntegerValue other) + { + return unsignedShiftRight((SpecificIntegerValue)other); + } + + /** + * Returns the given ParticularIntegerValue, shifted left by this IntegerValue. + */ + public IntegerValue shiftLeftOf(ParticularIntegerValue other) + { + return shiftLeftOf((SpecificIntegerValue)other); + } + + /** + * Returns the given ParticularIntegerValue, shifted right by this IntegerValue. + */ + public IntegerValue shiftRightOf(ParticularIntegerValue other) + { + return shiftRightOf((SpecificIntegerValue)other); + } + + /** + * Returns the given unsigned ParticularIntegerValue, shifted right by this + * IntegerValue. + */ + public IntegerValue unsignedShiftRightOf(ParticularIntegerValue other) + { + return unsignedShiftRightOf((SpecificIntegerValue)other); + } + + /** + * Returns the given ParticularLongValue, shifted left by this IntegerValue. + */ + public LongValue shiftLeftOf(ParticularLongValue other) + { + return shiftLeftOf((SpecificLongValue)other); + } + + /** + * Returns the given ParticularLongValue, shifted right by this IntegerValue. + */ + public LongValue shiftRightOf(ParticularLongValue other) + { + return shiftRightOf((SpecificLongValue)other); + } + + /** + * Returns the given unsigned ParticularLongValue, shifted right by this + * IntegerValue. + */ + public LongValue unsignedShiftRightOf(ParticularLongValue other) + { + return unsignedShiftRightOf((SpecificLongValue)other); + } + + /** + * Returns the logical and of this IntegerValue and the given + * ParticularIntegerValue. + */ + public IntegerValue and(ParticularIntegerValue other) + { + return and((SpecificIntegerValue)other); + } + + /** + * Returns the logical or of this IntegerValue and the given + * ParticularIntegerValue. + */ + public IntegerValue or(ParticularIntegerValue other) + { + return or((SpecificIntegerValue)other); + } + + /** + * Returns the logical xor of this IntegerValue and the given + * ParticularIntegerValue. + */ + public IntegerValue xor(ParticularIntegerValue other) + { + return xor((SpecificIntegerValue)other); + } + + /** + * Returns whether this IntegerValue and the given ParticularIntegerValue are + * equal: NEVER, MAYBE, or ALWAYS. + */ + public int equal(ParticularIntegerValue other) + { + return equal((SpecificIntegerValue)other); + } + + /** + * Returns whether this IntegerValue is less than the given + * ParticularIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public int lessThan(ParticularIntegerValue other) + { + return lessThan((SpecificIntegerValue)other); + } + + /** + * Returns whether this IntegerValue is less than or equal to the given + * ParticularIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public int lessThanOrEqual(ParticularIntegerValue other) + { + return lessThanOrEqual((SpecificIntegerValue)other); + } + + + // Derived binary methods. + + /** + * Returns whether this IntegerValue and the given ParticularIntegerValue are + * different: NEVER, MAYBE, or ALWAYS. + */ + public final int notEqual(ParticularIntegerValue other) + { + return -equal(other); + } + + /** + * Returns whether this IntegerValue is greater than the given + * ParticularIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public final int greaterThan(ParticularIntegerValue other) + { + return -lessThanOrEqual(other); + } + + /** + * Returns whether this IntegerValue is greater than or equal to the given + * ParticularIntegerValue: NEVER, MAYBE, or + * ALWAYS. + */ + public final int greaterThanOrEqual(ParticularIntegerValue other) + { + return -lessThan(other); + } + + + // Implementations for Value. + + public final IntegerValue integerValue() + { + return this; + } + + public final Value generalize(Value other) + { + return this.generalize(other.integerValue()); + } + + public final int computationalType() + { + return TYPE_INTEGER; + } + + public final String internalType() + { + return String.valueOf(ClassConstants.INTERNAL_TYPE_INT); + } +} diff --git a/src/proguard/evaluation/value/LongValue.java b/src/proguard/evaluation/value/LongValue.java new file mode 100644 index 0000000..f7ba162 --- /dev/null +++ b/src/proguard/evaluation/value/LongValue.java @@ -0,0 +1,554 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.ClassConstants; + +/** + * This class represents a partially evaluated long value. + * + * @author Eric Lafortune + */ +public abstract class LongValue extends Category2Value +{ + /** + * Returns the specific long value, if applicable. + */ + public long value() + { + return 0; + } + + + // Basic unary methods. + + /** + * Returns the negated value of this LongValue. + */ + public abstract LongValue negate(); + + + /** + * Converts this LongValue to an IntegerValue. + */ + public abstract IntegerValue convertToInteger(); + + /** + * Converts this LongValue to a FloatValue. + */ + public abstract FloatValue convertToFloat(); + + /** + * Converts this LongValue to a DoubleValue. + */ + public abstract DoubleValue convertToDouble(); + + + // Basic binary methods. + + /** + * Returns the generalization of this LongValue and the given other + * LongValue. + */ + public LongValue generalize(LongValue other) + { + return other.generalize(this); + } + + /** + * Returns the sum of this LongValue and the given LongValue. + */ + public LongValue add(LongValue other) + { + return other.add(this); + } + + /** + * Returns the difference of this LongValue and the given LongValue. + */ + public LongValue subtract(LongValue other) + { + return other.subtractFrom(this); + } + + /** + * Returns the difference of the given LongValue and this LongValue. + */ + public LongValue subtractFrom(LongValue other) + { + return other.subtract(this); + } + + /** + * Returns the product of this LongValue and the given LongValue. + */ + public LongValue multiply(LongValue other) + throws ArithmeticException + { + return other.multiply(this); + } + + /** + * Returns the quotient of this LongValue and the given LongValue. + */ + public LongValue divide(LongValue other) + throws ArithmeticException + { + return other.divideOf(this); + } + + /** + * Returns the quotient of the given LongValue and this LongValue. + */ + public LongValue divideOf(LongValue other) + throws ArithmeticException + { + return other.divide(this); + } + + /** + * Returns the remainder of this LongValue divided by the given + * LongValue. + */ + public LongValue remainder(LongValue other) + throws ArithmeticException + { + return other.remainderOf(this); + } + + /** + * Returns the remainder of the given LongValue divided by this + * LongValue. + */ + public LongValue remainderOf(LongValue other) + throws ArithmeticException + { + return other.remainder(this); + } + + /** + * Returns this LongValue, shifted left by the given IntegerValue. + */ + public LongValue shiftLeft(IntegerValue other) + { + return other.shiftLeftOf(this); + } + + /** + * Returns this LongValue, shifted right by the given IntegerValue. + */ + public LongValue shiftRight(IntegerValue other) + { + return other.shiftRightOf(this); + } + + /** + * Returns this unsigned LongValue, shifted left by the given + * IntegerValue. + */ + public LongValue unsignedShiftRight(IntegerValue other) + { + return other.unsignedShiftRightOf(this); + } + + /** + * Returns the logical and of this LongValue and the given + * LongValue. + */ + public LongValue and(LongValue other) + { + return other.and(this); + } + + /** + * Returns the logical or of this LongValue and the given + * LongValue. + */ + public LongValue or(LongValue other) + { + return other.or(this); + } + + /** + * Returns the logical xor of this LongValue and the given + * LongValue. + */ + public LongValue xor(LongValue other) + { + return other.xor(this); + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this LongValue is + * less than, equal to, or greater than the given LongValue, respectively. + */ + public IntegerValue compare(LongValue other) + { + return other.compareReverse(this); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this LongValue is + * less than, equal to, or greater than the given LongValue, respectively. + */ + public final IntegerValue compareReverse(LongValue other) + { + return compare(other).negate(); + } + + + // Similar binary methods, but this time with more specific arguments. + + /** + * Returns the generalization of this LongValue and the given other + * SpecificLongValue. + */ + public LongValue generalize(SpecificLongValue other) + { + return this; + } + + + /** + * Returns the sum of this LongValue and the given SpecificLongValue. + */ + public LongValue add(SpecificLongValue other) + { + return this; + } + + /** + * Returns the difference of this LongValue and the given SpecificLongValue. + */ + public LongValue subtract(SpecificLongValue other) + { + return this; + } + + /** + * Returns the difference of the given SpecificLongValue and this LongValue. + */ + public LongValue subtractFrom(SpecificLongValue other) + { + return this; + } + + /** + * Returns the product of this LongValue and the given SpecificLongValue. + */ + public LongValue multiply(SpecificLongValue other) + { + return this; + } + + /** + * Returns the quotient of this LongValue and the given + * SpecificLongValue. + */ + public LongValue divide(SpecificLongValue other) + { + return this; + } + + /** + * Returns the quotient of the given SpecificLongValue and this + * LongValue. + */ + public LongValue divideOf(SpecificLongValue other) + { + return this; + } + + /** + * Returns the remainder of this LongValue divided by the given + * SpecificLongValue. + */ + public LongValue remainder(SpecificLongValue other) + { + return this; + } + + /** + * Returns the remainder of the given SpecificLongValue divided by this + * LongValue. + */ + public LongValue remainderOf(SpecificLongValue other) + { + return this; + } + + /** + * Returns this LongValue, shifted left by the given SpecificLongValue. + */ + public LongValue shiftLeft(SpecificLongValue other) + { + return this; + } + + /** + * Returns this LongValue, shifted right by the given SpecificLongValue. + */ + public LongValue shiftRight(SpecificLongValue other) + { + return this; + } + + /** + * Returns this unsigned LongValue, shifted right by the given + * SpecificLongValue. + */ + public LongValue unsignedShiftRight(SpecificLongValue other) + { + return this; + } + + /** + * Returns the logical and of this LongValue and the given + * SpecificLongValue. + */ + public LongValue and(SpecificLongValue other) + { + return this; + } + + /** + * Returns the logical or of this LongValue and the given + * SpecificLongValue. + */ + public LongValue or(SpecificLongValue other) + { + return this; + } + + /** + * Returns the logical xor of this LongValue and the given + * SpecificLongValue. + */ + public LongValue xor(SpecificLongValue other) + { + return this; + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this LongValue is + * less than, equal to, or greater than the given SpecificLongValue, + * respectively. + */ + public IntegerValue compare(SpecificLongValue other) + { + return new ComparisonValue(this, other); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this LongValue is + * less than, equal to, or greater than the given SpecificLongValue, + * respectively. + */ + public final IntegerValue compareReverse(SpecificLongValue other) + { + return compare(other).negate(); + } + + + // Similar binary methods, but this time with particular arguments. + + /** + * Returns the generalization of this LongValue and the given other + * ParticularLongValue. + */ + public LongValue generalize(ParticularLongValue other) + { + return generalize((SpecificLongValue)other); + } + + + /** + * Returns the sum of this LongValue and the given ParticularLongValue. + */ + public LongValue add(ParticularLongValue other) + { + return add((SpecificLongValue)other); + } + + /** + * Returns the difference of this LongValue and the given ParticularLongValue. + */ + public LongValue subtract(ParticularLongValue other) + { + return subtract((SpecificLongValue)other); + } + + /** + * Returns the difference of the given ParticularLongValue and this LongValue. + */ + public LongValue subtractFrom(ParticularLongValue other) + { + return subtractFrom((SpecificLongValue)other); + } + + /** + * Returns the product of this LongValue and the given ParticularLongValue. + */ + public LongValue multiply(ParticularLongValue other) + { + return multiply((SpecificLongValue)other); + } + + /** + * Returns the quotient of this LongValue and the given + * ParticularLongValue. + */ + public LongValue divide(ParticularLongValue other) + { + return divide((SpecificLongValue)other); + } + + /** + * Returns the quotient of the given ParticularLongValue and this + * LongValue. + */ + public LongValue divideOf(ParticularLongValue other) + { + return divideOf((SpecificLongValue)other); + } + + /** + * Returns the remainder of this LongValue divided by the given + * ParticularLongValue. + */ + public LongValue remainder(ParticularLongValue other) + { + return remainder((SpecificLongValue)other); + } + + /** + * Returns the remainder of the given ParticularLongValue divided by this + * LongValue. + */ + public LongValue remainderOf(ParticularLongValue other) + { + return remainderOf((SpecificLongValue)other); + } + + /** + * Returns this LongValue, shifted left by the given ParticularIntegerValue. + */ + public LongValue shiftLeft(ParticularIntegerValue other) + { + return shiftLeft((SpecificIntegerValue)other); + } + + /** + * Returns this LongValue, shifted right by the given ParticularIntegerValue. + */ + public LongValue shiftRight(ParticularIntegerValue other) + { + return shiftRight((SpecificIntegerValue)other); + } + + /** + * Returns this unsigned LongValue, shifted right by the given + * ParticularIntegerValue. + */ + public LongValue unsignedShiftRight(ParticularIntegerValue other) + { + return unsignedShiftRight((SpecificIntegerValue)other); + } + + /** + * Returns the logical and of this LongValue and the given + * ParticularLongValue. + */ + public LongValue and(ParticularLongValue other) + { + return and((SpecificLongValue)other); + } + + /** + * Returns the logical or of this LongValue and the given + * ParticularLongValue. + */ + public LongValue or(ParticularLongValue other) + { + return or((SpecificLongValue)other); + } + + /** + * Returns the logical xor of this LongValue and the given + * ParticularLongValue. + */ + public LongValue xor(ParticularLongValue other) + { + return xor((SpecificLongValue)other); + } + + /** + * Returns an IntegerValue with value -1, 0, or 1, if this LongValue is + * less than, equal to, or greater than the given ParticularLongValue, + * respectively. + */ + public IntegerValue compare(ParticularLongValue other) + { + return compare((SpecificLongValue)other); + } + + + // Derived binary methods. + + /** + * Returns an IntegerValue with value 1, 0, or -1, if this LongValue is + * less than, equal to, or greater than the given ParticularLongValue, + * respectively. + */ + public final IntegerValue compareReverse(ParticularLongValue other) + { + return compare(other).negate(); + } + + + // Implementations for Value. + + public final LongValue longValue() + { + return this; + } + + public final Value generalize(Value other) + { + return this.generalize(other.longValue()); + } + + public final int computationalType() + { + return TYPE_LONG; + } + + public final String internalType() + { + return String.valueOf(ClassConstants.INTERNAL_TYPE_INT); + } +} diff --git a/src/proguard/evaluation/value/NegatedDoubleValue.java b/src/proguard/evaluation/value/NegatedDoubleValue.java new file mode 100644 index 0000000..2bc9423 --- /dev/null +++ b/src/proguard/evaluation/value/NegatedDoubleValue.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This DoubleValue represents a double value that is negated. + * + * @author Eric Lafortune + */ +final class NegatedDoubleValue extends SpecificDoubleValue +{ + private final DoubleValue doubleValue; + + + /** + * Creates a new negated double value of the given double value. + */ + public NegatedDoubleValue(DoubleValue doubleValue) + { + this.doubleValue = doubleValue; + } + + + // Implementations of unary methods of DoubleValue. + + public DoubleValue negate() + { + return doubleValue; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.doubleValue.equals(((NegatedDoubleValue)object).doubleValue); + } + + + public int hashCode() + { + return super.hashCode() ^ + doubleValue.hashCode(); + } + + + public String toString() + { + return "-"+doubleValue; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/NegatedFloatValue.java b/src/proguard/evaluation/value/NegatedFloatValue.java new file mode 100644 index 0000000..0ddf4ab --- /dev/null +++ b/src/proguard/evaluation/value/NegatedFloatValue.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This FloatValue represents a float value that is negated. + * + * @author Eric Lafortune + */ +final class NegatedFloatValue extends SpecificFloatValue +{ + private final FloatValue floatValue; + + + /** + * Creates a new negated float value of the given float value. + */ + public NegatedFloatValue(FloatValue floatValue) + { + this.floatValue = floatValue; + } + + + // Implementations of unary methods of FloatValue. + + public FloatValue negate() + { + return floatValue; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.floatValue.equals(((NegatedFloatValue)object).floatValue); + } + + + public int hashCode() + { + return super.hashCode() ^ + floatValue.hashCode(); + } + + + public String toString() + { + return "-"+floatValue; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/NegatedIntegerValue.java b/src/proguard/evaluation/value/NegatedIntegerValue.java new file mode 100644 index 0000000..a89a2d9 --- /dev/null +++ b/src/proguard/evaluation/value/NegatedIntegerValue.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a integer value that is negated. + * + * @author Eric Lafortune + */ +final class NegatedIntegerValue extends SpecificIntegerValue +{ + private final IntegerValue integerValue; + + + /** + * Creates a new negated integer value of the given integer value. + */ + public NegatedIntegerValue(IntegerValue integerValue) + { + this.integerValue = integerValue; + } + + + // Implementations of unary methods of IntegerValue. + + public IntegerValue negate() + { + return integerValue; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.integerValue.equals(((NegatedIntegerValue)object).integerValue); + } + + + public int hashCode() + { + return super.hashCode() ^ + integerValue.hashCode(); + } + + + public String toString() + { + return "-"+integerValue; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/NegatedLongValue.java b/src/proguard/evaluation/value/NegatedLongValue.java new file mode 100644 index 0000000..c3b22bb --- /dev/null +++ b/src/proguard/evaluation/value/NegatedLongValue.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This LongValue represents a long value that is negated. + * + * @author Eric Lafortune + */ +final class NegatedLongValue extends SpecificLongValue +{ + private final LongValue longValue; + + + /** + * Creates a new negated long value of the given long value. + */ + public NegatedLongValue(LongValue longValue) + { + this.longValue = longValue; + } + + + // Implementations of unary methods of LongValue. + + public LongValue negate() + { + return longValue; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return this == object || + super.equals(object) && + this.longValue.equals(((NegatedLongValue)object).longValue); + } + + + public int hashCode() + { + return super.hashCode() ^ + longValue.hashCode(); + } + + + public String toString() + { + return "-"+longValue; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ParticularDoubleValue.java b/src/proguard/evaluation/value/ParticularDoubleValue.java new file mode 100644 index 0000000..05bc559 --- /dev/null +++ b/src/proguard/evaluation/value/ParticularDoubleValue.java @@ -0,0 +1,210 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This DoubleValue represents a particular double value. + * + * @author Eric Lafortune + */ +final class ParticularDoubleValue extends SpecificDoubleValue +{ + private final double value; + + + /** + * Creates a new particular double value. + */ + public ParticularDoubleValue(double value) + { + this.value = value; + } + + + // Implementations for DoubleValue. + + public double value() + { + return value; + } + + + // Implementations of unary methods of DoubleValue. + + public DoubleValue negate() + { + return new ParticularDoubleValue(-value); + } + + public IntegerValue convertToInteger() + { + return new ParticularIntegerValue((int)value); + } + + public LongValue convertToLong() + { + return new ParticularLongValue((long)value); + } + + public FloatValue convertToFloat() + { + return new ParticularFloatValue((float)value); + } + + + // Implementations of binary methods of DoubleValue. + + public DoubleValue generalize(DoubleValue other) + { + return other.generalize(this); + } + + public DoubleValue add(DoubleValue other) + { + return value == 0.0 ? other : other.add(this); + } + + public DoubleValue subtract(DoubleValue other) + { + return value == 0.0 ? other.negate() : other.subtractFrom(this); + } + + public DoubleValue subtractFrom(DoubleValue other) + { + return value == 0.0 ? other : other.subtract(this); + } + + public DoubleValue multiply(DoubleValue other) + { + return other.multiply(this); + } + + public DoubleValue divide(DoubleValue other) + { + return other.divideOf(this); + } + + public DoubleValue divideOf(DoubleValue other) + { + return other.divide(this); + } + + public DoubleValue remainder(DoubleValue other) + { + return other.remainderOf(this); + } + + public DoubleValue remainderOf(DoubleValue other) + { + return other.remainder(this); + } + + public IntegerValue compare(DoubleValue other) + { + return other.compareReverse(this); + } + + + // Implementations of binary DoubleValue methods with ParticularDoubleValue + // arguments. + + public DoubleValue generalize(ParticularDoubleValue other) + { + return this.value == other.value ? this : ValueFactory.DOUBLE_VALUE; + } + + public DoubleValue add(ParticularDoubleValue other) + { + return new ParticularDoubleValue(this.value + other.value); + } + + public DoubleValue subtract(ParticularDoubleValue other) + { + return new ParticularDoubleValue(this.value - other.value); + } + + public DoubleValue subtractFrom(ParticularDoubleValue other) + { + return new ParticularDoubleValue(other.value - this.value); + } + + public DoubleValue multiply(ParticularDoubleValue other) + { + return new ParticularDoubleValue(this.value * other.value); + } + + public DoubleValue divide(ParticularDoubleValue other) + { + return new ParticularDoubleValue(this.value / other.value); + } + + public DoubleValue divideOf(ParticularDoubleValue other) + { + return new ParticularDoubleValue(other.value / this.value); + } + + public DoubleValue remainder(ParticularDoubleValue other) + { + return new ParticularDoubleValue(this.value % other.value); + } + + public DoubleValue remainderOf(ParticularDoubleValue other) + { + return new ParticularDoubleValue(other.value % this.value); + } + + public IntegerValue compare(ParticularDoubleValue other) + { + return this.value < other.value ? SpecificValueFactory.INTEGER_VALUE_M1 : + this.value == other.value ? SpecificValueFactory.INTEGER_VALUE_0 : + SpecificValueFactory.INTEGER_VALUE_1; + } + + + // Implementations for Value. + + public boolean isParticular() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return super.equals(object) && + this.value == ((ParticularDoubleValue)object).value; + } + + + public int hashCode() + { + return super.hashCode() ^ + (int)Double.doubleToLongBits(value); + } + + + public String toString() + { + return value+"d"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ParticularFloatValue.java b/src/proguard/evaluation/value/ParticularFloatValue.java new file mode 100644 index 0000000..59e4357 --- /dev/null +++ b/src/proguard/evaluation/value/ParticularFloatValue.java @@ -0,0 +1,210 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This FloatValue represents a particular float value. + * + * @author Eric Lafortune + */ +final class ParticularFloatValue extends SpecificFloatValue +{ + private final float value; + + + /** + * Creates a new particular float value. + */ + public ParticularFloatValue(float value) + { + this.value = value; + } + + + // Implementations for FloatValue. + + public float value() + { + return value; + } + + + // Implementations of unary methods of FloatValue. + + public FloatValue negate() + { + return new ParticularFloatValue(-value); + } + + public IntegerValue convertToInteger() + { + return new ParticularIntegerValue((int)value); + } + + public LongValue convertToLong() + { + return new ParticularLongValue((long)value); + } + + public DoubleValue convertToDouble() + { + return new ParticularDoubleValue((float)value); + } + + + // Implementations of binary methods of FloatValue. + + public FloatValue generalize(FloatValue other) + { + return other.generalize(this); + } + + public FloatValue add(FloatValue other) + { + return value == 0.0 ? other : other.add(this); + } + + public FloatValue subtract(FloatValue other) + { + return value == 0.0 ? other.negate() : other.subtractFrom(this); + } + + public FloatValue subtractFrom(FloatValue other) + { + return value == 0.0 ? other : other.subtract(this); + } + + public FloatValue multiply(FloatValue other) + { + return other.multiply(this); + } + + public FloatValue divide(FloatValue other) + { + return other.divideOf(this); + } + + public FloatValue divideOf(FloatValue other) + { + return other.divide(this); + } + + public FloatValue remainder(FloatValue other) + { + return other.remainderOf(this); + } + + public FloatValue remainderOf(FloatValue other) + { + return other.remainder(this); + } + + public IntegerValue compare(FloatValue other) + { + return other.compareReverse(this); + } + + + // Implementations of binary FloatValue methods with ParticularFloatValue + // arguments. + + public FloatValue generalize(ParticularFloatValue other) + { + return this.value == other.value ? this : ValueFactory.FLOAT_VALUE; + } + + public FloatValue add(ParticularFloatValue other) + { + return new ParticularFloatValue(this.value + other.value); + } + + public FloatValue subtract(ParticularFloatValue other) + { + return new ParticularFloatValue(this.value - other.value); + } + + public FloatValue subtractFrom(ParticularFloatValue other) + { + return new ParticularFloatValue(other.value - this.value); + } + + public FloatValue multiply(ParticularFloatValue other) + { + return new ParticularFloatValue(this.value * other.value); + } + + public FloatValue divide(ParticularFloatValue other) + { + return new ParticularFloatValue(this.value / other.value); + } + + public FloatValue divideOf(ParticularFloatValue other) + { + return new ParticularFloatValue(other.value / this.value); + } + + public FloatValue remainder(ParticularFloatValue other) + { + return new ParticularFloatValue(this.value % other.value); + } + + public FloatValue remainderOf(ParticularFloatValue other) + { + return new ParticularFloatValue(other.value % this.value); + } + + public IntegerValue compare(ParticularFloatValue other) + { + return this.value < other.value ? SpecificValueFactory.INTEGER_VALUE_M1 : + this.value == other.value ? SpecificValueFactory.INTEGER_VALUE_0 : + SpecificValueFactory.INTEGER_VALUE_1; + } + + + // Implementations for Value. + + public boolean isParticular() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return super.equals(object) && + this.value == ((ParticularFloatValue)object).value; + } + + + public int hashCode() + { + return super.hashCode() ^ + Float.floatToIntBits(value); + } + + + public String toString() + { + return value+"f"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ParticularIntegerValue.java b/src/proguard/evaluation/value/ParticularIntegerValue.java new file mode 100644 index 0000000..8a4ac1d --- /dev/null +++ b/src/proguard/evaluation/value/ParticularIntegerValue.java @@ -0,0 +1,383 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a particular integer value. + * + * @author Eric Lafortune + */ +final class ParticularIntegerValue extends SpecificIntegerValue +{ + private final int value; + + + /** + * Creates a new particular integer value. + */ + public ParticularIntegerValue(int value) + { + this.value = value; + } + + + // Implementations for IntegerValue. + + public int value() + { + return value; + } + + + // Implementations of unary methods of IntegerValue. + + public IntegerValue negate() + { + return new ParticularIntegerValue(-value); + } + + public IntegerValue convertToByte() + { + int byteValue = (byte)value; + + return byteValue == value ? + this : + new ParticularIntegerValue(byteValue); + } + + public IntegerValue convertToCharacter() + { + int charValue = (char)value; + + return charValue == value ? + this : + new ParticularIntegerValue(charValue); + } + + public IntegerValue convertToShort() + { + int shortValue = (short)value; + + return shortValue == value ? + this : + new ParticularIntegerValue(shortValue); + } + + public LongValue convertToLong() + { + return new ParticularLongValue((long)value); + } + + public FloatValue convertToFloat() + { + return new ParticularFloatValue((float)value); + } + + public DoubleValue convertToDouble() + { + return new ParticularDoubleValue((double)value); + } + + + // Implementations of binary methods of IntegerValue. + + public IntegerValue generalize(IntegerValue other) + { + return other.generalize(this); + } + + public IntegerValue add(IntegerValue other) + { + return other.add(this); + } + + public IntegerValue subtract(IntegerValue other) + { + return other.subtractFrom(this); + } + + public IntegerValue subtractFrom(IntegerValue other) + { + return other.subtract(this); + } + + public IntegerValue multiply(IntegerValue other) + { + return other.multiply(this); + } + + public IntegerValue divide(IntegerValue other) + throws ArithmeticException + { + return other.divideOf(this); + } + + public IntegerValue divideOf(IntegerValue other) + throws ArithmeticException + { + return other.divide(this); + } + + public IntegerValue remainder(IntegerValue other) + throws ArithmeticException + { + return other.remainderOf(this); + } + + public IntegerValue remainderOf(IntegerValue other) + throws ArithmeticException + { + return other.remainder(this); + } + + public IntegerValue shiftLeft(IntegerValue other) + { + return other.shiftLeftOf(this); + } + + public IntegerValue shiftLeftOf(IntegerValue other) + { + return other.shiftLeft(this); + } + + public IntegerValue shiftRight(IntegerValue other) + { + return other.shiftRightOf(this); + } + + public IntegerValue shiftRightOf(IntegerValue other) + { + return other.shiftRight(this); + } + + public IntegerValue unsignedShiftRight(IntegerValue other) + { + return other.unsignedShiftRightOf(this); + } + + public IntegerValue unsignedShiftRightOf(IntegerValue other) + { + return other.unsignedShiftRight(this); + } + + public LongValue shiftLeftOf(LongValue other) + { + return other.shiftLeft(this); + } + + public LongValue shiftRightOf(LongValue other) + { + return other.shiftRight(this); + } + + public LongValue unsignedShiftRightOf(LongValue other) + { + return other.unsignedShiftRight(this); + } + + public IntegerValue and(IntegerValue other) + { + return other.and(this); + } + + public IntegerValue or(IntegerValue other) + { + return other.or(this); + } + + public IntegerValue xor(IntegerValue other) + { + return other.xor(this); + } + + public int equal(IntegerValue other) + { + return other.equal(this); + } + + public int lessThan(IntegerValue other) + { + return other.greaterThan(this); + } + + public int lessThanOrEqual(IntegerValue other) + { + return other.greaterThanOrEqual(this); + } + + + // Implementations of binary IntegerValue methods with ParticularIntegerValue + // arguments. + + public IntegerValue generalize(ParticularIntegerValue other) + { + return generalize((SpecificIntegerValue)other); + } + + public IntegerValue add(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value + other.value); + } + + public IntegerValue subtract(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value - other.value); + } + + public IntegerValue subtractFrom(ParticularIntegerValue other) + { + return new ParticularIntegerValue(other.value - this.value); + } + + public IntegerValue multiply(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value * other.value); + } + + public IntegerValue divide(ParticularIntegerValue other) + throws ArithmeticException + { + return new ParticularIntegerValue(this.value / other.value); + } + + public IntegerValue divideOf(ParticularIntegerValue other) + throws ArithmeticException + { + return new ParticularIntegerValue(other.value / this.value); + } + + public IntegerValue remainder(ParticularIntegerValue other) + throws ArithmeticException + { + return new ParticularIntegerValue(this.value % other.value); + } + + public IntegerValue remainderOf(ParticularIntegerValue other) + throws ArithmeticException + { + return new ParticularIntegerValue(other.value % this.value); + } + + public IntegerValue shiftLeft(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value << other.value); + } + + public IntegerValue shiftRight(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value >> other.value); + } + + public IntegerValue unsignedShiftRight(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value >>> other.value); + } + + public IntegerValue shiftLeftOf(ParticularIntegerValue other) + { + return new ParticularIntegerValue(other.value << this.value); + } + + public IntegerValue shiftRightOf(ParticularIntegerValue other) + { + return new ParticularIntegerValue(other.value >> this.value); + } + + public IntegerValue unsignedShiftRightOf(ParticularIntegerValue other) + { + return new ParticularIntegerValue(other.value >>> this.value); + } + + public LongValue shiftLeftOf(ParticularLongValue other) + { + return new ParticularLongValue(other.value() << this.value); + } + + public LongValue shiftRightOf(ParticularLongValue other) + { + return new ParticularLongValue(other.value() >> this.value); + } + + public LongValue unsignedShiftRightOf(ParticularLongValue other) + { + return new ParticularLongValue(other.value() >>> this.value); + } + + public IntegerValue and(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value & other.value); + } + + public IntegerValue or(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value | other.value); + } + + public IntegerValue xor(ParticularIntegerValue other) + { + return new ParticularIntegerValue(this.value ^ other.value); + } + + public int equal(ParticularIntegerValue other) + { + return this.value == other.value ? ALWAYS : NEVER; + } + + public int lessThan(ParticularIntegerValue other) + { + return this.value < other.value ? ALWAYS : NEVER; + } + + public int lessThanOrEqual(ParticularIntegerValue other) + { + return this.value <= other.value ? ALWAYS : NEVER; + } + + + // Implementations for Value. + + public boolean isParticular() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return super.equals(object) && + this.value == ((ParticularIntegerValue)object).value; + } + + + public int hashCode() + { + return this.getClass().hashCode() ^ + value; + } + + + public String toString() + { + return Integer.toString(value); + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ParticularLongValue.java b/src/proguard/evaluation/value/ParticularLongValue.java new file mode 100644 index 0000000..61d2e04 --- /dev/null +++ b/src/proguard/evaluation/value/ParticularLongValue.java @@ -0,0 +1,271 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This LongValue represents a particular long value. + * + * @author Eric Lafortune + */ +final class ParticularLongValue extends SpecificLongValue +{ + private final long value; + + + /** + * Creates a new particular long value. + */ + public ParticularLongValue(long value) + { + this.value = value; + } + + + // Implementations for LongValue. + + public long value() + { + return value; + } + + + // Implementations of unary methods of LongValue. + + public LongValue negate() + { + return new ParticularLongValue(-value); + } + + public IntegerValue convertToInteger() + { + return new ParticularIntegerValue((int)value); + } + + public FloatValue convertToFloat() + { + return new ParticularFloatValue((float)value); + } + + public DoubleValue convertToDouble() + { + return new ParticularDoubleValue((double)value); + } + + + // Implementations of binary methods of LongValue. + + public LongValue generalize(LongValue other) + { + return other.generalize(this); + } + + public LongValue add(LongValue other) + { + return other.add(this); + } + + public LongValue subtract(LongValue other) + { + return other.subtractFrom(this); + } + + public LongValue subtractFrom(LongValue other) + { + return other.subtract(this); + } + + public LongValue multiply(LongValue other) + { + return other.multiply(this); + } + + public LongValue divide(LongValue other) + throws ArithmeticException + { + return other.divideOf(this); + } + + public LongValue divideOf(LongValue other) + throws ArithmeticException + { + return other.divide(this); + } + + public LongValue remainder(LongValue other) + throws ArithmeticException + { + return other.remainderOf(this); + } + + public LongValue remainderOf(LongValue other) + throws ArithmeticException + { + return other.remainder(this); + } + + public LongValue shiftLeft(IntegerValue other) + { + return other.shiftLeftOf(this); + } + + public LongValue shiftRight(IntegerValue other) + { + return other.shiftRightOf(this); + } + + public LongValue unsignedShiftRight(IntegerValue other) + { + return other.unsignedShiftRightOf(this); + } + + public LongValue and(LongValue other) + { + return other.and(this); + } + + public LongValue or(LongValue other) + { + return other.or(this); + } + + public LongValue xor(LongValue other) + { + return other.xor(this); + } + + public IntegerValue compare(LongValue other) + { + return other.compareReverse(this); + } + + + // Implementations of binary LongValue methods with ParticularLongValue + // arguments. + + public LongValue generalize(ParticularLongValue other) + { + return generalize((SpecificLongValue)other); + } + + public LongValue add(ParticularLongValue other) + { + return new ParticularLongValue(this.value + other.value); + } + + public LongValue subtract(ParticularLongValue other) + { + return new ParticularLongValue(this.value - other.value); + } + + public LongValue subtractFrom(ParticularLongValue other) + { + return new ParticularLongValue(other.value - this.value); + } + + public LongValue multiply(ParticularLongValue other) + { + return new ParticularLongValue(this.value * other.value); + } + + public LongValue divide(ParticularLongValue other) + throws ArithmeticException + { + return new ParticularLongValue(this.value / other.value); + } + + public LongValue divideOf(ParticularLongValue other) + throws ArithmeticException + { + return new ParticularLongValue(other.value / this.value); + } + + public LongValue remainder(ParticularLongValue other) + throws ArithmeticException + { + return new ParticularLongValue(this.value % other.value); + } + + public LongValue remainderOf(ParticularLongValue other) + throws ArithmeticException + { + return new ParticularLongValue(other.value % this.value); + } + + public LongValue shiftLeft(ParticularIntegerValue other) + { + return new ParticularLongValue(this.value << other.value()); + } + + public LongValue shiftRight(ParticularIntegerValue other) + { + return new ParticularLongValue(this.value >> other.value()); + } + + public LongValue unsignedShiftRight(ParticularIntegerValue other) + { + return new ParticularLongValue(this.value >>> other.value()); + } + + public LongValue and(ParticularLongValue other) + { + return new ParticularLongValue(this.value & other.value); + } + + public LongValue or(ParticularLongValue other) + { + return new ParticularLongValue(this.value | other.value); + } + + public LongValue xor(ParticularLongValue other) + { + return new ParticularLongValue(this.value ^ other.value); + } + + + // Implementations for Value. + + public boolean isParticular() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return super.equals(object) && + this.value == ((ParticularLongValue)object).value; + } + + + public int hashCode() + { + return this.getClass().hashCode() ^ + (int)value; + } + + + public String toString() + { + return value+"L"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/ReferenceValue.java b/src/proguard/evaluation/value/ReferenceValue.java new file mode 100644 index 0000000..418c6f8 --- /dev/null +++ b/src/proguard/evaluation/value/ReferenceValue.java @@ -0,0 +1,526 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.*; +import proguard.classfile.util.ClassUtil; +import proguard.classfile.visitor.ClassCollector; + +import java.util.*; + +/** + * This class represents a partially evaluated reference value. It has a type + * and a flag that indicates whether the value could be null. If + * the type is null, the value is null. + * + * @author Eric Lafortune + */ +public class ReferenceValue extends Category1Value +{ + private static final boolean DEBUG = false; + + + protected final String type; + protected final Clazz referencedClass; + protected final boolean mayBeNull; + + + /** + * Creates a new ReferenceValue. + */ + public ReferenceValue(String type, + Clazz referencedClass, + boolean mayBeNull) + { + this.type = type; + this.referencedClass = referencedClass; + this.mayBeNull = mayBeNull; + } + + + /** + * Returns the type. + */ + public String getType() + { + return type; + } + + + /** + * Returns the class that is referenced by the type. + */ + public Clazz getReferencedClass() + { + return referencedClass; + } + + + // Basic unary methods. + + /** + * Returns whether the type is null. + */ + public int isNull() + { + return type == null ? ALWAYS : + mayBeNull ? MAYBE : + NEVER; + } + + + /** + * Returns whether the type is an instance of the given type. + */ + public int instanceOf(String otherType, Clazz otherReferencedClass) + { + String thisType = this.type; + + // If this type is null, it is never an instance of any class. + if (thisType == null) + { + return NEVER; + } + + // Start taking into account the type dimensions. + int thisDimensionCount = ClassUtil.internalArrayTypeDimensionCount(thisType); + int otherDimensionCount = ClassUtil.internalArrayTypeDimensionCount(otherType); + int commonDimensionCount = Math.min(thisDimensionCount, otherDimensionCount); + + // Strip any common array prefixes. + thisType = thisType.substring(commonDimensionCount); + otherType = otherType.substring(commonDimensionCount); + + // If either stripped type is a primitive type, we can tell right away. + if (commonDimensionCount > 0 && + (ClassUtil.isInternalPrimitiveType(thisType.charAt(0)) || + ClassUtil.isInternalPrimitiveType(otherType.charAt(0)))) + { + return !thisType.equals(otherType) ? NEVER : + mayBeNull ? MAYBE : + ALWAYS; + } + + // Strip the class type prefix and suffix of this type, if any. + if (thisDimensionCount == commonDimensionCount) + { + thisType = ClassUtil.internalClassNameFromClassType(thisType); + } + + // Strip the class type prefix and suffix of the other type, if any. + if (otherDimensionCount == commonDimensionCount) + { + otherType = ClassUtil.internalClassNameFromClassType(otherType); + } + + // If this type is an array type, and the other type is not + // java.lang.Object, java.lang.Cloneable, or java.io.Serializable, + // this type can never be an instance. + if (thisDimensionCount > otherDimensionCount && + !ClassUtil.isInternalArrayInterfaceName(otherType)) + { + return NEVER; + } + + // If the other type is an array type, and this type is not + // java.lang.Object, java.lang.Cloneable, or java.io.Serializable, + // this type can never be an instance. + if (thisDimensionCount < otherDimensionCount && + !ClassUtil.isInternalArrayInterfaceName(thisType)) + { + return NEVER; + } + + // If this type may be null, it might not be an instance of any class. + if (mayBeNull) + { + return MAYBE; + } + + // If this type is equal to the other type, or if the other type is + // java.lang.Object, this type is always an instance. + if (thisType.equals(otherType) || + ClassConstants.INTERNAL_NAME_JAVA_LANG_OBJECT.equals(otherType)) + { + return ALWAYS; + } + + // If this type is an array type, it's ok. + if (thisDimensionCount > otherDimensionCount) + { + return ALWAYS; + } + + // If the other type is an array type, it might be ok. + if (thisDimensionCount < otherDimensionCount) + { + return MAYBE; + } + + // If the value extends the type, we're sure. + return referencedClass != null && + otherReferencedClass != null && + referencedClass.extendsOrImplements(otherReferencedClass) ? + ALWAYS : + MAYBE; + } + + + /** + * Returns the length of the array, assuming this type is an array. + */ + public IntegerValue arrayLength(ValueFactory valueFactory) + { + return valueFactory.createIntegerValue(); + } + + + /** + * Returns the value of the array at the given index, assuming this type + * is an array. + */ + public Value arrayLoad(IntegerValue integerValue, ValueFactory valueFactory) + { + return + type == null ? ValueFactory.REFERENCE_VALUE_NULL : + !ClassUtil.isInternalArrayType(type) ? ValueFactory.REFERENCE_VALUE_JAVA_LANG_OBJECT_MAYBE_NULL : + valueFactory.createValue(type.substring(1), + referencedClass, + true); + } + + + // Basic binary methods. + + /** + * Returns the generalization of this ReferenceValue and the given other + * ReferenceValue. + */ + public ReferenceValue generalize(ReferenceValue other) + { + // If both types are identical, the generalization is the same too. + if (this.equals(other)) + { + return this; + } + + String thisType = this.type; + String otherType = other.type; + + // If both types are nul, the generalization is null too. + if (thisType == null && otherType == null) + { + return ValueFactory.REFERENCE_VALUE_NULL; + } + + // If this type is null, the generalization is the other type, maybe null. + if (thisType == null) + { + return other.generalizeMayBeNull(true); + } + + // If the other type is null, the generalization is this type, maybe null. + if (otherType == null) + { + return this.generalizeMayBeNull(true); + } + + boolean mayBeNull = this.mayBeNull || other.mayBeNull; + + // If the two types are equal, the generalization remains the same, maybe null. + if (thisType.equals(otherType)) + { + return this.generalizeMayBeNull(mayBeNull); + } + + // Start taking into account the type dimensions. + int thisDimensionCount = ClassUtil.internalArrayTypeDimensionCount(thisType); + int otherDimensionCount = ClassUtil.internalArrayTypeDimensionCount(otherType); + int commonDimensionCount = Math.min(thisDimensionCount, otherDimensionCount); + + if (thisDimensionCount == otherDimensionCount) + { + // See if we can take into account the referenced classes. + Clazz thisReferencedClass = this.referencedClass; + Clazz otherReferencedClass = other.referencedClass; + + if (thisReferencedClass != null && + otherReferencedClass != null) + { + if (thisReferencedClass.extendsOrImplements(otherReferencedClass)) + { + return other.generalizeMayBeNull(mayBeNull); + } + + if (otherReferencedClass.extendsOrImplements(thisReferencedClass)) + { + return this.generalizeMayBeNull(mayBeNull); + } + + // Collect the superclasses and interfaces of this class. + Set thisSuperClasses = new HashSet(); + thisReferencedClass.hierarchyAccept(false, true, true, false, + new ClassCollector(thisSuperClasses)); + + // Collect the superclasses and interfaces of the other class. + Set otherSuperClasses = new HashSet(); + otherReferencedClass.hierarchyAccept(false, true, true, false, + new ClassCollector(otherSuperClasses)); + + if (DEBUG) + { + System.out.println("ReferenceValue.generalize this ["+thisReferencedClass.getName()+"] with other ["+otherReferencedClass.getName()+"]"); + System.out.println(" This super classes: "+thisSuperClasses); + System.out.println(" Other super classes: "+otherSuperClasses); + } + + // Find the common superclasses. + thisSuperClasses.retainAll(otherSuperClasses); + + if (DEBUG) + { + System.out.println(" Common super classes: "+thisSuperClasses); + } + + // Find a class that is a subclass of all common superclasses, + // or that at least has the maximum number of common superclasses. + Clazz commonClazz = null; + + int maximumSuperClassCount = -1; + + // Go over all common superclasses to find it. In case of + // multiple subclasses, keep the lowest one alphabetically, + // in order to ensure that the choice is deterministic. + Iterator commonSuperClasses = thisSuperClasses.iterator(); + while (commonSuperClasses.hasNext()) + { + Clazz commonSuperClass = (Clazz)commonSuperClasses.next(); + + int superClassCount = superClassCount(commonSuperClass, thisSuperClasses); + if (maximumSuperClassCount < superClassCount || + (maximumSuperClassCount == superClassCount && + commonClazz != null && + commonClazz.getName().compareTo(commonSuperClass.getName()) > 0)) + { + commonClazz = commonSuperClass; + maximumSuperClassCount = superClassCount; + } + } + + if (commonClazz == null) + { + throw new IllegalArgumentException("Can't find common super class of ["+thisType+"] and ["+otherType+"]"); + } + + if (DEBUG) + { + System.out.println(" Best common class: ["+commonClazz.getName()+"]"); + } + + // TODO: Handle more difficult cases, with multiple global subclasses. + + return new ReferenceValue(commonDimensionCount == 0 ? + commonClazz.getName() : + ClassUtil.internalArrayTypeFromClassName(commonClazz.getName(), + commonDimensionCount), + commonClazz, + mayBeNull); + } + } + else if (thisDimensionCount > otherDimensionCount) + { + // See if the other type is an interface type of arrays. + if (ClassUtil.isInternalArrayInterfaceName(ClassUtil.internalClassNameFromClassType(otherType))) + { + return other.generalizeMayBeNull(mayBeNull); + } + } + else if (thisDimensionCount < otherDimensionCount) + { + // See if this type is an interface type of arrays. + if (ClassUtil.isInternalArrayInterfaceName(ClassUtil.internalClassNameFromClassType(thisType))) + { + return this.generalizeMayBeNull(mayBeNull); + } + } + + // Reduce the common dimension count if either type is an array of + // primitives type of this dimension. + if (commonDimensionCount > 0 && + (ClassUtil.isInternalPrimitiveType(otherType.charAt(commonDimensionCount))) || + ClassUtil.isInternalPrimitiveType(thisType.charAt(commonDimensionCount))) + { + commonDimensionCount--; + } + + // Fall back on a basic Object or array of Objects type. + return commonDimensionCount == 0 ? + mayBeNull ? + ValueFactory.REFERENCE_VALUE_JAVA_LANG_OBJECT_MAYBE_NULL : + ValueFactory.REFERENCE_VALUE_JAVA_LANG_OBJECT_NOT_NULL : + new ReferenceValue(ClassUtil.internalArrayTypeFromClassName(ClassConstants.INTERNAL_NAME_JAVA_LANG_OBJECT, + commonDimensionCount), + null, + mayBeNull); + } + + + /** + * Returns if the number of superclasses of the given class in the given + * set of classes. + */ + private int superClassCount(Clazz subClass, Set classes) + { + int count = 0; + + Iterator iterator = classes.iterator(); + + while (iterator.hasNext()) + { + Clazz clazz = (Clazz)iterator.next(); + if (subClass.extendsOrImplements(clazz)) + { + count++; + } + } + + //System.out.println("ReferenceValue.superClassCount: ["+subClass.getName()+"]: "+count); + + return count; + } + + + /** + * Returns whether this ReferenceValue is equal to the given other + * ReferenceValue. + * @return NEVER, MAYBE, or ALWAYS. + */ + public int equal(ReferenceValue other) + { + return this.type == null && other.type == null ? ALWAYS : MAYBE; + } + + + // Derived unary methods. + + /** + * Returns whether this ReferenceValue is not null. + * @return NEVER, MAYBE, or ALWAYS. + */ + public final int isNotNull() + { + return -isNull(); + } + + + /** + * Returns the generalization of this ReferenceValue and the given other + * ReferenceValue. + */ + private ReferenceValue generalizeMayBeNull(boolean mayBeNull) + { + return this.mayBeNull || !mayBeNull ? + this : + new ReferenceValue(this.type, this.referencedClass, true); + } + + + // Derived binary methods. + + /** + * Returns whether this ReferenceValue and the given ReferenceValue are different. + * @return NEVER, MAYBE, or ALWAYS. + */ + public final int notEqual(ReferenceValue other) + { + return -equal(other); + } + + + // Implementations for Value. + + public final ReferenceValue referenceValue() + { + return this; + } + + public final Value generalize(Value other) + { + return this.generalize(other.referenceValue()); + } + + public boolean isParticular() + { + return type == null; + } + + public final int computationalType() + { + return TYPE_REFERENCE; + } + + public final String internalType() + { + return + type == null ? ClassConstants.INTERNAL_TYPE_JAVA_LANG_OBJECT : + ClassUtil.isInternalArrayType(type) ? type : + ClassConstants.INTERNAL_TYPE_CLASS_START + + type + + ClassConstants.INTERNAL_TYPE_CLASS_END; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + if (this == object) + { + return true; + } + + if (object == null || + this.getClass() != object.getClass()) + { + return false; + } + + ReferenceValue other = (ReferenceValue)object; + return this.type == null ? other.type == null : + (this.mayBeNull == other.mayBeNull && + this.type.equals(other.type)); + } + + + public int hashCode() + { + return this.getClass().hashCode() ^ + (type == null ? 0 : type.hashCode() ^ (mayBeNull ? 0 : 1)); + } + + + public String toString() + { + return type == null ? + "null" : + type + (referencedClass == null ? "?" : "") + (mayBeNull ? "" : "!"); + } +} diff --git a/src/proguard/evaluation/value/SpecificDoubleValue.java b/src/proguard/evaluation/value/SpecificDoubleValue.java new file mode 100644 index 0000000..572d891 --- /dev/null +++ b/src/proguard/evaluation/value/SpecificDoubleValue.java @@ -0,0 +1,183 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This DoubleValue represents a specific double value. + * + * @author Eric Lafortune + */ +abstract class SpecificDoubleValue extends DoubleValue +{ + // Implementations of unary methods of DoubleValue. + + public DoubleValue negate() + { + return new NegatedDoubleValue(this); + } + + public IntegerValue convertToInteger() + { + return new ConvertedIntegerValue(this); + } + + public LongValue convertToLong() + { + return new ConvertedLongValue(this); + } + + public FloatValue convertToFloat() + { + return new ConvertedFloatValue(this); + } + + + // Implementations of binary methods of DoubleValue. + + public DoubleValue generalize(DoubleValue other) + { + return other.generalize(this); + } + + public DoubleValue add(DoubleValue other) + { + return other.add(this); + } + + public DoubleValue subtract(DoubleValue other) + { + return other.subtractFrom(this); + } + + public DoubleValue subtractFrom(DoubleValue other) + { + return other.subtract(this); + } + + public DoubleValue multiply(DoubleValue other) + { + return other.multiply(this); + } + + public DoubleValue divide(DoubleValue other) + { + return other.divideOf(this); + } + + public DoubleValue divideOf(DoubleValue other) + { + return other.divide(this); + } + + public DoubleValue remainder(DoubleValue other) + { + return other.remainderOf(this); + } + + public DoubleValue remainderOf(DoubleValue other) + { + return other.remainder(this); + } + + public IntegerValue compare(DoubleValue other) + { + return other.compareReverse(this); + } + + + // Implementations of binary DoubleValue methods with SpecificDoubleValue + // arguments. + + public DoubleValue generalize(SpecificDoubleValue other) + { + return this.equals(other) ? this : ValueFactory.DOUBLE_VALUE; + } + + public DoubleValue add(SpecificDoubleValue other) + { + return new CompositeDoubleValue(this, CompositeDoubleValue.ADD, other); + } + + public DoubleValue subtract(SpecificDoubleValue other) + { + return new CompositeDoubleValue(this, CompositeDoubleValue.SUBTRACT, other); + } + + public DoubleValue subtractFrom(SpecificDoubleValue other) + { + return new CompositeDoubleValue(other, CompositeDoubleValue.SUBTRACT, this); + } + + public DoubleValue multiply(SpecificDoubleValue other) + { + return new CompositeDoubleValue(this, CompositeDoubleValue.MULTIPLY, other); + } + + public DoubleValue divide(SpecificDoubleValue other) + { + return new CompositeDoubleValue(this, CompositeDoubleValue.DIVIDE, other); + } + + public DoubleValue divideOf(SpecificDoubleValue other) + { + return new CompositeDoubleValue(other, CompositeDoubleValue.DIVIDE, this); + } + + public DoubleValue remainder(SpecificDoubleValue other) + { + return new CompositeDoubleValue(this, CompositeDoubleValue.REMAINDER, other); + } + + public DoubleValue remainderOf(SpecificDoubleValue other) + { + return new CompositeDoubleValue(other, CompositeDoubleValue.REMAINDER, this); + } + + public IntegerValue compare(SpecificDoubleValue other) + { + return this.equals(other) ? + SpecificValueFactory.INTEGER_VALUE_0 : + new ComparisonValue(this, other); + } + + + // Implementations for Value. + + public boolean isSpecific() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } +} diff --git a/src/proguard/evaluation/value/SpecificFloatValue.java b/src/proguard/evaluation/value/SpecificFloatValue.java new file mode 100644 index 0000000..3bc3679 --- /dev/null +++ b/src/proguard/evaluation/value/SpecificFloatValue.java @@ -0,0 +1,183 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This FloatValue represents a specific float value. + * + * @author Eric Lafortune + */ +abstract class SpecificFloatValue extends FloatValue +{ + // Implementations of unary methods of FloatValue. + + public FloatValue negate() + { + return new NegatedFloatValue(this); + } + + public IntegerValue convertToInteger() + { + return new ConvertedIntegerValue(this); + } + + public LongValue convertToLong() + { + return new ConvertedLongValue(this); + } + + public DoubleValue convertToDouble() + { + return new ConvertedDoubleValue(this); + } + + + // Implementations of binary methods of FloatValue. + + public FloatValue generalize(FloatValue other) + { + return other.generalize(this); + } + + public FloatValue add(FloatValue other) + { + return other.add(this); + } + + public FloatValue subtract(FloatValue other) + { + return other.subtractFrom(this); + } + + public FloatValue subtractFrom(FloatValue other) + { + return other.subtract(this); + } + + public FloatValue multiply(FloatValue other) + { + return other.multiply(this); + } + + public FloatValue divide(FloatValue other) + { + return other.divideOf(this); + } + + public FloatValue divideOf(FloatValue other) + { + return other.divide(this); + } + + public FloatValue remainder(FloatValue other) + { + return other.remainderOf(this); + } + + public FloatValue remainderOf(FloatValue other) + { + return other.remainder(this); + } + + public IntegerValue compare(FloatValue other) + { + return other.compareReverse(this); + } + + + // Implementations of binary FloatValue methods with SpecificFloatValue + // arguments. + + public FloatValue generalize(SpecificFloatValue other) + { + return this.equals(other) ? this : ValueFactory.FLOAT_VALUE; + } + + public FloatValue add(SpecificFloatValue other) + { + return new CompositeFloatValue(this, CompositeFloatValue.ADD, other); + } + + public FloatValue subtract(SpecificFloatValue other) + { + return new CompositeFloatValue(this, CompositeFloatValue.SUBTRACT, other); + } + + public FloatValue subtractFrom(SpecificFloatValue other) + { + return new CompositeFloatValue(other, CompositeFloatValue.SUBTRACT, this); + } + + public FloatValue multiply(SpecificFloatValue other) + { + return new CompositeFloatValue(this, CompositeFloatValue.MULTIPLY, other); + } + + public FloatValue divide(SpecificFloatValue other) + { + return new CompositeFloatValue(this, CompositeFloatValue.DIVIDE, other); + } + + public FloatValue divideOf(SpecificFloatValue other) + { + return new CompositeFloatValue(other, CompositeFloatValue.DIVIDE, this); + } + + public FloatValue remainder(SpecificFloatValue other) + { + return new CompositeFloatValue(this, CompositeFloatValue.REMAINDER, other); + } + + public FloatValue remainderOf(SpecificFloatValue other) + { + return new CompositeFloatValue(other, CompositeFloatValue.REMAINDER, this); + } + + public IntegerValue compare(SpecificFloatValue other) + { + return this.equals(other) ? + SpecificValueFactory.INTEGER_VALUE_0 : + new ComparisonValue(this, other); + } + + + // Implementations for Value. + + public boolean isSpecific() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } +} diff --git a/src/proguard/evaluation/value/SpecificIntegerValue.java b/src/proguard/evaluation/value/SpecificIntegerValue.java new file mode 100644 index 0000000..57c48b1 --- /dev/null +++ b/src/proguard/evaluation/value/SpecificIntegerValue.java @@ -0,0 +1,354 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This IntegerValue represents a specific integer value. + * + * @author Eric Lafortune + */ +abstract class SpecificIntegerValue extends IntegerValue +{ + // Implementations of unary methods of IntegerValue. + + public IntegerValue negate() + { + return new NegatedIntegerValue(this); + } + + public IntegerValue convertToByte() + { + return new ConvertedByteValue(this); + } + + public IntegerValue convertToCharacter() + { + return new ConvertedCharacterValue(this); + } + + public IntegerValue convertToShort() + { + return new ConvertedShortValue(this); + } + + public LongValue convertToLong() + { + return new ConvertedLongValue(this); + } + + public FloatValue convertToFloat() + { + return new ConvertedFloatValue(this); + } + + public DoubleValue convertToDouble() + { + return new ConvertedDoubleValue(this); + } + + + // Implementations of binary methods of IntegerValue. + + public IntegerValue generalize(IntegerValue other) + { + return other.generalize(this); + } + + public IntegerValue add(IntegerValue other) + { + return other.add(this); + } + + public IntegerValue subtract(IntegerValue other) + { + return other.subtractFrom(this); + } + + public IntegerValue subtractFrom(IntegerValue other) + { + return other.subtract(this); + } + + public IntegerValue multiply(IntegerValue other) + { + return other.multiply(this); + } + + public IntegerValue divide(IntegerValue other) + throws ArithmeticException + { + return other.divideOf(this); + } + + public IntegerValue divideOf(IntegerValue other) + throws ArithmeticException + { + return other.divide(this); + } + + public IntegerValue remainder(IntegerValue other) + throws ArithmeticException + { + return other.remainderOf(this); + } + + public IntegerValue remainderOf(IntegerValue other) + throws ArithmeticException + { + return other.remainder(this); + } + + public IntegerValue shiftLeft(IntegerValue other) + { + return other.shiftLeftOf(this); + } + + public IntegerValue shiftLeftOf(IntegerValue other) + { + return other.shiftLeft(this); + } + + public IntegerValue shiftRight(IntegerValue other) + { + return other.shiftRightOf(this); + } + + public IntegerValue shiftRightOf(IntegerValue other) + { + return other.shiftRight(this); + } + + public IntegerValue unsignedShiftRight(IntegerValue other) + { + return other.unsignedShiftRightOf(this); + } + + public IntegerValue unsignedShiftRightOf(IntegerValue other) + { + return other.unsignedShiftRight(this); + } + + public LongValue shiftLeftOf(LongValue other) + { + return other.shiftLeft(this); + } + + public LongValue shiftRightOf(LongValue other) + { + return other.shiftRight(this); + } + + public LongValue unsignedShiftRightOf(LongValue other) + { + return other.unsignedShiftRight(this); + } + + public IntegerValue and(IntegerValue other) + { + return other.and(this); + } + + public IntegerValue or(IntegerValue other) + { + return other.or(this); + } + + public IntegerValue xor(IntegerValue other) + { + return other.xor(this); + } + + public int equal(IntegerValue other) + { + return other.equal(this); + } + + public int lessThan(IntegerValue other) + { + return other.greaterThan(this); + } + + public int lessThanOrEqual(IntegerValue other) + { + return other.greaterThanOrEqual(this); + } + + + // Implementations of binary IntegerValue methods with SpecificIntegerValue + // arguments. + + public IntegerValue generalize(SpecificIntegerValue other) + { + return this.equals(other) ? this : ValueFactory.INTEGER_VALUE; + } + + public IntegerValue add(SpecificIntegerValue other) + { + return new CompositeIntegerValue(this, CompositeIntegerValue.ADD, other); + } + + public IntegerValue subtract(SpecificIntegerValue other) + { + return this.equals(other) ? + SpecificValueFactory.INTEGER_VALUE_0 : + new CompositeIntegerValue(this, CompositeIntegerValue.SUBTRACT, other); + } + + public IntegerValue subtractFrom(SpecificIntegerValue other) + { + return this.equals(other) ? + SpecificValueFactory.INTEGER_VALUE_0 : + new CompositeIntegerValue(other, CompositeIntegerValue.SUBTRACT, this); + } + + public IntegerValue multiply(SpecificIntegerValue other) + { + return new CompositeIntegerValue(this, CompositeIntegerValue.MULTIPLY, other); + } + + public IntegerValue divide(SpecificIntegerValue other) + throws ArithmeticException + { + return new CompositeIntegerValue(this, CompositeIntegerValue.DIVIDE, other); + } + + public IntegerValue divideOf(SpecificIntegerValue other) + throws ArithmeticException + { + return new CompositeIntegerValue(other, CompositeIntegerValue.DIVIDE, this); + } + + public IntegerValue remainder(SpecificIntegerValue other) + throws ArithmeticException + { + return new CompositeIntegerValue(this, CompositeIntegerValue.REMAINDER, other); + } + + public IntegerValue remainderOf(SpecificIntegerValue other) + throws ArithmeticException + { + return new CompositeIntegerValue(other, CompositeIntegerValue.REMAINDER, this); + } + + public IntegerValue shiftLeft(SpecificIntegerValue other) + { + return new CompositeIntegerValue(this, CompositeIntegerValue.SHIFT_LEFT, other); + } + + public IntegerValue shiftRight(SpecificIntegerValue other) + { + return new CompositeIntegerValue(this, CompositeIntegerValue.SHIFT_RIGHT, other); + } + + public IntegerValue unsignedShiftRight(SpecificIntegerValue other) + { + return new CompositeIntegerValue(this, CompositeIntegerValue.UNSIGNED_SHIFT_RIGHT, other); + } + + public IntegerValue shiftLeftOf(SpecificIntegerValue other) + { + return new CompositeIntegerValue(other, CompositeIntegerValue.SHIFT_LEFT, this); + } + + public IntegerValue shiftRightOf(SpecificIntegerValue other) + { + return new CompositeIntegerValue(other, CompositeIntegerValue.SHIFT_RIGHT, this); + } + + public IntegerValue unsignedShiftRightOf(SpecificIntegerValue other) + { + return new CompositeIntegerValue(other, CompositeIntegerValue.UNSIGNED_SHIFT_RIGHT, this); + } + + public LongValue shiftLeftOf(SpecificLongValue other) + { + return new CompositeLongValue(other, CompositeLongValue.SHIFT_LEFT, this); + } + + public LongValue shiftRightOf(SpecificLongValue other) + { + return new CompositeLongValue(other, CompositeLongValue.SHIFT_RIGHT, this); + } + + public LongValue unsignedShiftRightOf(SpecificLongValue other) + { + return new CompositeLongValue(other, CompositeLongValue.UNSIGNED_SHIFT_RIGHT, this); + } + + public IntegerValue and(SpecificIntegerValue other) + { + return this.equals(other) ? + this : + new CompositeIntegerValue(other, CompositeIntegerValue.AND, this); + } + + public IntegerValue or(SpecificIntegerValue other) + { + return this.equals(other) ? + this : + new CompositeIntegerValue(other, CompositeIntegerValue.OR, this); + } + + public IntegerValue xor(SpecificIntegerValue other) + { + return this.equals(other) ? + SpecificValueFactory.INTEGER_VALUE_0 : + new CompositeIntegerValue(other, CompositeIntegerValue.XOR, this); + } + + public int equal(SpecificIntegerValue other) + { + return this.equals(other) ? ALWAYS : MAYBE; + } + + public int lessThan(SpecificIntegerValue other) + { + return this.equals(other) ? NEVER : MAYBE; + } + + public int lessThanOrEqual(SpecificIntegerValue other) + { + return this.equals(other) ? ALWAYS : MAYBE; + } + + + // Implementations for Value. + + public boolean isSpecific() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } +} diff --git a/src/proguard/evaluation/value/SpecificLongValue.java b/src/proguard/evaluation/value/SpecificLongValue.java new file mode 100644 index 0000000..5e12bde --- /dev/null +++ b/src/proguard/evaluation/value/SpecificLongValue.java @@ -0,0 +1,259 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This LongValue represents a specific long value. + * + * @author Eric Lafortune + */ +abstract class SpecificLongValue extends LongValue +{ + // Implementations of unary methods of LongValue. + + public LongValue negate() + { + return new NegatedLongValue(this); + } + + public IntegerValue convertToInteger() + { + return new ConvertedIntegerValue(this); + } + + public FloatValue convertToFloat() + { + return new ConvertedFloatValue(this); + } + + public DoubleValue convertToDouble() + { + return new ConvertedDoubleValue(this); + } + + + // Implementations of binary methods of LongValue. + + public LongValue generalize(LongValue other) + { + return other.generalize(this); + } + + public LongValue add(LongValue other) + { + return other.add(this); + } + + public LongValue subtract(LongValue other) + { + return other.subtractFrom(this); + } + + public LongValue subtractFrom(LongValue other) + { + return other.subtract(this); + } + + public LongValue multiply(LongValue other) + { + return other.multiply(this); + } + + public LongValue divide(LongValue other) + throws ArithmeticException + { + return other.divideOf(this); + } + + public LongValue divideOf(LongValue other) + throws ArithmeticException + { + return other.divide(this); + } + + public LongValue remainder(LongValue other) + throws ArithmeticException + { + return other.remainderOf(this); + } + + public LongValue remainderOf(LongValue other) + throws ArithmeticException + { + return other.remainder(this); + } + + public LongValue shiftLeft(IntegerValue other) + { + return other.shiftLeftOf(this); + } + + public LongValue shiftRight(IntegerValue other) + { + return other.shiftRightOf(this); + } + + public LongValue unsignedShiftRight(IntegerValue other) + { + return other.unsignedShiftRightOf(this); + } + + public LongValue and(LongValue other) + { + return other.and(this); + } + + public LongValue or(LongValue other) + { + return other.or(this); + } + + public LongValue xor(LongValue other) + { + return other.xor(this); + } + + public IntegerValue compare(LongValue other) + { + return other.compareReverse(this); + } + + + // Implementations of binary LongValue methods with SpecificLongValue + // arguments. + + public LongValue generalize(SpecificLongValue other) + { + return this.equals(other) ? this : ValueFactory.LONG_VALUE; + } + + public LongValue add(SpecificLongValue other) + { + return new CompositeLongValue(this, CompositeLongValue.ADD, other); + } + + public LongValue subtract(SpecificLongValue other) + { + return this.equals(other) ? + SpecificValueFactory.LONG_VALUE_0 : + new CompositeLongValue(this, CompositeLongValue.SUBTRACT, other); + } + + public LongValue subtractFrom(SpecificLongValue other) + { + return this.equals(other) ? + SpecificValueFactory.LONG_VALUE_0 : + new CompositeLongValue(other, CompositeLongValue.SUBTRACT, this); + } + + public LongValue multiply(SpecificLongValue other) + { + return new CompositeLongValue(this, CompositeLongValue.MULTIPLY, other); + } + + public LongValue divide(SpecificLongValue other) + throws ArithmeticException + { + return new CompositeLongValue(this, CompositeLongValue.DIVIDE, other); + } + + public LongValue divideOf(SpecificLongValue other) + throws ArithmeticException + { + return new CompositeLongValue(other, CompositeLongValue.DIVIDE, this); + } + + public LongValue remainder(SpecificLongValue other) + throws ArithmeticException + { + return new CompositeLongValue(this, CompositeLongValue.REMAINDER, other); + } + + public LongValue remainderOf(SpecificLongValue other) + throws ArithmeticException + { + return new CompositeLongValue(other, CompositeLongValue.REMAINDER, this); + } + + public LongValue shiftLeft(SpecificLongValue other) + { + return new CompositeLongValue(this, CompositeLongValue.SHIFT_LEFT, other); + } + + public LongValue shiftRight(SpecificLongValue other) + { + return new CompositeLongValue(this, CompositeLongValue.SHIFT_RIGHT, other); + } + + public LongValue unsignedShiftRight(SpecificLongValue other) + { + return new CompositeLongValue(this, CompositeLongValue.UNSIGNED_SHIFT_RIGHT, other); + } + + public LongValue and(SpecificLongValue other) + { + return this.equals(other) ? + this : + new CompositeLongValue(other, CompositeLongValue.AND, this); + } + + public LongValue or(SpecificLongValue other) + { + return this.equals(other) ? + this : + new CompositeLongValue(other, CompositeLongValue.OR, this); + } + + public LongValue xor(SpecificLongValue other) + { + return this.equals(other) ? + SpecificValueFactory.LONG_VALUE_0 : + new CompositeLongValue(other, CompositeLongValue.XOR, this); + } + + public IntegerValue compare(SpecificLongValue other) + { + return new ComparisonValue(this, other); + } + + + // Implementations for Value. + + public boolean isSpecific() + { + return true; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } +} diff --git a/src/proguard/evaluation/value/SpecificValueFactory.java b/src/proguard/evaluation/value/SpecificValueFactory.java new file mode 100644 index 0000000..72dd1d3 --- /dev/null +++ b/src/proguard/evaluation/value/SpecificValueFactory.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This class provides methods to create and reuse IntegerValue objects. + * + * @author Eric Lafortune + */ +public class SpecificValueFactory +extends ValueFactory +{ + // Shared copies of Value objects, to avoid creating a lot of objects. + static final IntegerValue INTEGER_VALUE_M1 = new ParticularIntegerValue(-1); + static final IntegerValue INTEGER_VALUE_0 = new ParticularIntegerValue(0); + static final IntegerValue INTEGER_VALUE_1 = new ParticularIntegerValue(1); + static final IntegerValue INTEGER_VALUE_2 = new ParticularIntegerValue(2); + static final IntegerValue INTEGER_VALUE_3 = new ParticularIntegerValue(3); + static final IntegerValue INTEGER_VALUE_4 = new ParticularIntegerValue(4); + static final IntegerValue INTEGER_VALUE_5 = new ParticularIntegerValue(5); + static final LongValue LONG_VALUE_0 = new ParticularLongValue(0); + static final LongValue LONG_VALUE_1 = new ParticularLongValue(1); + static final FloatValue FLOAT_VALUE_0 = new ParticularFloatValue(0.0f); + static final FloatValue FLOAT_VALUE_1 = new ParticularFloatValue(1.0f); + static final FloatValue FLOAT_VALUE_2 = new ParticularFloatValue(2.0f); + static final DoubleValue DOUBLE_VALUE_0 = new ParticularDoubleValue(0.0); + static final DoubleValue DOUBLE_VALUE_1 = new ParticularDoubleValue(1.0); + + + // Implementations for ValueFactory. + + public IntegerValue createIntegerValue(int value) + { + switch (value) + { + case -1: return INTEGER_VALUE_M1; + case 0: return INTEGER_VALUE_0; + case 1: return INTEGER_VALUE_1; + case 2: return INTEGER_VALUE_2; + case 3: return INTEGER_VALUE_3; + case 4: return INTEGER_VALUE_4; + case 5: return INTEGER_VALUE_5; + default: return new ParticularIntegerValue(value); + } + } + + + public LongValue createLongValue(long value) + { + return value == 0 ? LONG_VALUE_0 : + value == 1 ? LONG_VALUE_1 : + new ParticularLongValue(value); + } + + + public FloatValue createFloatValue(float value) + { + return value == 0.0f ? FLOAT_VALUE_0 : + value == 1.0f ? FLOAT_VALUE_1 : + value == 2.0f ? FLOAT_VALUE_2 : + new ParticularFloatValue(value); + } + + + public DoubleValue createDoubleValue(double value) + { + return value == 0.0 ? DOUBLE_VALUE_0 : + value == 1.0 ? DOUBLE_VALUE_1 : + new ParticularDoubleValue(value); + } +} diff --git a/src/proguard/evaluation/value/TopValue.java b/src/proguard/evaluation/value/TopValue.java new file mode 100644 index 0000000..048a1ff --- /dev/null +++ b/src/proguard/evaluation/value/TopValue.java @@ -0,0 +1,79 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This class represents a partially evaluated top value. A top value is the + * dummy value that takes up the extra space when storing a long value or a + * double value. + * + * @author Eric Lafortune + */ +public class TopValue extends Category1Value +{ + // Implementations for Value. + + public boolean isSpecific() + { + return true; + } + + public boolean isParticular() + { + return true; + } + + public final Value generalize(Value other) + { + return this.getClass() == other.getClass() ? this : null; + } + + public final int computationalType() + { + return TYPE_TOP; + } + + public final String internalType() + { + return null; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } + + + public String toString() + { + return "T"; + } +} diff --git a/src/proguard/evaluation/value/UnknownDoubleValue.java b/src/proguard/evaluation/value/UnknownDoubleValue.java new file mode 100644 index 0000000..79cc4de --- /dev/null +++ b/src/proguard/evaluation/value/UnknownDoubleValue.java @@ -0,0 +1,125 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This class represents a partially evaluated double value. + * + * @author Eric Lafortune + */ +public class UnknownDoubleValue extends DoubleValue +{ + // Basic unary methods. + + public DoubleValue negate() + { + return this; + } + + public IntegerValue convertToInteger() + { + return ValueFactory.INTEGER_VALUE; + } + + public LongValue convertToLong() + { + return ValueFactory.LONG_VALUE; + } + + public FloatValue convertToFloat() + { + return ValueFactory.FLOAT_VALUE; + } + + + // Basic binary methods. + + public DoubleValue generalize(DoubleValue other) + { + return this; + } + + public DoubleValue add(DoubleValue other) + { + return this; + } + + public DoubleValue subtract(DoubleValue other) + { + return this; + } + + public DoubleValue subtractFrom(DoubleValue other) + { + return this; + } + + public DoubleValue multiply(DoubleValue other) + { + return this; + } + + public DoubleValue divide(DoubleValue other) + { + return this; + } + + public DoubleValue divideOf(DoubleValue other) + { + return this; + } + + public DoubleValue remainder(DoubleValue other) + { + return this; + } + + public DoubleValue remainderOf(DoubleValue other) + { + return this; + } + + public IntegerValue compare(DoubleValue other) + { + return ValueFactory.INTEGER_VALUE; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } + + + public String toString() + { + return "d"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/UnknownFloatValue.java b/src/proguard/evaluation/value/UnknownFloatValue.java new file mode 100644 index 0000000..3f9622a --- /dev/null +++ b/src/proguard/evaluation/value/UnknownFloatValue.java @@ -0,0 +1,125 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This class represents a partially evaluated float value. + * + * @author Eric Lafortune + */ +public class UnknownFloatValue extends FloatValue +{ + // Basic unary methods. + + public FloatValue negate() + { + return this; + } + + public IntegerValue convertToInteger() + { + return ValueFactory.INTEGER_VALUE; + } + + public LongValue convertToLong() + { + return ValueFactory.LONG_VALUE; + } + + public DoubleValue convertToDouble() + { + return ValueFactory.DOUBLE_VALUE; + } + + + // Basic binary methods. + + public FloatValue generalize(FloatValue other) + { + return this; + } + + public FloatValue add(FloatValue other) + { + return this; + } + + public FloatValue subtract(FloatValue other) + { + return this; + } + + public FloatValue subtractFrom(FloatValue other) + { + return this; + } + + public FloatValue multiply(FloatValue other) + { + return this; + } + + public FloatValue divide(FloatValue other) + { + return this; + } + + public FloatValue divideOf(FloatValue other) + { + return this; + } + + public FloatValue remainder(FloatValue other) + { + return this; + } + + public FloatValue remainderOf(FloatValue other) + { + return this; + } + + public IntegerValue compare(FloatValue other) + { + return ValueFactory.INTEGER_VALUE; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } + + + public String toString() + { + return "d"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/UnknownIntegerValue.java b/src/proguard/evaluation/value/UnknownIntegerValue.java new file mode 100644 index 0000000..be5e79d --- /dev/null +++ b/src/proguard/evaluation/value/UnknownIntegerValue.java @@ -0,0 +1,216 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This class represents a partially evaluated integer value. + * + * @author Eric Lafortune + */ +public class UnknownIntegerValue extends IntegerValue +{ + // Basic unary methods. + + public IntegerValue negate() + { + return this; + } + + public IntegerValue convertToByte() + { + return this; + } + + public IntegerValue convertToCharacter() + { + return this; + } + + public IntegerValue convertToShort() + { + return this; + } + + public LongValue convertToLong() + { + return ValueFactory.LONG_VALUE; + } + + public FloatValue convertToFloat() + { + return ValueFactory.FLOAT_VALUE; + } + + public DoubleValue convertToDouble() + { + return ValueFactory.DOUBLE_VALUE; + } + + + // Basic binary methods. + + public IntegerValue generalize(IntegerValue other) + { + return this; + } + + + public IntegerValue add(IntegerValue other) + { + return this; + } + + public IntegerValue subtract(IntegerValue other) + { + return this; + } + + public IntegerValue subtractFrom(IntegerValue other) + { + return this; + } + + public IntegerValue multiply(IntegerValue other) + throws ArithmeticException + { + return this; + } + + public IntegerValue divide(IntegerValue other) + throws ArithmeticException + { + return this; + } + + public IntegerValue divideOf(IntegerValue other) + throws ArithmeticException + { + return this; + } + + public IntegerValue remainder(IntegerValue other) + throws ArithmeticException + { + return this; + } + + public IntegerValue remainderOf(IntegerValue other) + throws ArithmeticException + { + return this; + } + + public IntegerValue shiftLeft(IntegerValue other) + { + return this; + } + + public IntegerValue shiftLeftOf(IntegerValue other) + { + return this; + } + + public IntegerValue shiftRight(IntegerValue other) + { + return this; + } + + public IntegerValue shiftRightOf(IntegerValue other) + { + return this; + } + + public IntegerValue unsignedShiftRight(IntegerValue other) + { + return this; + } + + public IntegerValue unsignedShiftRightOf(IntegerValue other) + { + return this; + } + + public LongValue shiftLeftOf(LongValue other) + { + return ValueFactory.LONG_VALUE; + } + + public LongValue shiftRightOf(LongValue other) + { + return ValueFactory.LONG_VALUE; + } + + public LongValue unsignedShiftRightOf(LongValue other) + { + return ValueFactory.LONG_VALUE; + } + + public IntegerValue and(IntegerValue other) + { + return this; + } + + public IntegerValue or(IntegerValue other) + { + return this; + } + + public IntegerValue xor(IntegerValue other) + { + return this; + } + + public int equal(IntegerValue other) + { + return MAYBE; + } + + public int lessThan(IntegerValue other) + { + return MAYBE; + } + + public int lessThanOrEqual(IntegerValue other) + { + return MAYBE; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } + + + public String toString() + { + return "i"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/UnknownLongValue.java b/src/proguard/evaluation/value/UnknownLongValue.java new file mode 100644 index 0000000..83a75dc --- /dev/null +++ b/src/proguard/evaluation/value/UnknownLongValue.java @@ -0,0 +1,160 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This class represents a partially evaluated long value. + * + * @author Eric Lafortune + */ +public class UnknownLongValue extends LongValue +{ + // Basic unary methods. + + public LongValue negate() + { + return this; + } + + public IntegerValue convertToInteger() + { + return ValueFactory.INTEGER_VALUE; + } + + public FloatValue convertToFloat() + { + return ValueFactory.FLOAT_VALUE; + } + + public DoubleValue convertToDouble() + { + return ValueFactory.DOUBLE_VALUE; + } + + + // Basic binary methods. + + public LongValue generalize(LongValue other) + { + return this; + } + + public LongValue add(LongValue other) + { + return this; + } + + public LongValue subtract(LongValue other) + { + return this; + } + + public LongValue subtractFrom(LongValue other) + { + return this; + } + + public LongValue multiply(LongValue other) + throws ArithmeticException + { + return this; + } + + public LongValue divide(LongValue other) + throws ArithmeticException + { + return this; + } + + public LongValue divideOf(LongValue other) + throws ArithmeticException + { + return this; + } + + public LongValue remainder(LongValue other) + throws ArithmeticException + { + return this; + } + + public LongValue remainderOf(LongValue other) + throws ArithmeticException + { + return this; + } + + public LongValue shiftLeft(IntegerValue other) + { + return this; + } + + public LongValue shiftRight(IntegerValue other) + { + return this; + } + + public LongValue unsignedShiftRight(IntegerValue other) + { + return this; + } + + public LongValue and(LongValue other) + { + return this; + } + + public LongValue or(LongValue other) + { + return this; + } + + public LongValue xor(LongValue other) + { + return this; + } + + public IntegerValue compare(LongValue other) + { + return ValueFactory.INTEGER_VALUE; + } + + + // Implementations for Object. + + public boolean equals(Object object) + { + return object != null && + this.getClass() == object.getClass(); + } + + + public int hashCode() + { + return this.getClass().hashCode(); + } + + + public String toString() + { + return "l"; + } +} \ No newline at end of file diff --git a/src/proguard/evaluation/value/Value.java b/src/proguard/evaluation/value/Value.java new file mode 100644 index 0000000..e24ece1 --- /dev/null +++ b/src/proguard/evaluation/value/Value.java @@ -0,0 +1,169 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +/** + * This abstract class represents a partially evaluated value. + * + * @author Eric Lafortune + */ +public abstract class Value +{ + public static final int NEVER = -1; + public static final int MAYBE = 0; + public static final int ALWAYS = 1; + + public static final int TYPE_INTEGER = 1; + public static final int TYPE_LONG = 2; + public static final int TYPE_FLOAT = 3; + public static final int TYPE_DOUBLE = 4; + public static final int TYPE_REFERENCE = 5; + public static final int TYPE_INSTRUCTION_OFFSET = 6; + public static final int TYPE_TOP = 7; + + + /** + * Returns this Value as a Category1Value. + */ + public Category1Value category1Value() + { + throw new IllegalArgumentException("Value is not a Category 1 value [" + this.getClass().getName() + "]"); + } + + /** + * Returns this Value as a Category2Value. + */ + public Category2Value category2Value() + { + throw new IllegalArgumentException("Value is not a Category 2 value [" + this.getClass().getName() + "]"); + } + + + /** + * Returns this Value as an IntegerValue. + */ + public IntegerValue integerValue() + { + throw new IllegalArgumentException("Value is not an integer value [" + this.getClass().getName() + "]"); + } + + /** + * Returns this Value as a LongValue. + */ + public LongValue longValue() + { + throw new IllegalArgumentException("Value is not a long value [" + this.getClass().getName() + "]"); + } + + /** + * Returns this Value as a FloatValue. + */ + public FloatValue floatValue() + { + throw new IllegalArgumentException("Value is not a float value [" + this.getClass().getName() + "]"); + } + + /** + * Returns this Value as a DoubleValue. + */ + public DoubleValue doubleValue() + { + throw new IllegalArgumentException("Value is not a double value [" + this.getClass().getName() + "]"); + } + + /** + * Returns this Value as a ReferenceValue. + */ + public ReferenceValue referenceValue() + { + throw new IllegalArgumentException("Value is not a reference value [" + this.getClass().getName() + "]"); + } + + /** + * Returns this Value as an InstructionOffsetValue. + */ + public InstructionOffsetValue instructionOffsetValue() + { + throw new IllegalArgumentException("Value is not an instruction offset value [" + this.getClass().getName() + "]"); + } + + + /** + * Returns whether this Value represents a single specific (but possibly + * unknown) value. + */ + public boolean isSpecific() + { + return false; + } + + + /** + * Returns whether this Value represents a single particular (known) + * value. + */ + public boolean isParticular() + { + return false; + } + + + /** + * Returns the generalization of this Value and the given other Value. + */ + public abstract Value generalize(Value other); + + + /** + * Returns whether the computational type of this Value is a category 2 type. + * This means that it takes up the space of two category 1 types on the + * stack, for instance. + */ + public abstract boolean isCategory2(); + + + /** + * Returns the computational type of this Value. + * @return TYPE_INTEGER, + * TYPE_LONG, + * TYPE_FLOAT, + * TYPE_DOUBLE, + * TYPE_REFERENCE, or + * TYPE_INSTRUCTION_OFFSET. + */ + public abstract int computationalType(); + + + /** + * Returns the internal type of this Value. + * @return ClassConstants.INTERNAL_TYPE_BOOLEAN, + * ClassConstants.INTERNAL_TYPE_BYTE, + * ClassConstants.INTERNAL_TYPE_CHAR, + * ClassConstants.INTERNAL_TYPE_SHORT, + * ClassConstants.INTERNAL_TYPE_INT, + * ClassConstants.INTERNAL_TYPE_LONG, + * ClassConstants.INTERNAL_TYPE_FLOAT, + * ClassConstants.INTERNAL_TYPE_DOUBLE, + * ClassConstants.INTERNAL_TYPE_CLASS_START ... ClassConstants.INTERNAL_TYPE_CLASS_END, or + * an array type containing any of these types (always as String). + */ + public abstract String internalType(); +} diff --git a/src/proguard/evaluation/value/ValueFactory.java b/src/proguard/evaluation/value/ValueFactory.java new file mode 100644 index 0000000..8415381 --- /dev/null +++ b/src/proguard/evaluation/value/ValueFactory.java @@ -0,0 +1,193 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.evaluation.value; + +import proguard.classfile.*; +import proguard.classfile.util.ClassUtil; + +/** + * This class provides methods to create and reuse Value objects. + * + * @author Eric Lafortune + */ +public class ValueFactory +{ + // Shared copies of Value objects, to avoid creating a lot of objects. + static final IntegerValue INTEGER_VALUE = new UnknownIntegerValue(); + static final LongValue LONG_VALUE = new UnknownLongValue(); + static final FloatValue FLOAT_VALUE = new UnknownFloatValue(); + static final DoubleValue DOUBLE_VALUE = new UnknownDoubleValue(); + + static final ReferenceValue REFERENCE_VALUE_NULL = new ReferenceValue(null, null, true); + static final ReferenceValue REFERENCE_VALUE_JAVA_LANG_OBJECT_MAYBE_NULL = new ReferenceValue(ClassConstants.INTERNAL_NAME_JAVA_LANG_OBJECT, null, true); + static final ReferenceValue REFERENCE_VALUE_JAVA_LANG_OBJECT_NOT_NULL = new ReferenceValue(ClassConstants.INTERNAL_NAME_JAVA_LANG_OBJECT, null, false); + + + /** + * Creates a new Value of the given type. + * The type must be a fully specified internal type for primitives, classes, + * or arrays. + */ + public Value createValue(String type, Clazz referencedClass, boolean mayBeNull) + { + switch (type.charAt(0)) + { + case ClassConstants.INTERNAL_TYPE_VOID: return null; + case ClassConstants.INTERNAL_TYPE_BOOLEAN: + case ClassConstants.INTERNAL_TYPE_BYTE: + case ClassConstants.INTERNAL_TYPE_CHAR: + case ClassConstants.INTERNAL_TYPE_SHORT: + case ClassConstants.INTERNAL_TYPE_INT: return createIntegerValue(); + case ClassConstants.INTERNAL_TYPE_LONG: return createLongValue(); + case ClassConstants.INTERNAL_TYPE_FLOAT: return createFloatValue(); + case ClassConstants.INTERNAL_TYPE_DOUBLE: return createDoubleValue(); + default: return createReferenceValue(ClassUtil.isInternalArrayType(type) ? + type : + ClassUtil.internalClassNameFromClassType(type), + referencedClass, + mayBeNull); + } + } + + /** + * Creates a new IntegerValue with an undefined value. + */ + public IntegerValue createIntegerValue() + { + return INTEGER_VALUE; + } + + /** + * Creates a new IntegerValue with a given particular value. + */ + public IntegerValue createIntegerValue(int value) + { + return createIntegerValue(); + } + + + /** + * Creates a new LongValue with an undefined value. + */ + public LongValue createLongValue() + { + return LONG_VALUE; + } + + /** + * Creates a new LongValue with a given particular value. + */ + public LongValue createLongValue(long value) + { + return createLongValue(); + } + + + /** + * Creates a new FloatValue with an undefined value. + */ + public FloatValue createFloatValue() + { + return FLOAT_VALUE; + } + + /** + * Creates a new FloatValue with a given particular value. + */ + public FloatValue createFloatValue(float value) + { + return createFloatValue(); + } + + + /** + * Creates a new DoubleValue with an undefined value. + */ + public DoubleValue createDoubleValue() + { + return DOUBLE_VALUE; + } + + /** + * Creates a new DoubleValue with a given particular value. + */ + public DoubleValue createDoubleValue(double value) + { + return createDoubleValue(); + } + + + /** + * Creates a new ReferenceValue that represents null. + */ + public ReferenceValue createReferenceValueNull() + { + return REFERENCE_VALUE_NULL; + } + + + /** + * Creates a new ReferenceValue of the given type. The type must be an + * internal class name or an array type. If the type is null, + * the ReferenceValue represents null. + */ + public ReferenceValue createReferenceValue(String type, + Clazz referencedClass, + boolean mayBeNull) + { + return type == null ? REFERENCE_VALUE_NULL : + !type.equals(ClassConstants.INTERNAL_NAME_JAVA_LANG_OBJECT) ? new ReferenceValue(type, referencedClass, mayBeNull) : + mayBeNull ? REFERENCE_VALUE_JAVA_LANG_OBJECT_MAYBE_NULL : + REFERENCE_VALUE_JAVA_LANG_OBJECT_NOT_NULL; + } + + + /** + * Creates a new ReferenceValue for arrays of the given type and length. + * The type must be a fully specified internal type for primitives, classes, + * or arrays. + */ + public ReferenceValue createArrayReferenceValue(String type, + Clazz referencedClass, + IntegerValue arrayLength) + { + return createArrayReferenceValue(type, + referencedClass, + arrayLength, + createValue(type, referencedClass, false)); + } + + + /** + * Creates a new ReferenceValue for arrays of the given type and length, + * containing the given element. The type must be a fully specified internal + * type for primitives, classes, or arrays. + */ + public ReferenceValue createArrayReferenceValue(String type, + Clazz referencedClass, + IntegerValue arrayLength, + Value elementValue) + { + return createReferenceValue(ClassConstants.INTERNAL_TYPE_ARRAY + type, + referencedClass, + false); + } +} diff --git a/src/proguard/evaluation/value/package.html b/src/proguard/evaluation/value/package.html new file mode 100644 index 0000000..71e1b13 --- /dev/null +++ b/src/proguard/evaluation/value/package.html @@ -0,0 +1,3 @@ + +This package contains classes that represent partial evaluation values. + diff --git a/src/proguard/gui/ClassPathPanel.java b/src/proguard/gui/ClassPathPanel.java new file mode 100644 index 0000000..95f3d1b --- /dev/null +++ b/src/proguard/gui/ClassPathPanel.java @@ -0,0 +1,441 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.*; +import proguard.util.ListUtil; + +import javax.swing.*; +import java.awt.*; +import java.awt.event.*; +import java.io.File; +import java.util.List; + +/** + * This ListPanel allows the user to add, edit, filter, move, and + * remove ClassPathEntry objects in a ClassPath object. + * + * @author Eric Lafortune + */ +class ClassPathPanel extends ListPanel +{ + private final JFrame owner; + private final boolean inputAndOutput; + private final JFileChooser chooser; + private final FilterDialog filterDialog; + + + public ClassPathPanel(JFrame owner, boolean inputAndOutput) + { + super(); + + super.firstSelectionButton = inputAndOutput ? 3 : 2; + + this.owner = owner; + this.inputAndOutput = inputAndOutput; + + list.setCellRenderer(new MyListCellRenderer()); + + chooser = new JFileChooser(""); + chooser.setMultiSelectionEnabled(true); + chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES); + chooser.addChoosableFileFilter( + new ExtensionFileFilter(msg("jarWarEarZipExtensions"), + new String[] { ".jar", ".war", ".ear", ".zip" })); + chooser.setApproveButtonText(msg("ok")); + + filterDialog = new FilterDialog(owner, msg("enterFilter")); + + addAddButton(inputAndOutput, false); + if (inputAndOutput) + { + addAddButton(inputAndOutput, true); + } + addEditButton(); + addFilterButton(); + addRemoveButton(); + addUpButton(); + addDownButton(); + + enableSelectionButtons(); + } + + + protected void addAddButton(boolean inputAndOutput, + final boolean isOutput) + { + JButton addButton = new JButton(msg(inputAndOutput ? + isOutput ? "addOutput" : + "addInput" : + "add")); + addButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + chooser.setDialogTitle(msg("addJars")); + chooser.setSelectedFile(null); + chooser.setSelectedFiles(null); + + int returnValue = chooser.showOpenDialog(owner); + if (returnValue == JFileChooser.APPROVE_OPTION) + { + File[] selectedFiles = chooser.getSelectedFiles(); + ClassPathEntry[] entries = classPathEntries(selectedFiles, isOutput); + + // Add the new elements. + addElements(entries); + } + } + }); + + addButton(tip(addButton, inputAndOutput ? + isOutput ? "addOutputTip" : + "addInputTip" : + "addTip")); + } + + + protected void addEditButton() + { + JButton editButton = new JButton(msg("edit")); + editButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + boolean isOutput = false; + + int[] selectedIndices = list.getSelectedIndices(); + + // Copy the Object array into a File array. + File[] selectedFiles = new File[selectedIndices.length]; + for (int index = 0; index < selectedFiles.length; index++) + { + ClassPathEntry entry = + (ClassPathEntry)listModel.getElementAt(selectedIndices[index]); + + isOutput = entry.isOutput(); + + selectedFiles[index] = entry.getFile(); + } + + chooser.setDialogTitle(msg("chooseJars")); + + // Up to JDK 1.3.1, setSelectedFiles doesn't show in the file + // chooser, so we just use setSelectedFile first. It also sets + // the current directory. + chooser.setSelectedFile(selectedFiles[0]); + chooser.setSelectedFiles(selectedFiles); + + int returnValue = chooser.showOpenDialog(owner); + if (returnValue == JFileChooser.APPROVE_OPTION) + { + selectedFiles = chooser.getSelectedFiles(); + ClassPathEntry[] entries = classPathEntries(selectedFiles, isOutput); + + // If there are the same number of files selected now as + // there were before, we can just replace the old ones. + if (selectedIndices.length == selectedFiles.length) + { + // Replace the old elements. + setElementsAt(entries, selectedIndices); + } + else + { + // Remove the old elements. + removeElementsAt(selectedIndices); + + // Add the new elements. + addElements(entries); + } + } + } + }); + + addButton(tip(editButton, "editTip")); + } + + + protected void addFilterButton() + { + JButton filterButton = new JButton(msg("filter")); + filterButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + if (!list.isSelectionEmpty()) + { + int[] selectedIndices = list.getSelectedIndices(); + + // Put the filters of the first selected entry in the dialog. + getFiltersFrom(selectedIndices[0]); + + int returnValue = filterDialog.showDialog(); + if (returnValue == FilterDialog.APPROVE_OPTION) + { + // Apply the entered filters to all selected entries. + setFiltersAt(selectedIndices); + } + } + } + }); + + addButton(tip(filterButton, "filterTip")); + } + + + /** + * Sets the ClassPath to be represented in this panel. + */ + public void setClassPath(ClassPath classPath) + { + listModel.clear(); + + if (classPath != null) + { + for (int index = 0; index < classPath.size(); index++) + { + listModel.addElement(classPath.get(index)); + } + } + + // Make sure the selection buttons are properly enabled, + // since the clear method doesn't seem to notify the listener. + enableSelectionButtons(); + } + + + /** + * Returns the ClassPath currently represented in this panel. + */ + public ClassPath getClassPath() + { + int size = listModel.size(); + if (size == 0) + { + return null; + } + + ClassPath classPath = new ClassPath(); + for (int index = 0; index < size; index++) + { + classPath.add((ClassPathEntry)listModel.get(index)); + } + + return classPath; + } + + + /** + * Converts the given array of File objects into a corresponding array of + * ClassPathEntry objects. + */ + private ClassPathEntry[] classPathEntries(File[] files, boolean isOutput) + { + ClassPathEntry[] entries = new ClassPathEntry[files.length]; + for (int index = 0; index < entries.length; index++) + { + entries[index] = new ClassPathEntry(files[index], isOutput); + } + return entries; + } + + + /** + * Sets up the filter dialog with the filters from the specified class path + * entry. + */ + private void getFiltersFrom(int index) + { + ClassPathEntry firstEntry = (ClassPathEntry)listModel.get(index); + + filterDialog.setFilter(firstEntry.getFilter()); + filterDialog.setJarFilter(firstEntry.getJarFilter()); + filterDialog.setWarFilter(firstEntry.getWarFilter()); + filterDialog.setEarFilter(firstEntry.getEarFilter()); + filterDialog.setZipFilter(firstEntry.getZipFilter()); + } + + + /** + * Applies the entered filter to the specified class path entries. + * Any previously set filters are discarded. + */ + private void setFiltersAt(int[] indices) + { + for (int index = indices.length - 1; index >= 0; index--) + { + ClassPathEntry entry = (ClassPathEntry)listModel.get(indices[index]); + entry.setFilter(filterDialog.getFilter()); + entry.setJarFilter(filterDialog.getJarFilter()); + entry.setWarFilter(filterDialog.getWarFilter()); + entry.setEarFilter(filterDialog.getEarFilter()); + entry.setZipFilter(filterDialog.getZipFilter()); + } + + // Make sure they are selected and thus repainted. + list.setSelectedIndices(indices); + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } + + + /** + * This ListCellRenderer renders ClassPathEntry objects. + */ + private class MyListCellRenderer implements ListCellRenderer + { + private static final String ARROW_IMAGE_FILE = "arrow.gif"; + + private final JPanel cellPanel = new JPanel(new GridBagLayout()); + private final JLabel iconLabel = new JLabel("", JLabel.RIGHT); + private final JLabel jarNameLabel = new JLabel("", JLabel.RIGHT); + private final JLabel filterLabel = new JLabel("", JLabel.RIGHT); + + private final Icon arrowIcon; + + + public MyListCellRenderer() + { + GridBagConstraints jarNameLabelConstraints = new GridBagConstraints(); + jarNameLabelConstraints.anchor = GridBagConstraints.WEST; + jarNameLabelConstraints.insets = new Insets(1, 2, 1, 2); + + GridBagConstraints filterLabelConstraints = new GridBagConstraints(); + filterLabelConstraints.gridwidth = GridBagConstraints.REMAINDER; + filterLabelConstraints.fill = GridBagConstraints.HORIZONTAL; + filterLabelConstraints.weightx = 1.0; + filterLabelConstraints.anchor = GridBagConstraints.EAST; + filterLabelConstraints.insets = jarNameLabelConstraints.insets; + + arrowIcon = new ImageIcon(Toolkit.getDefaultToolkit().getImage(this.getClass().getResource(ARROW_IMAGE_FILE))); + + cellPanel.add(iconLabel, jarNameLabelConstraints); + cellPanel.add(jarNameLabel, jarNameLabelConstraints); + cellPanel.add(filterLabel, filterLabelConstraints); + } + + + // Implementations for ListCellRenderer. + + public Component getListCellRendererComponent(JList list, + Object value, + int index, + boolean isSelected, + boolean cellHasFocus) + { + ClassPathEntry entry = (ClassPathEntry)value; + + // Prepend an arrow to the output entries. + if (inputAndOutput && entry.isOutput()) + { + iconLabel.setIcon(arrowIcon); + } + else + { + iconLabel.setIcon(null); + } + + // Set the entry name text. + jarNameLabel.setText(entry.getName()); + + // Set the filter text. + StringBuffer filter = null; + filter = appendFilter(filter, entry.getZipFilter()); + filter = appendFilter(filter, entry.getEarFilter()); + filter = appendFilter(filter, entry.getWarFilter()); + filter = appendFilter(filter, entry.getJarFilter()); + filter = appendFilter(filter, entry.getFilter()); + + if (filter != null) + { + filter.append(')'); + } + + filterLabel.setText(filter != null ? filter.toString() : ""); + + // Set the colors. + if (isSelected) + { + cellPanel.setBackground(list.getSelectionBackground()); + jarNameLabel.setForeground(list.getSelectionForeground()); + filterLabel.setForeground(list.getSelectionForeground()); + } + else + { + cellPanel.setBackground(list.getBackground()); + jarNameLabel.setForeground(list.getForeground()); + filterLabel.setForeground(list.getForeground()); + } + + // Make the font color red if this is an input file that can't be read. + if (!(inputAndOutput && entry.isOutput()) && + !entry.getFile().canRead()) + { + jarNameLabel.setForeground(Color.red); + } + + cellPanel.setOpaque(true); + + return cellPanel; + } + + + private StringBuffer appendFilter(StringBuffer filter, List additionalFilter) + { + if (filter != null) + { + filter.append(';'); + } + + if (additionalFilter != null) + { + if (filter == null) + { + filter = new StringBuffer().append('('); + } + + filter.append(ListUtil.commaSeparatedString(additionalFilter)); + } + + return filter; + } + } +} diff --git a/src/proguard/gui/ClassSpecificationDialog.java b/src/proguard/gui/ClassSpecificationDialog.java new file mode 100644 index 0000000..36d80d4 --- /dev/null +++ b/src/proguard/gui/ClassSpecificationDialog.java @@ -0,0 +1,542 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.*; +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; + +import javax.swing.*; +import javax.swing.border.*; +import java.awt.*; +import java.awt.event.*; +import java.util.List; + +/** + * This JDialog allows the user to enter a String. + * + * @author Eric Lafortune + */ +final class ClassSpecificationDialog extends JDialog +{ + /** + * Return value if the dialog is canceled (with the Cancel button or by + * closing the dialog window). + */ + public static final int CANCEL_OPTION = 1; + + /** + * Return value if the dialog is approved (with the Ok button). + */ + public static final int APPROVE_OPTION = 0; + + + private final JTextArea commentsTextArea = new JTextArea(4, 20); + + private final JRadioButton keepClassesAndMembersRadioButton = new JRadioButton(msg("keep")); + private final JRadioButton keepClassMembersRadioButton = new JRadioButton(msg("keepClassMembers")); + private final JRadioButton keepClassesWithMembersRadioButton = new JRadioButton(msg("keepClassesWithMembers")); + + private final JCheckBox allowShrinkingCheckBox = new JCheckBox(msg("allowShrinking")); + private final JCheckBox allowOptimizationCheckBox = new JCheckBox(msg("allowOptimization")); + private final JCheckBox allowObfuscationCheckBox = new JCheckBox(msg("allowObfuscation")); + + + private final JRadioButton[] publicRadioButtons; + private final JRadioButton[] finalRadioButtons; + private final JRadioButton[] abstractRadioButtons; + private final JRadioButton[] enumRadioButtons; + private final JRadioButton[] annotationRadioButtons; + private final JRadioButton[] interfaceRadioButtons; + + private final JTextField annotationTypeTextField = new JTextField(20); + private final JTextField classNameTextField = new JTextField(20); + private final JTextField extendsAnnotationTypeTextField = new JTextField(20); + private final JTextField extendsClassNameTextField = new JTextField(20); + + private final MemberSpecificationsPanel memberSpecificationsPanel; + + private int returnValue; + + + public ClassSpecificationDialog(JFrame owner, boolean fullKeepOptions) + { + super(owner, msg("specifyClasses"), true); + setResizable(true); + + // Create some constraints that can be reused. + GridBagConstraints constraints = new GridBagConstraints(); + constraints.anchor = GridBagConstraints.WEST; + constraints.insets = new Insets(1, 2, 1, 2); + + GridBagConstraints constraintsStretch = new GridBagConstraints(); + constraintsStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsStretch.weightx = 1.0; + constraintsStretch.anchor = GridBagConstraints.WEST; + constraintsStretch.insets = constraints.insets; + + GridBagConstraints constraintsLast = new GridBagConstraints(); + constraintsLast.gridwidth = GridBagConstraints.REMAINDER; + constraintsLast.anchor = GridBagConstraints.WEST; + constraintsLast.insets = constraints.insets; + + GridBagConstraints constraintsLastStretch = new GridBagConstraints(); + constraintsLastStretch.gridwidth = GridBagConstraints.REMAINDER; + constraintsLastStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsLastStretch.weightx = 1.0; + constraintsLastStretch.anchor = GridBagConstraints.WEST; + constraintsLastStretch.insets = constraints.insets; + + GridBagConstraints panelConstraints = new GridBagConstraints(); + panelConstraints.gridwidth = GridBagConstraints.REMAINDER; + panelConstraints.fill = GridBagConstraints.HORIZONTAL; + panelConstraints.weightx = 1.0; + panelConstraints.weighty = 0.0; + panelConstraints.anchor = GridBagConstraints.NORTHWEST; + panelConstraints.insets = constraints.insets; + + GridBagConstraints stretchPanelConstraints = new GridBagConstraints(); + stretchPanelConstraints.gridwidth = GridBagConstraints.REMAINDER; + stretchPanelConstraints.fill = GridBagConstraints.BOTH; + stretchPanelConstraints.weightx = 1.0; + stretchPanelConstraints.weighty = 1.0; + stretchPanelConstraints.anchor = GridBagConstraints.NORTHWEST; + stretchPanelConstraints.insets = constraints.insets; + + GridBagConstraints labelConstraints = new GridBagConstraints(); + labelConstraints.anchor = GridBagConstraints.CENTER; + labelConstraints.insets = new Insets(2, 10, 2, 10); + + GridBagConstraints lastLabelConstraints = new GridBagConstraints(); + lastLabelConstraints.gridwidth = GridBagConstraints.REMAINDER; + lastLabelConstraints.anchor = GridBagConstraints.CENTER; + lastLabelConstraints.insets = labelConstraints.insets; + + GridBagConstraints advancedButtonConstraints = new GridBagConstraints(); + advancedButtonConstraints.weightx = 1.0; + advancedButtonConstraints.weighty = 1.0; + advancedButtonConstraints.anchor = GridBagConstraints.SOUTHWEST; + advancedButtonConstraints.insets = new Insets(4, 4, 8, 4); + + GridBagConstraints okButtonConstraints = new GridBagConstraints(); + okButtonConstraints.weightx = 1.0; + okButtonConstraints.weighty = 1.0; + okButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + okButtonConstraints.insets = advancedButtonConstraints.insets; + + GridBagConstraints cancelButtonConstraints = new GridBagConstraints(); + cancelButtonConstraints.gridwidth = GridBagConstraints.REMAINDER; + cancelButtonConstraints.weighty = 1.0; + cancelButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + cancelButtonConstraints.insets = advancedButtonConstraints.insets; + + GridBagLayout layout = new GridBagLayout(); + + Border etchedBorder = BorderFactory.createEtchedBorder(EtchedBorder.RAISED); + + // Create the comments panel. + JPanel commentsPanel = new JPanel(layout); + commentsPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("comments"))); + + JScrollPane commentsScrollPane = new JScrollPane(commentsTextArea); + commentsScrollPane.setBorder(classNameTextField.getBorder()); + + commentsPanel.add(tip(commentsScrollPane, "commentsTip"), constraintsLastStretch); + + // Create the keep option panel. + ButtonGroup keepButtonGroup = new ButtonGroup(); + keepButtonGroup.add(keepClassesAndMembersRadioButton); + keepButtonGroup.add(keepClassMembersRadioButton); + keepButtonGroup.add(keepClassesWithMembersRadioButton); + + JPanel keepOptionPanel = new JPanel(layout); + keepOptionPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("keepTitle"))); + + keepOptionPanel.add(tip(keepClassesAndMembersRadioButton, "keepTip"), constraintsLastStretch); + keepOptionPanel.add(tip(keepClassMembersRadioButton, "keepClassMembersTip"), constraintsLastStretch); + keepOptionPanel.add(tip(keepClassesWithMembersRadioButton, "keepClassesWithMembersTip"), constraintsLastStretch); + + // Create the allow option panel. + final JPanel allowOptionPanel = new JPanel(layout); + allowOptionPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("allowTitle"))); + + allowOptionPanel.add(tip(allowShrinkingCheckBox, "allowShrinkingTip"), constraintsLastStretch); + allowOptionPanel.add(tip(allowOptimizationCheckBox, "allowOptimizationTip"), constraintsLastStretch); + allowOptionPanel.add(tip(allowObfuscationCheckBox, "allowObfuscationTip"), constraintsLastStretch); + + // Create the access panel. + JPanel accessPanel = new JPanel(layout); + accessPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("access"))); + + accessPanel.add(Box.createGlue(), labelConstraints); + accessPanel.add(tip(new JLabel(msg("required")), "requiredTip"), labelConstraints); + accessPanel.add(tip(new JLabel(msg("not")), "notTip"), labelConstraints); + accessPanel.add(tip(new JLabel(msg("dontCare")), "dontCareTip"), labelConstraints); + accessPanel.add(Box.createGlue(), constraintsLastStretch); + + publicRadioButtons = addRadioButtonTriplet("Public", accessPanel); + finalRadioButtons = addRadioButtonTriplet("Final", accessPanel); + abstractRadioButtons = addRadioButtonTriplet("Abstract", accessPanel); + enumRadioButtons = addRadioButtonTriplet("Enum", accessPanel); + annotationRadioButtons = addRadioButtonTriplet("Annotation", accessPanel); + interfaceRadioButtons = addRadioButtonTriplet("Interface", accessPanel); + + // Create the annotation type panel. + final JPanel annotationTypePanel = new JPanel(layout); + annotationTypePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("annotation"))); + + annotationTypePanel.add(tip(annotationTypeTextField, "classNameTip"), constraintsLastStretch); + + // Create the class name panel. + JPanel classNamePanel = new JPanel(layout); + classNamePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("class"))); + + classNamePanel.add(tip(classNameTextField, "classNameTip"), constraintsLastStretch); + + // Create the extends annotation type panel. + final JPanel extendsAnnotationTypePanel = new JPanel(layout); + extendsAnnotationTypePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("extendsImplementsAnnotation"))); + + extendsAnnotationTypePanel.add(tip(extendsAnnotationTypeTextField, "classNameTip"), constraintsLastStretch); + + // Create the extends class name panel. + JPanel extendsClassNamePanel = new JPanel(layout); + extendsClassNamePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("extendsImplementsClass"))); + + extendsClassNamePanel.add(tip(extendsClassNameTextField, "classNameTip"), constraintsLastStretch); + + + // Create the class member list panel. + memberSpecificationsPanel = new MemberSpecificationsPanel(this, fullKeepOptions); + memberSpecificationsPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("classMembers"))); + + // Create the Advanced button. + final JButton advancedButton = new JButton(msg("basic")); + advancedButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + boolean visible = !allowOptionPanel.isVisible(); + + allowOptionPanel .setVisible(visible); + annotationTypePanel .setVisible(visible); + extendsAnnotationTypePanel.setVisible(visible); + + advancedButton.setText(msg(visible ? "basic" : "advanced")); + + pack(); + } + }); + advancedButton.doClick(); + + // Create the Ok button. + JButton okButton = new JButton(msg("ok")); + okButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + returnValue = APPROVE_OPTION; + hide(); + } + }); + + // Create the Cancel button. + JButton cancelButton = new JButton(msg("cancel")); + cancelButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + hide(); + } + }); + + // Add all panels to the main panel. + JPanel mainPanel = new JPanel(layout); + mainPanel.add(tip(commentsPanel, "commentsTip"), panelConstraints); + if (fullKeepOptions) + { + mainPanel.add(tip(keepOptionPanel, "keepTitleTip"), panelConstraints); + mainPanel.add(tip(allowOptionPanel, "allowTitleTip"), panelConstraints); + } + mainPanel.add(tip(accessPanel, "accessTip"), panelConstraints); + mainPanel.add(tip(annotationTypePanel, "annotationTip"), panelConstraints); + mainPanel.add(tip(classNamePanel, "classTip"), panelConstraints); + mainPanel.add(tip(extendsAnnotationTypePanel, "extendsImplementsAnnotationTip"), panelConstraints); + mainPanel.add(tip(extendsClassNamePanel, "extendsImplementsClassTip"), panelConstraints); + mainPanel.add(tip(memberSpecificationsPanel, "classMembersTip"), stretchPanelConstraints); + + mainPanel.add(tip(advancedButton, "advancedTip"), advancedButtonConstraints); + mainPanel.add(okButton, okButtonConstraints); + mainPanel.add(cancelButton, cancelButtonConstraints); + + getContentPane().add(new JScrollPane(mainPanel)); + } + + + /** + * Adds a JLabel and three JRadioButton instances in a ButtonGroup to the + * given panel with a GridBagLayout, and returns the buttons in an array. + */ + private JRadioButton[] addRadioButtonTriplet(String labelText, + JPanel panel) + { + GridBagConstraints labelConstraints = new GridBagConstraints(); + labelConstraints.anchor = GridBagConstraints.WEST; + labelConstraints.insets = new Insets(2, 10, 2, 10); + + GridBagConstraints buttonConstraints = new GridBagConstraints(); + buttonConstraints.insets = labelConstraints.insets; + + GridBagConstraints lastGlueConstraints = new GridBagConstraints(); + lastGlueConstraints.gridwidth = GridBagConstraints.REMAINDER; + lastGlueConstraints.weightx = 1.0; + + // Create the radio buttons. + JRadioButton radioButton0 = new JRadioButton(); + JRadioButton radioButton1 = new JRadioButton(); + JRadioButton radioButton2 = new JRadioButton(); + + // Put them in a button group. + ButtonGroup buttonGroup = new ButtonGroup(); + buttonGroup.add(radioButton0); + buttonGroup.add(radioButton1); + buttonGroup.add(radioButton2); + + // Add the label and the buttons to the panel. + panel.add(new JLabel(labelText), labelConstraints); + panel.add(radioButton0, buttonConstraints); + panel.add(radioButton1, buttonConstraints); + panel.add(radioButton2, buttonConstraints); + panel.add(Box.createGlue(), lastGlueConstraints); + + return new JRadioButton[] + { + radioButton0, + radioButton1, + radioButton2 + }; + } + + + /** + * Sets the KeepClassSpecification to be represented in this dialog. + */ + public void setKeepSpecification(KeepClassSpecification keepClassSpecification) + { + boolean markClasses = keepClassSpecification.markClasses; + boolean markConditionally = keepClassSpecification.markConditionally; + boolean allowShrinking = keepClassSpecification.allowShrinking; + boolean allowOptimization = keepClassSpecification.allowOptimization; + boolean allowObfuscation = keepClassSpecification.allowObfuscation; + + // Figure out the proper keep radio button and set it. + JRadioButton keepOptionRadioButton = + markConditionally ? keepClassesWithMembersRadioButton : + markClasses ? keepClassesAndMembersRadioButton : + keepClassMembersRadioButton; + + keepOptionRadioButton.setSelected(true); + + // Set the allow radio buttons. + allowShrinkingCheckBox .setSelected(allowShrinking); + allowOptimizationCheckBox.setSelected(allowOptimization); + allowObfuscationCheckBox .setSelected(allowObfuscation); + + setClassSpecification(keepClassSpecification); + } + + + /** + * Sets the ClassSpecification to be represented in this dialog. + */ + public void setClassSpecification(ClassSpecification classSpecification) + { + String comments = classSpecification.comments; + String annotationType = classSpecification.annotationType; + String className = classSpecification.className; + String extendsAnnotationType = classSpecification.extendsAnnotationType; + String extendsClassName = classSpecification.extendsClassName; + List keepFieldOptions = classSpecification.fieldSpecifications; + List keepMethodOptions = classSpecification.methodSpecifications; + + // Set the comments text area. + commentsTextArea.setText(comments == null ? "" : comments); + + // Set the access radio buttons. + setClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_PUBLIC, publicRadioButtons); + setClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_FINAL, finalRadioButtons); + setClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_ABSTRACT, abstractRadioButtons); + setClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_ENUM, enumRadioButtons); + setClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_ANNOTATTION, annotationRadioButtons); + setClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_INTERFACE, interfaceRadioButtons); + + // Set the class and annotation text fields. + annotationTypeTextField .setText(annotationType == null ? "" : ClassUtil.externalType(annotationType)); + classNameTextField .setText(className == null ? "*" : ClassUtil.externalClassName(className)); + extendsAnnotationTypeTextField.setText(extendsAnnotationType == null ? "" : ClassUtil.externalType(extendsAnnotationType)); + extendsClassNameTextField .setText(extendsClassName == null ? "" : ClassUtil.externalClassName(extendsClassName)); + + // Set the keep class member option list. + memberSpecificationsPanel.setMemberSpecifications(keepFieldOptions, keepMethodOptions); + } + + + /** + * Returns the KeepClassSpecification currently represented in this dialog. + */ + public KeepClassSpecification getKeepSpecification() + { + boolean markClasses = !keepClassMembersRadioButton .isSelected(); + boolean markConditionally = keepClassesWithMembersRadioButton.isSelected(); + boolean allowShrinking = allowShrinkingCheckBox .isSelected(); + boolean allowOptimization = allowOptimizationCheckBox .isSelected(); + boolean allowObfuscation = allowObfuscationCheckBox .isSelected(); + + return new KeepClassSpecification(markClasses, + markConditionally, + allowShrinking, + allowOptimization, + allowObfuscation, + getClassSpecification()); + } + + + /** + * Returns the ClassSpecification currently represented in this dialog. + */ + public ClassSpecification getClassSpecification() + { + String comments = commentsTextArea.getText(); + String annotationType = annotationTypeTextField.getText(); + String className = classNameTextField.getText(); + String extendsAnnotationType = extendsAnnotationTypeTextField.getText(); + String extendsClassName = extendsClassNameTextField.getText(); + + ClassSpecification classSpecification = + new ClassSpecification(comments.equals("") ? null : comments, + 0, + 0, + annotationType.equals("") ? null : ClassUtil.internalType(annotationType), + className.equals("") || + className.equals("*") ? null : ClassUtil.internalClassName(className), + extendsAnnotationType.equals("") ? null : ClassUtil.internalType(extendsAnnotationType), + extendsClassName.equals("") ? null : ClassUtil.internalClassName(extendsClassName)); + + // Also get the access radio button settings. + getClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_PUBLIC, publicRadioButtons); + getClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_FINAL, finalRadioButtons); + getClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_ABSTRACT, abstractRadioButtons); + getClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_ENUM, enumRadioButtons); + getClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_ANNOTATTION, annotationRadioButtons); + getClassSpecificationRadioButtons(classSpecification, ClassConstants.INTERNAL_ACC_INTERFACE, interfaceRadioButtons); + + // Get the keep class member option lists. + classSpecification.fieldSpecifications = memberSpecificationsPanel.getMemberSpecifications(true); + classSpecification.methodSpecifications = memberSpecificationsPanel.getMemberSpecifications(false); + + return classSpecification; + } + + + /** + * Shows this dialog. This method only returns when the dialog is closed. + * + * @return CANCEL_OPTION or APPROVE_OPTION, + * depending on the choice of the user. + */ + public int showDialog() + { + returnValue = CANCEL_OPTION; + + // Open the dialog in the right place, then wait for it to be closed, + // one way or another. + pack(); + setLocationRelativeTo(getOwner()); + show(); + + return returnValue; + } + + + /** + * Sets the appropriate radio button of a given triplet, based on the access + * flags of the given keep option. + */ + private void setClassSpecificationRadioButtons(ClassSpecification classSpecification, + int flag, + JRadioButton[] radioButtons) + { + int index = (classSpecification.requiredSetAccessFlags & flag) != 0 ? 0 : + (classSpecification.requiredUnsetAccessFlags & flag) != 0 ? 1 : + 2; + radioButtons[index].setSelected(true); + } + + + /** + * Updates the access flag of the given keep option, based on the given radio + * button triplet. + */ + private void getClassSpecificationRadioButtons(ClassSpecification classSpecification, + int flag, + JRadioButton[] radioButtons) + { + if (radioButtons[0].isSelected()) + { + classSpecification.requiredSetAccessFlags |= flag; + } + else if (radioButtons[1].isSelected()) + { + classSpecification.requiredUnsetAccessFlags |= flag; + } + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } +} diff --git a/src/proguard/gui/ClassSpecificationsPanel.java b/src/proguard/gui/ClassSpecificationsPanel.java new file mode 100644 index 0000000..2cf0b1d --- /dev/null +++ b/src/proguard/gui/ClassSpecificationsPanel.java @@ -0,0 +1,231 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.ClassSpecification; +import proguard.classfile.util.ClassUtil; + +import javax.swing.*; +import java.awt.*; +import java.awt.event.*; +import java.util.*; +import java.util.List; + + +/** + * This ListPanel allows the user to add, edit, move, and remove + * ClassSpecification entries in a list. + * + * @author Eric Lafortune + */ +class ClassSpecificationsPanel extends ListPanel +{ + protected final ClassSpecificationDialog classSpecificationDialog; + + + public ClassSpecificationsPanel(JFrame owner, boolean fullKeepOptions) + { + super(); + + list.setCellRenderer(new MyListCellRenderer()); + + classSpecificationDialog = new ClassSpecificationDialog(owner, fullKeepOptions); + + addAddButton(); + addEditButton(); + addRemoveButton(); + addUpButton(); + addDownButton(); + + enableSelectionButtons(); + } + + + protected void addAddButton() + { + JButton addButton = new JButton(msg("add")); + addButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + setClassSpecification(createClassSpecification()); + int returnValue = classSpecificationDialog.showDialog(); + if (returnValue == ClassSpecificationDialog.APPROVE_OPTION) + { + // Add the new element. + addElement(getClassSpecification()); + } + } + }); + + addButton(tip(addButton, "addTip")); + } + + + protected void addEditButton() + { + JButton editButton = new JButton(msg("edit")); + editButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + ClassSpecification selectedClassSpecification = + (ClassSpecification)list.getSelectedValue(); + + setClassSpecification(selectedClassSpecification); + int returnValue = classSpecificationDialog.showDialog(); + if (returnValue == ClassSpecificationDialog.APPROVE_OPTION) + { + // Replace the old element. + setElementAt(getClassSpecification(), + list.getSelectedIndex()); + } + } + }); + + addButton(tip(editButton, "editTip")); + } + + + protected ClassSpecification createClassSpecification() + { + return new ClassSpecification(); + } + + + protected void setClassSpecification(ClassSpecification classSpecification) + { + classSpecificationDialog.setClassSpecification(classSpecification); + } + + + protected ClassSpecification getClassSpecification() + { + return classSpecificationDialog.getClassSpecification(); + } + + + /** + * Sets the ClassSpecification objects to be represented in this panel. + */ + public void setClassSpecifications(List classSpecifications) + { + listModel.clear(); + + if (classSpecifications != null) + { + for (int index = 0; index < classSpecifications.size(); index++) + { + listModel.addElement(classSpecifications.get(index)); + } + } + + // Make sure the selection buttons are properly enabled, + // since the clear method doesn't seem to notify the listener. + enableSelectionButtons(); + } + + + /** + * Returns the ClassSpecification objects currently represented in this panel. + */ + public List getClassSpecifications() + { + int size = listModel.size(); + if (size == 0) + { + return null; + } + + List classSpecifications = new ArrayList(size); + for (int index = 0; index < size; index++) + { + classSpecifications.add(listModel.get(index)); + } + + return classSpecifications; + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } + + + /** + * This ListCellRenderer renders ClassSpecification objects. + */ + private static class MyListCellRenderer implements ListCellRenderer + { + private final JLabel label = new JLabel(); + + + // Implementations for ListCellRenderer. + + public Component getListCellRendererComponent(JList list, + Object value, + int index, + boolean isSelected, + boolean cellHasFocus) + { + ClassSpecification classSpecification = (ClassSpecification)value; + + String comments = classSpecification.comments; + + label.setText(comments != null ? comments.trim() : + classSpecification.className != null ? (msg("class") + ' ' + ClassUtil.externalClassName(classSpecification.className)) : + classSpecification.extendsClassName != null ? (msg("extensionsOf") + ' ' + ClassUtil.externalClassName(classSpecification.extendsClassName)) : + (msg("specificationNumber") + index)); + + if (isSelected) + { + label.setBackground(list.getSelectionBackground()); + label.setForeground(list.getSelectionForeground()); + } + else + { + label.setBackground(list.getBackground()); + label.setForeground(list.getForeground()); + } + + label.setOpaque(true); + + return label; + } + } +} diff --git a/src/proguard/gui/ExtensionFileFilter.java b/src/proguard/gui/ExtensionFileFilter.java new file mode 100644 index 0000000..d67be40 --- /dev/null +++ b/src/proguard/gui/ExtensionFileFilter.java @@ -0,0 +1,78 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import javax.swing.filechooser.FileFilter; +import java.io.File; + + +/** + * This FileFilter accepts files that end in one of the given + * extensions. + * + * @author Eric Lafortune + */ +final class ExtensionFileFilter extends FileFilter +{ + private final String description; + private final String[] extensions; + + + /** + * Creates a new ExtensionFileFilter. + * @param description a description of the filter. + * @param extensions an array of acceptable extensions. + */ + public ExtensionFileFilter(String description, String[] extensions) + { + this.description = description; + this.extensions = extensions; + } + + + // Implemntations for FileFilter + + public String getDescription() + { + return description; + } + + + public boolean accept(File file) + { + if (file.isDirectory()) + { + return true; + } + + String fileName = file.getName().toLowerCase(); + + for (int index = 0; index < extensions.length; index++) + { + if (fileName.endsWith(extensions[index])) + { + return true; + } + } + + return false; + } +} diff --git a/src/proguard/gui/FilterBuilder.java b/src/proguard/gui/FilterBuilder.java new file mode 100644 index 0000000..e46193f --- /dev/null +++ b/src/proguard/gui/FilterBuilder.java @@ -0,0 +1,208 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import javax.swing.*; + +/** + * This class builds filters corresponding to the selections and names of a + * given list of check boxes. + */ +public class FilterBuilder +{ + private JCheckBox[] checkBoxes; + private char separator; + + + /** + * Creates a new FilterBuilder. + * @param checkBoxes the check boxes with names and selections that should + * be reflected in the output filter. + * @param separator the separator for the names in the check boxes. + */ + public FilterBuilder(JCheckBox[] checkBoxes, char separator) + { + this.checkBoxes = checkBoxes; + this.separator = separator; + } + + + /** + * Builds a filter for the current names and selections of the check boxes. + */ + public String buildFilter() + { + StringBuffer positive = new StringBuffer(); + StringBuffer negative = new StringBuffer(); + + buildFilter("", positive, negative); + + return positive.length() <= negative.length() ? + positive.toString() : + negative.toString(); + } + + + /** + * Builds two versions of the filter for the given prefix. + * @param prefix the prefix. + * @param positive the filter to be extended, assuming the matching + * strings are accepted. + * @param negative the filter to be extended, assuming the matching + * strings are rejected. + */ + private void buildFilter(String prefix, + StringBuffer positive, + StringBuffer negative) + { + int positiveCount = 0; + int negativeCount = 0; + + // Count all selected and unselected check boxes with the prefix. + for (int index = 0; index < checkBoxes.length; index++) + { + JCheckBox checkBox = checkBoxes[index]; + String name = checkBox.getText(); + + if (name.startsWith(prefix)) + { + if (checkBox.isSelected()) + { + positiveCount++; + } + else + { + negativeCount++; + } + } + } + + // Are there only unselected check boxes? + if (positiveCount == 0) + { + // Extend the positive filter with exceptions and return. + if (positive.length() > 0) + { + positive.append(','); + } + positive.append('!').append(prefix); + if (prefix.length() == 0 || + prefix.charAt(prefix.length()-1) == separator) + { + positive.append('*'); + } + + return; + } + + // Are there only selected check boxes? + if (negativeCount == 0) + { + // Extend the negative filter with exceptions and return. + if (negative.length() > 0) + { + negative.append(','); + } + negative.append(prefix); + if (prefix.length() == 0 || + prefix.charAt(prefix.length()-1) == separator) + { + negative.append('*'); + } + + return; + } + + // Create new positive and negative filters for names starting with the + // prefix only. + StringBuffer positiveFilter = new StringBuffer(); + StringBuffer negativeFilter = new StringBuffer(); + + String newPrefix = null; + + for (int index = 0; index < checkBoxes.length; index++) + { + String name = checkBoxes[index].getText(); + + if (name.startsWith(prefix)) + { + if (newPrefix == null || + !name.startsWith(newPrefix)) + { + int prefixIndex = + name.indexOf(separator, prefix.length()+1); + + newPrefix = prefixIndex >= 0 ? + name.substring(0, prefixIndex+1) : + name; + + buildFilter(newPrefix, + positiveFilter, + negativeFilter); + } + } + } + + // Extend the positive filter. + if (positiveFilter.length() <= negativeFilter.length() + prefix.length() + 3) + { + if (positive.length() > 0 && + positiveFilter.length() > 0) + { + positive.append(','); + } + + positive.append(positiveFilter); + } + else + { + if (positive.length() > 0 && + negativeFilter.length() > 0) + { + positive.append(','); + } + + positive.append(negativeFilter).append(",!").append(prefix).append('*'); + } + + // Extend the negative filter. + if (negativeFilter.length() <= positiveFilter.length() + prefix.length() + 4) + { + if (negative.length() > 0 && + negativeFilter.length() > 0) + { + negative.append(','); + } + + negative.append(negativeFilter); + } + else + { + if (negative.length() > 0 && + positiveFilter.length() > 0) + { + negative.append(','); + } + + negative.append(positiveFilter).append(',').append(prefix).append('*'); + } + } +} diff --git a/src/proguard/gui/FilterDialog.java b/src/proguard/gui/FilterDialog.java new file mode 100644 index 0000000..1567a31 --- /dev/null +++ b/src/proguard/gui/FilterDialog.java @@ -0,0 +1,320 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.util.ListUtil; + +import javax.swing.*; +import javax.swing.border.*; +import java.awt.*; +import java.awt.event.*; +import java.util.List; + +/** + * This JDialog allows the user to enter a String. + * + * @author Eric Lafortune + */ +public class FilterDialog extends JDialog +{ + /** + * Return value if the dialog is canceled (with the Cancel button or by + * closing the dialog window). + */ + public static final int CANCEL_OPTION = 1; + + /** + * Return value if the dialog is approved (with the Ok button). + */ + public static final int APPROVE_OPTION = 0; + + private static final String DEFAULT_FILTER = "**"; + private static final String DEFAULT_JAR_FILTER = "**.jar"; + private static final String DEFAULT_WAR_FILTER = "**.war"; + private static final String DEFAULT_EAR_FILTER = "**.ear"; + private static final String DEFAULT_ZIP_FILTER = "**.zip"; + + + private final JTextField filterTextField = new JTextField(40); + private final JTextField jarFilterTextField = new JTextField(40); + private final JTextField warFilterTextField = new JTextField(40); + private final JTextField earFilterTextField = new JTextField(40); + private final JTextField zipFilterTextField = new JTextField(40); + private int returnValue; + + + public FilterDialog(JFrame owner, + String explanation) + { + super(owner, true); + setResizable(true); + + // Create some constraints that can be reused. + GridBagConstraints textConstraints = new GridBagConstraints(); + textConstraints.gridwidth = GridBagConstraints.REMAINDER; + textConstraints.fill = GridBagConstraints.HORIZONTAL; + textConstraints.weightx = 1.0; + textConstraints.weighty = 1.0; + textConstraints.anchor = GridBagConstraints.NORTHWEST; + textConstraints.insets = new Insets(10, 10, 10, 10); + + GridBagConstraints labelConstraints = new GridBagConstraints(); + labelConstraints.anchor = GridBagConstraints.WEST; + labelConstraints.insets = new Insets(1, 2, 1, 2); + + GridBagConstraints textFieldConstraints = new GridBagConstraints(); + textFieldConstraints.gridwidth = GridBagConstraints.REMAINDER; + textFieldConstraints.fill = GridBagConstraints.HORIZONTAL; + textFieldConstraints.weightx = 1.0; + textFieldConstraints.anchor = GridBagConstraints.WEST; + textFieldConstraints.insets = labelConstraints.insets; + + GridBagConstraints panelConstraints = new GridBagConstraints(); + panelConstraints.gridwidth = GridBagConstraints.REMAINDER; + panelConstraints.fill = GridBagConstraints.HORIZONTAL; + panelConstraints.weightx = 1.0; + panelConstraints.weighty = 0.0; + panelConstraints.anchor = GridBagConstraints.NORTHWEST; + panelConstraints.insets = labelConstraints.insets; + + GridBagConstraints okButtonConstraints = new GridBagConstraints(); + okButtonConstraints.weightx = 1.0; + okButtonConstraints.weighty = 1.0; + okButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + okButtonConstraints.insets = new Insets(4, 4, 8, 4); + + GridBagConstraints cancelButtonConstraints = new GridBagConstraints(); + cancelButtonConstraints.gridwidth = GridBagConstraints.REMAINDER; + cancelButtonConstraints.weighty = 1.0; + cancelButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + cancelButtonConstraints.insets = okButtonConstraints.insets; + + GridBagLayout layout = new GridBagLayout(); + + Border etchedBorder = BorderFactory.createEtchedBorder(EtchedBorder.RAISED); + + // Create the panel with the explanation. + JTextArea explanationTextArea = new JTextArea(explanation, 3, 0); + explanationTextArea.setOpaque(false); + explanationTextArea.setEditable(false); + explanationTextArea.setLineWrap(true); + explanationTextArea.setWrapStyleWord(true); + + // Create the filter labels. + JLabel filterLabel = new JLabel(msg("nameFilter")); + JLabel jarFilterLabel = new JLabel(msg("jarNameFilter")); + JLabel warFilterLabel = new JLabel(msg("warNameFilter")); + JLabel earFilterLabel = new JLabel(msg("earNameFilter")); + JLabel zipFilterLabel = new JLabel(msg("zipNameFilter")); + + // Create the filter panel. + JPanel filterPanel = new JPanel(layout); + filterPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("filters"))); + + filterPanel.add(explanationTextArea, textConstraints); + + filterPanel.add(tip(filterLabel, "nameFilterTip"), labelConstraints); + filterPanel.add(tip(filterTextField, "fileNameFilterTip"), textFieldConstraints); + + filterPanel.add(tip(jarFilterLabel, "jarNameFilterTip"), labelConstraints); + filterPanel.add(tip(jarFilterTextField, "fileNameFilterTip"), textFieldConstraints); + + filterPanel.add(tip(warFilterLabel, "warNameFilterTip"), labelConstraints); + filterPanel.add(tip(warFilterTextField, "fileNameFilterTip"), textFieldConstraints); + + filterPanel.add(tip(earFilterLabel, "earNameFilterTip"), labelConstraints); + filterPanel.add(tip(earFilterTextField, "fileNameFilterTip"), textFieldConstraints); + + filterPanel.add(tip(zipFilterLabel, "zipNameFilterTip"), labelConstraints); + filterPanel.add(tip(zipFilterTextField, "fileNameFilterTip"), textFieldConstraints); + + + JButton okButton = new JButton(msg("ok")); + okButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + returnValue = APPROVE_OPTION; + hide(); + } + }); + + JButton cancelButton = new JButton(msg("cancel")); + cancelButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + hide(); + } + }); + + // Add all panels to the main panel. + JPanel mainPanel = new JPanel(layout); + mainPanel.add(filterPanel, panelConstraints); + mainPanel.add(okButton, okButtonConstraints); + mainPanel.add(cancelButton, cancelButtonConstraints); + + getContentPane().add(mainPanel); + } + + + /** + * Sets the filter to be represented in this dialog. + */ + public void setFilter(List filter) + { + filterTextField.setText(filter != null ? ListUtil.commaSeparatedString(filter) : DEFAULT_FILTER); + } + + + /** + * Returns the filter currently represented in this dialog. + */ + public List getFilter() + { + String filter = filterTextField.getText(); + + return filter.equals(DEFAULT_FILTER) ? null : ListUtil.commaSeparatedList(filter); + } + + + /** + * Sets the jar filter to be represented in this dialog. + */ + public void setJarFilter(List filter) + { + jarFilterTextField.setText(filter != null ? ListUtil.commaSeparatedString(filter) : DEFAULT_JAR_FILTER); + } + + + /** + * Returns the jar filter currently represented in this dialog. + */ + public List getJarFilter() + { + String filter = jarFilterTextField.getText(); + + return filter.equals(DEFAULT_JAR_FILTER) ? null : ListUtil.commaSeparatedList(filter); + } + + + /** + * Sets the war filter to be represented in this dialog. + */ + public void setWarFilter(List filter) + { + warFilterTextField.setText(filter != null ? ListUtil.commaSeparatedString(filter) : DEFAULT_WAR_FILTER); + } + + + /** + * Returns the war filter currently represented in this dialog. + */ + public List getWarFilter() + { + String filter = warFilterTextField.getText(); + + return filter.equals(DEFAULT_WAR_FILTER) ? null : ListUtil.commaSeparatedList(filter); + } + + + /** + * Sets the ear filter to be represented in this dialog. + */ + public void setEarFilter(List filter) + { + earFilterTextField.setText(filter != null ? ListUtil.commaSeparatedString(filter) : DEFAULT_EAR_FILTER); + } + + + /** + * Returns the ear filter currently represented in this dialog. + */ + public List getEarFilter() + { + String filter = earFilterTextField.getText(); + + return filter.equals(DEFAULT_EAR_FILTER) ? null : ListUtil.commaSeparatedList(filter); + } + + + /** + * Sets the zip filter to be represented in this dialog. + */ + public void setZipFilter(List filter) + { + zipFilterTextField.setText(filter != null ? ListUtil.commaSeparatedString(filter) : DEFAULT_ZIP_FILTER); + } + + + /** + * Returns the zip filter currently represented in this dialog. + */ + public List getZipFilter() + { + String filter = zipFilterTextField.getText(); + + return filter.equals(DEFAULT_ZIP_FILTER) ? null : ListUtil.commaSeparatedList(filter); + } + + + /** + * Shows this dialog. This method only returns when the dialog is closed. + * + * @return CANCEL_OPTION or APPROVE_OPTION, + * depending on the choice of the user. + */ + public int showDialog() + { + returnValue = CANCEL_OPTION; + + // Open the dialog in the right place, then wait for it to be closed, + // one way or another. + pack(); + setLocationRelativeTo(getOwner()); + show(); + + return returnValue; + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } +} diff --git a/src/proguard/gui/GUIResources.java b/src/proguard/gui/GUIResources.java new file mode 100644 index 0000000..85d582c --- /dev/null +++ b/src/proguard/gui/GUIResources.java @@ -0,0 +1,56 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import java.text.MessageFormat; +import java.util.ResourceBundle; + + +/** + * This class provides some utility methods for working with resource bundles. + * + * @author Eric Lafortune + */ +class GUIResources +{ + private static final ResourceBundle messages = ResourceBundle.getBundle(GUIResources.class.getName()); + private static final MessageFormat formatter = new MessageFormat(""); + + + /** + * Returns an internationalized message, based on its key. + */ + public static String getMessage(String messageKey) + { + return messages.getString(messageKey); + } + + + /** + * Returns an internationalized, formatted message, based on its key, with + * the given arguments. + */ + public static String getMessage(String messageKey, Object[] messageArguments) + { + formatter.applyPattern(messages.getString(messageKey)); + return formatter.format(messageArguments); + } +} diff --git a/src/proguard/gui/GUIResources.properties b/src/proguard/gui/GUIResources.properties new file mode 100644 index 0000000..86ab7a1 --- /dev/null +++ b/src/proguard/gui/GUIResources.properties @@ -0,0 +1,631 @@ +# ProGuard -- shrinking, optimization, and obfuscation of Java class files. +# Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + +# +# Tab names. +# +proGuardTab = ProGuard +inputOutputTab = Input/Output +shrinkingTab = Shrinking +obfuscationTab = Obfuscation +optimizationTab = Optimization +informationTab = Information +processTab = Process +reTraceTab = ReTrace + +# +# Splash text. +# +developed = Developed by Eric Lafortune +shrinking = Shrinking +optimization = Optimization +obfuscation = Obfuscation +preverification = Preverification + +# +# Panel titles. +# +welcome = Welcome to ProGuard, version 4.4 +options = Options +keepAdditional = Keep additional classes and class members +keepNamesAdditional = Keep additional class names and class member names +assumeNoSideEffectsAdditional = Assume no side effects for additional methods +whyAreYouKeeping = Why are you keeping +preverificationAndTargeting = Preverification and targeting +consistencyAndCorrectness = Consistency and correctness +processingConsole = Processing console +reTraceSettings = ReTrace settings +deobfuscatedStackTrace = De-obfuscated stack trace + +keepAdditionalTip = \ + If required, keep additional classes, fields, and methods as entry points. +keepNamesAdditionalTip = \ + If required, keep the names of additional classes, fields, and methods. +assumeNoSideEffectsAdditionalTip = \ + Optionally specify additional methods that don't have any side effects.
    \ + Only add entries if you know what you're doing! +whyAreYouKeepingTip = \ + Ask ProGuard why it is keeping certain classes, fields, or methods. + +# +# Info texts. +# +proGuardInfo = \ + ProGuard is a free class file shrinker, optimizer, obfuscator, and preverifier.\ + \n\n\ + With this GUI, you can create, load, modify, and save ProGuard configurations. \ + \n\ + You can then process your code right away, or you can run ProGuard from the \ + command line using your saved configuration. \ + \n\n\ + With the ReTrace part of this GUI you can de-obfuscate your stack traces.\ + \n\n\ + ProGuard and ReTrace are written and maintained by Eric Lafortune.\ + \n\n\ + Distributed under the GNU General Public License.\ + \n\ + Copyright (c) 2002-2009. + +processingInfo = \ + You can now start processing your code, \ + or you can run ProGuard from the command line using your saved configuration. + +reTraceInfo = \ + If you had ProGuard write out a mapping file, \ + you can de-obfuscate your obfuscated stack traces with ReTrace!\ + \n\n\ + You can load an obfuscated stack trace from a file, \ + or you can paste it straight into the text area above. + +# +# Titles and labels corresponding to common ProGuard options. +# +programJars = Program jars, wars, ears, zips, and directories +libraryJars = Library jars, wars, ears, zips, and directories + +shrink = Shrink +printUsage = Print usage + +optimize = Optimize +allowAccessModification = Allow access modification +mergeInterfacesAggressively = Merge interfaces aggressively +optimizations = Optimizations +optimizationPasses = Optimization passes + +obfuscate = Obfuscate +printMapping = Print mapping +applyMapping = Apply mapping +obfuscationDictionary = Obfuscation dictionary +classObfuscationDictionary = Class obfuscation dictionary +packageObfuscationDictionary = Package obfuscation dictionary +overloadAggressively = Overload aggressively +useUniqueClassMemberNames = Use unique class member names +keepPackageNames = Keep package names +flattenPackageHierarchy = Flatten package hierarchy +repackageClasses = Repackage classes +useMixedCaseClassNames = Use mixed-case class names +keepAttributes = Keep attributes +renameSourceFileAttribute = Rename SourceFile attribute +adaptClassStrings = Adapt class strings +adaptResourceFileNames = Adapt resource file names +adaptResourceFileContents = Adapt resource file contents + +preverify = Preverify +microEdition = Micro Edition + +verbose = Verbose +note = Note potential mistakes in the configuration +warn = Warn about possibly erronous input +ignoreWarnings = Ignore warnings about possibly erronous input +skipNonPublicLibraryClasses = Skip non-public library classes +skipNonPublicLibraryClassMembers = Skip non-public library class members +keepDirectories = Keep directories +forceProcessing = Force processing +target = Target +targets = 1.0,1.1,1.2,1.3,1.4,1.5,1.6 +printSeeds = Print seeds +printConfiguration = Print configuration +dump = Print class files + +mappingFile = Mapping file +obfuscatedStackTrace = Obfuscated stack trace + +programJarsTip = \ + The input jars (wars, ears, zips, directories), followed by
    \ + their corresponding output jars (wars, ears, zips, directories). +libraryJarsTip = \ + The library jars (wars, ears, zips, directories), on which the program jars depend.
    \ + The library jars are required for processing, but they are not copied to the output. + +shrinkTip = \ + Remove unused classes, fields, and methods from the output. +printUsageTip = \ + Print out the list of unused classes, fields, and methods. + +optimizeTip = \ + Optimize the bytecode of the processed classes. +allowAccessModificationTip = \ + Allow the optimization step to modify the access modifiers of classes, fields, and methods. +mergeInterfacesAggressivelyTip = \ + Allow interfaces to be merged, even if their implementations don't implement all
    \ + interface methods. This is not allowed in the Java language, but it is allowed in bytecode. +optimizationsTip = \ + Specify the types of optimizations to be performed. +optimizationsFilterTip = \ + A filter for the names of the optimizations to be performed. +optimizationsSelectTip = \ + Select from the currently available optimizations... +optimizationPassesTip = \ + Specify the number of optimization passes to be performed. + +obfuscateTip = \ + Obfuscate the names of the processed classes, fields, and methods. +printMappingTip = \ + Print out the obfuscation mapping of original names to obfuscated names. +applyMappingTip = \ + Apply the given mapping of original names to obfuscated names. +obfuscationDictionaryTip = \ + Use the words in the given file for obfuscating field names and method names. +classObfuscationDictionaryTip = \ + Use the words in the given file for obfuscating class names. +packageObfuscationDictionaryTip = \ + Use the words in the given file for obfuscating package names. +overloadAggressivelyTip = \ + Allow fields and methods to get the same obfuscated names, even if only their types or
    \ + return types differ. This is not allowed in the Java language, but it is allowed in bytecode. +useUniqueClassMemberNamesTip = \ + Make sure fields and methods get the same obfuscation mapping across classes, even
    \ + if they are unrelated. This is advisable if the output is to be obfuscated incrementally. +keepPackageNamesTip = \ + Keep the specified package names from being obfuscated. +packageNamesTip = \ + An optional comma-separated list of package names,
    \ + e.g. myapplication,mylibrary.**
    \ + Possible wildcards:\ +

      \ +
    • ? for any single character, except the package separator.\ +
    • * for any number of any characters, except the package separator.\ +
    • ** for any number of any characters.\ +
    \ + The negator ! is also supported. +flattenPackageHierarchyTip = \ + Move all packages that are renamed into the given parent package. +repackageClassesTip = \ + Move all classes that are renamed into the given package. +packageTip = \ + The optional package name. +useMixedCaseClassNamesTip = \ + Generate mixed-case obfucated class names. This will complicate unpacking
    \ + the resulting jars on case-insensitive file systems, should that be necessary. +keepAttributesTip = \ + Keep the specified optional class file attributes. +attributesTip = \ + An optional comma-separated list of class file attributes.\ +
      \ +
    • "Exceptions,Innerclasses, Signature" are necessary if the output is to be used as a library.\ +
    • "Deprecated" is optional if the output is to be used as a library.\ +
    • "LocalVariable*Table" can be useful for debugging.\ +
    • "Sourcefile,LineNumberTable" are necessary for generating stack traces.\ +
    • "*Annotations*" is necessary for preserving annotations.\ +
    \ + The wildcard * and the negator ! are allowed. +renameSourceFileAttributeTip = \ + Put the given string in the "SourceFile" attribute of the processed class files.
    \ + It will appear as the file name of the classes in stack traces. +sourceFileAttributeTip = \ + The replacement "SourceFile" string. +adaptClassStringsTip = \ + Adapt string constants in the specified classes, based
    \ + on the obfuscated names of corresponding classes. +adaptResourceFileNamesTip = \ + Rename the specified resource files, based on the
    \ + obfuscated names of the corresponding class files. +adaptResourceFileContentsTip = \ + Adapt the contents of the specified resource files, based
    \ + on the obfuscated names of the processed classes. +fileNameFilterTip = \ + A filter on file names,
    \ + e.g. mydirectory1/**,mydirectory2/**
    \ + Possible wildcards:\ +
      \ +
    • ? for any single character, except the directory separator.\ +
    • * for any number of any characters, except the directory separator.\ +
    • ** for any number of any characters.\ +
    \ + The negator ! is also supported. + +preverifyTip = \ + Preverify the processed classes, for Java Micro Edition or for Java 6. +microEditionTip = \ + Target Java Micro Edition. + +verboseTip = \ + Print out verbose messages while processing. +noteTip = \ + Print out notes about special or unusual input. +noteFilterTip = \ + A filter matching classes for which no notes should be printed. +warnTip = \ + Print out warnings about possibly erronous input.
    \ + Only unset this option if you know what you're doing! +warnFilterTip = \ + A filter matching classes for which no warnings should be printed. +ignoreWarningsTip = \ + Ignore any warnings about possibly erronous input.
    \ + Only set this option if you know what you're doing! +skipNonPublicLibraryClassesTip = \ + Skip reading non-public library classes, for efficiency.
    \ + You may have to unset this option if ProGuard complains about missing classes. +skipNonPublicLibraryClassMembersTip = \ + Skip reading non-public library fields and methods, for efficiency.
    \ + You may have to unset this option if ProGuard complains about missing class members. +keepDirectoriesTip = \ + Keep the specified directories in the output jars, wars, ears, zips, or directories. +directoriesTip = \ + A filter on directory names,
    \ + e.g. mydirectory1,mydirectory2/**
    \ + Possible wildcards:\ +
      \ +
    • ? for any single character, except the directory separator.\ +
    • * for any number of any characters, except the directory separator.\ +
    • ** for any number of any characters.\ +
    \ + The negator ! is also supported. +forceProcessingTip = \ + Always process the input, even if the output seems up to date. +targetTip = \ + Target the specified version of Java. +printSeedsTip = \ + Print out the list of kept classes, fields, and methods. +printConfigurationTip = \ + Print out the configuration. +dumpTip = \ + Print out the internal structure of the processed class files. + +mappingFileTip = \ + The file containing the mapping of original names to obfuscated names. +obfuscatedStackTraceTip = \ + A stack trace produced by previously obfuscated code. + +# +# Titles and labels corresponding to ProGuard keep options. +# +keepTitle = Keep + +keep = Keep classes and class members +keepClassMembers = Keep class members only +keepClassesWithMembers = Keep classes and class members, if members are present + +allowTitle = Allow + +allowShrinking = Allow shrinking +allowOptimization = Allow optimization +allowObfuscation = Allow obfuscation + +keepTitleTip = Keep the specified classes and/or their fields and methods. + +keepTip = \ + Keep the specified classes, fields, and methods as entry points.
    \ + This is the most common option. +keepClassMembersTip = \ + Only keep the specified fields and methods as entry points. +keepClassesWithMembersTip = \ + Keep the specified classes, fields, and methods,
    \ + on the condition that the fields and methods are present. + +allowTitleTip = \ + Optionally relax keeping the specified classes, fields, and methods.
    \ + These are advanced options. + +allowShrinkingTip = \ + Remove the specified classes, fields, and methods anyway, if they are not used. +allowOptimizationTip = \ + Optimize the specified classes, fields, and methods as entry points anyway.
    \ + Only set this option if you know what you're doing! +allowObfuscationTip = \ + Obfuscate the names of the specified classes, fields, and methods anyway.
    \ + Only set this option if you know what you're doing! + +# +# Further keep titles and labels. +# +specifyClasses = Specify classes and class members... +specifyFields = Specify fields... +specifyMethods = Specify methods... + +comments = Comments +access = Access +required = Required +not = Not +dontCare = Don't care +annotation = Annotation +class = Class +extendsImplementsAnnotation = Extends/implements class with annotation +extendsImplementsClass = Extends/implements class +classMembers = Class members + +extensionsOf = Extensions of +specificationNumber = Specification # + +fieldType = Field type +returnType = Return type +name = Name +argumentTypes = Argument types + +commentsTip = \ + Optionally add a comment for this option in the configuration file. +accessTip = \ + Optionally place constraints on the access modifiers of this element.
    \ + E.g. only match public elements. +requiredTip = \ + The access modifier has to be set. +notTip = \ + The access modifier must not be set. +dontCareTip = \ + The access modifier is irrelevant. +annotationTip = \ + Optionally require the given annotation to be present on this element.
    \ + E.g. only match elements that have an annotation myPackage.MyAnnotation.
    \ + This is an advanced option. +classTip = \ + The name of the class or interface. +extendsImplementsAnnotationTip = \ + Optionally require the given annotation to be present on the
    \ + extended or implemented class or interface.
    \ + E.g. only match classes that extend a class that has an annotation
    \ + myPackage.MyAnnotation.
    \ + This is an advanced option. +extendsImplementsClassTip = \ + Optionally require the class to implement or extend the given class or interface.
    \ + E.g. only match classes that implement an interface myPackage.MyInterface. +classMembersTip = \ + Optionally keep fields and methods as entry points in the matching class or classes.
    \ + E.g. keep all public 'get*' methods as entry points. + +fieldTypeTip = The field type. +returnTypeTip = The method return type, if any. +nameTip = The name. +argumentTypesTip = The method argument types, if any. + +classNameTip = \ + The class name, e.g. myPackage.MyClass
    \ + Possible wildcards:\ +
      \ +
    • ? for any single character, except the package separator.\ +
    • * for any number of any characters, except the package separator.\ +
    • ** for any number of any characters.\ +
    +classNamesTip = \ + A regular expression to further constrain the class names,
    \ + e.g. myPackage1.MyClass,myPackage2.**
    \ + Possible wildcards:\ +
      \ +
    • ? for any single character, except the package separator.\ +
    • * for any number of any characters, except the package separator.\ +
    • ** for any number of any characters.\ +
    \ + The negator ! is also supported. +typeTip = \ + The type, e.g. int, or java.lang.String[]
    \ + Possible wildcards:\ +
      \ +
    • % for any primitive type.\ +
    • ? for any single character, except the package separator.\ +
    • * for any number of any characters, except the package separator.\ +
    • ** for any number of any characters.\ +
    • *** (or empty) for any type.\ +
    +fieldNameTip = \ + The field name, e.g. myField
    \ + Possible wildcards:\ +
      \ +
    • ? for any single character.\ +
    • * for any number of any characters.\ +
    +methodNameTip = \ + The method name, e.g. myMethod
    \ + Possible wildcards:\ +
      \ +
    • ? for any single character.\ +
    • * for any number of any characters.\ +
    +argumentTypes2Tip = \ + The comma-separated list of argument types,
    \ + e.g. java.lang.String[],int,boolean
    \ + Possible wildcards:\ +
      \ +
    • % for any primitive type.\ +
    • ? for any single character, except the package separator.\ +
    • * for any number of any characters, except the package separator.\ +
    • ** for any number of any characters.\ +
    • *** for any type.\ +
    • ... for any number of any arguments.\ +
    + +# +# Titles and labels corresponding to optimization options. +# +selectOptimizations = Select optimizations... + +field = Field +method = Method +code = Code + +class_marking_finalTip = \ + Mark classes as final, whenever possible. +class_merging_verticalTip = \ + Merge classes vertically in the class hierarchy, whenever possible. +class_merging_horizontalTip = \ + Merge classes horizontally in the class hierarchy, whenever possible. +field_removal_writeonlyTip = \ + Remove write-only fields. +field_marking_privateTip = \ + Mark fields as private, whenever possible. +field_propagation_valueTip = \ + Propagate the values of fields across methods. +method_marking_privateTip = \ + Mark methods as private, whenever possible (devirtualization). +method_marking_staticTip = \ + Mark methods as static, whenever possible (devirtualization). +method_marking_finalTip = \ + Mark methods as final, whenever possible. +method_removal_parameterTip = \ + Remove unused method parameters. +method_propagation_parameterTip = \ + Propagate the values of method parameters from method invocations to \ + the invoked methods. +method_propagation_returnvalueTip = \ + Propagate the values of method return values from methods to their \ + invocations. +method_inlining_shortTip = \ + Inline short methods. +method_inlining_uniqueTip = \ + Inline methods that are only called once. +method_inlining_tailrecursionTip = \ + Simplify tail recursion calls, whenever possible. +code_mergingTip = \ + Merge identical blocks of code by modifying branch targets. +code_simplification_variableTip = \ + Perform peephole optimizations for variable loading and storing. +code_simplification_arithmeticTip = \ + Perform peephole optimizations for arithmetic instructions. +code_simplification_castTip = \ + Perform peephole optimizations for casting operations. +code_simplification_fieldTip = \ + Perform peephole optimizations for field loading and storing. +code_simplification_branchTip = \ + Perform peephole optimizations for branch instructions. +code_simplification_advancedTip = \ + Simplify code based on control flow analysis and data flow analysis. +code_removal_advancedTip = \ + Remove dead code based on control flow analysis and data flow analysis. +code_removal_simpleTip = \ + Remove dead code based on a simple control flow analysis. +code_removal_variableTip = \ + Remove unused variables from the local variable frame. +code_removal_exceptionTip = \ + Remove exceptions with empty catch blocks. +code_allocation_variableTip = \ + Optimize variable allocation on the local variable frame. + + +# +# File selection titles. +# +selectConfigurationFile = Select a configuration file... +saveConfigurationFile = Save configuration... +selectUsageFile = Select a usage output file... +selectPrintMappingFile = Select an output mapping file... +selectApplyMappingFile = Select an input mapping file... +selectObfuscationDictionaryFile = Select an obfuscation dictionary... +selectSeedsFile = Select a seeds output file... +selectDumpFile = Select a class dump file... +selectStackTraceFile = Select a stack trace file... + +cantOpenConfigurationFile = Can''t open the configuration file [{0}] +cantParseConfigurationFile = Can''t parse the configuration file [{0}] +cantSaveConfigurationFile = Can''t save the configuration file [{0}] +cantOpenStackTraceFile = Can''t open the stack trace file [{0}] + +jarWarEarZipExtensions = *.jar, *.war, *.ear, *.zip (archives and directories) +proExtension = *.pro (ProGuard configurations) + +addJars = Add one or more jars or directories... +chooseJars = Choose different jars or directories... +enterFilter = Optionally filter the file names contained in the selected entries. + +filters = Filters +nameFilter = File name filter +jarNameFilter = Jar name filter +warNameFilter = War name filter +earNameFilter = Ear name filter +zipNameFilter = Zip name filter + +outputFileTip = The optional output file. +inputFileTip = The input file. + +nameFilterTip = A filter on plain class file names and resource file names. +jarNameFilterTip = A filter on jar file names. +warNameFilterTip = A filter on war file names. +earNameFilterTip = A filter on ear file names. +zipNameFilterTip = A filter on zip file names. + +# +# Simple button texts. +# +previous = Previous +next = Next +browse = Browse... +advanced = Advanced options +basic = Basic options +selectAll = Select all +selectNone = Select none +ok = Ok +cancel = Cancel + +add = Add... +addInput = Add input... +addOutput = Add output... +edit = Edit... +filter = Filter... +remove = Remove +moveUp = Move up +moveDown = Move down + +moveToLibraries = Move to libraries +moveToProgram = Move to program + +addField = Add field... +addMethod = Add method... + +select = Select... + +loadConfiguration = Load configuration... +viewConfiguration = View configuration +saveConfiguration = Save configuration... +loadStackTrace = Load stack trace... +process = Process! +reTrace = ReTrace! + +advancedTip = Toggle between showing basic options and advanced options. + +addInputTip = Add an input jar, war, ear, zip, or directory. +addOutputTip = Add an output jar, war, ear, zip, or directory. +addTip = Add an entry. +editTip = Edit the selected entries. +filterTip = Put filters on the contents of the selected entries. +removeTip = Remove the selected entries. +moveUpTip = Move the selected entries up in the list. +moveDownTip = Move the selected entries down in the list. + +moveToLibrariesTip = Move to selected entries to the libraries. +moveToProgramTip = Move to selected entries to the program. + +addFieldTip = Add a field to the specification. +addMethodTip = Add a method to the specification. + +loadConfigurationTip = Optionally load an initial configuration. +viewConfigurationTip = View the current configuration. +saveConfigurationTip = Save the current configuration. +loadStackTraceTip = Load a stack trace from a file. +processTip = Start processing, based on the current configuration. +reTraceTip = De-obfuscate the given stack trace. + +# +# Progress messages and error messages. +# +warning = Warning +outOfMemory = Out of memory +outOfMemoryInfo = \n\ + You should run the ProGuard GUI with a larger java heap size, \ + with a command like\ + \n\n\t\ + java -Xms128m -Xmx192m -jar proguardgui.jar {0}\ + \n\n\ + or you can try running ProGuard from the command line. \ + with a command like\ + \n\n\t\ + java -jar proguard.jar @{0} +sampleConfigurationFileName = configuration.pro +errorProcessing = Error during processing +errorReTracing = Error during retracing diff --git a/src/proguard/gui/KeepSpecificationsPanel.java b/src/proguard/gui/KeepSpecificationsPanel.java new file mode 100644 index 0000000..4c3c953 --- /dev/null +++ b/src/proguard/gui/KeepSpecificationsPanel.java @@ -0,0 +1,81 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.*; + +import javax.swing.*; + +/** + * This ListPanel allows the user to add, edit, move, and remove + * KeepClassSpecification entries in a list. + * + * @author Eric Lafortune + */ +final class KeepSpecificationsPanel extends ClassSpecificationsPanel +{ + private final boolean markClasses; + private final boolean markConditionally; + private final boolean allowShrinking; + private final boolean allowOptimization; + private final boolean allowObfuscation; + + + public KeepSpecificationsPanel(JFrame owner, + boolean markClasses, + boolean markConditionally, + boolean allowShrinking, + boolean allowOptimization, + boolean allowObfuscation) + { + super(owner, true); + + this.markClasses = markClasses; + this.markConditionally = markConditionally; + this.allowShrinking = allowShrinking; + this.allowOptimization = allowOptimization; + this.allowObfuscation = allowObfuscation; + } + + + // Factory methods for ClassSpecificationsPanel. + + protected ClassSpecification createClassSpecification() + { + return new KeepClassSpecification(markClasses, + markConditionally, + allowShrinking, + allowOptimization, + allowObfuscation); + } + + + protected void setClassSpecification(ClassSpecification classSpecification) + { + classSpecificationDialog.setKeepSpecification((KeepClassSpecification)classSpecification); + } + + + protected ClassSpecification getClassSpecification() + { + return classSpecificationDialog.getKeepSpecification(); + } +} diff --git a/src/proguard/gui/ListPanel.java b/src/proguard/gui/ListPanel.java new file mode 100644 index 0000000..0132340 --- /dev/null +++ b/src/proguard/gui/ListPanel.java @@ -0,0 +1,341 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import java.awt.*; +import java.awt.event.*; +import java.util.List; +import java.util.*; + +import javax.swing.*; +import javax.swing.event.*; + +/** + * This Jpanel allows the user to move and remove entries in a + * list and between lists. Extensions of this class should add buttons to add + * and possibly edit entries, and to set and get the resulting list. + * + * @author Eric Lafortune + */ +abstract class ListPanel extends JPanel +{ + protected final DefaultListModel listModel = new DefaultListModel(); + protected final JList list = new JList(listModel); + + protected int firstSelectionButton = 2; + + + protected ListPanel() + { + GridBagLayout layout = new GridBagLayout(); + setLayout(layout); + + GridBagConstraints listConstraints = new GridBagConstraints(); + listConstraints.gridheight = GridBagConstraints.REMAINDER; + listConstraints.fill = GridBagConstraints.BOTH; + listConstraints.weightx = 1.0; + listConstraints.weighty = 1.0; + listConstraints.anchor = GridBagConstraints.NORTHWEST; + listConstraints.insets = new Insets(0, 2, 0, 2); + + // Make sure some buttons are disabled or enabled depending on whether + // the selection is empty or not. + list.addListSelectionListener(new ListSelectionListener() + { + public void valueChanged(ListSelectionEvent e) + { + enableSelectionButtons(); + } + }); + + add(new JScrollPane(list), listConstraints); + + // something like the following calls are up to the extending class: + //addAddButton(); + //addEditButton(); + //addRemoveButton(); + //addUpButton(); + //addDownButton(); + // + //enableSelectionButtons(); + } + + + protected void addRemoveButton() + { + JButton removeButton = new JButton(msg("remove")); + removeButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + // Remove the selected elements. + removeElementsAt(list.getSelectedIndices()); + } + }); + + addButton(tip(removeButton, "removeTip")); + } + + + protected void addUpButton() + { + JButton upButton = new JButton(msg("moveUp")); + upButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + int[] selectedIndices = list.getSelectedIndices(); + if (selectedIndices.length > 0 && + selectedIndices[0] > 0) + { + // Move the selected elements up. + moveElementsAt(selectedIndices, -1); + } + } + }); + + addButton(tip(upButton, "moveUpTip")); + } + + + protected void addDownButton() + { + JButton downButton = new JButton(msg("moveDown")); + downButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + int[] selectedIndices = list.getSelectedIndices(); + if (selectedIndices.length > 0 && + selectedIndices[selectedIndices.length-1] < listModel.getSize()-1) + { + // Move the selected elements down. + moveElementsAt(selectedIndices, 1); + } + } + }); + + addButton(tip(downButton, "moveDownTip")); + } + + + /** + * Adds a button that allows to copy or move entries to another ListPanel. + * + * @param buttonTextKey the button text key. + * @param tipKey the tool tip key. + * @param panel the other ListPanel. + */ + public void addCopyToPanelButton(String buttonTextKey, + String tipKey, + final ListPanel panel) + { + JButton moveButton = new JButton(msg(buttonTextKey)); + moveButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + int[] selectedIndices = list.getSelectedIndices(); + Object[] selectedElements = list.getSelectedValues(); + + // Remove the selected elements from this panel. + removeElementsAt(selectedIndices); + + // Add the elements to the other panel. + panel.addElements(selectedElements); + } + }); + + addButton(tip(moveButton, tipKey)); + } + + + protected void addButton(JComponent button) + { + GridBagConstraints buttonConstraints = new GridBagConstraints(); + buttonConstraints.gridwidth = GridBagConstraints.REMAINDER; + buttonConstraints.fill = GridBagConstraints.HORIZONTAL; + buttonConstraints.anchor = GridBagConstraints.NORTHWEST; + buttonConstraints.insets = new Insets(0, 2, 0, 2); + + add(button, buttonConstraints); + } + + + /** + * Returns a list of all right-hand side buttons. + */ + public List getButtons() + { + List list = new ArrayList(getComponentCount()-1); + + // Add all buttons. + for (int index = 1; index < getComponentCount(); index++) + { + list.add(getComponent(index)); + } + + return list; + } + + + protected void addElement(Object element) + { + listModel.addElement(element); + + // Make sure it is selected. + list.setSelectedIndex(listModel.size() - 1); + } + + + protected void addElements(Object[] elements) + { + // Add the elements one by one. + for (int index = 0; index < elements.length; index++) + { + listModel.addElement(elements[index]); + } + + // Make sure they are selected. + int[] selectedIndices = new int[elements.length]; + for (int index = 0; index < selectedIndices.length; index++) + { + selectedIndices[index] = + listModel.size() - selectedIndices.length + index; + } + list.setSelectedIndices(selectedIndices); + } + + + protected void moveElementsAt(int[] indices, int offset) + { + // Remember the selected elements. + Object[] selectedElements = list.getSelectedValues(); + + // Remove the selected elements. + removeElementsAt(indices); + + // Update the element indices. + for (int index = 0; index < indices.length; index++) + { + indices[index] += offset; + } + + // Reinsert the selected elements. + insertElementsAt(selectedElements, indices); + } + + + protected void insertElementsAt(Object[] elements, int[] indices) + { + for (int index = 0; index < elements.length; index++) + { + listModel.insertElementAt(elements[index], indices[index]); + } + + // Make sure they are selected. + list.setSelectedIndices(indices); + } + + + protected void setElementAt(Object element, int index) + { + listModel.setElementAt(element, index); + + // Make sure it is selected. + list.setSelectedIndex(index); + } + + + protected void setElementsAt(Object[] elements, int[] indices) + { + for (int index = 0; index < elements.length; index++) + { + listModel.setElementAt(elements[index], indices[index]); + } + + // Make sure they are selected. + list.setSelectedIndices(indices); + } + + + protected void removeElementsAt(int[] indices) + { + for (int index = indices.length - 1; index >= 0; index--) + { + listModel.removeElementAt(indices[index]); + } + + // Make sure nothing is selected. + list.clearSelection(); + + // Make sure the selection buttons are properly enabled, + // since the above method doesn't seem to notify the listener. + enableSelectionButtons(); + } + + + protected void removeAllElements() + { + listModel.removeAllElements(); + + // Make sure the selection buttons are properly enabled, + // since the above method doesn't seem to notify the listener. + enableSelectionButtons(); + } + + + /** + * Enables or disables the buttons that depend on a selection. + */ + protected void enableSelectionButtons() + { + boolean selected = !list.isSelectionEmpty(); + + // Loop over all components, except the list itself and the Add button. + for (int index = firstSelectionButton; index < getComponentCount(); index++) + { + getComponent(index).setEnabled(selected); + } + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } +} diff --git a/src/proguard/gui/MANIFEST.MF b/src/proguard/gui/MANIFEST.MF new file mode 100644 index 0000000..05403b4 --- /dev/null +++ b/src/proguard/gui/MANIFEST.MF @@ -0,0 +1,3 @@ +Manifest-Version: 1.0 +Main-Class: proguard.gui.ProGuardGUI +Class-Path: proguard.jar retrace.jar diff --git a/src/proguard/gui/MemberSpecificationDialog.java b/src/proguard/gui/MemberSpecificationDialog.java new file mode 100644 index 0000000..46a3f6f --- /dev/null +++ b/src/proguard/gui/MemberSpecificationDialog.java @@ -0,0 +1,497 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.MemberSpecification; +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; +import proguard.util.ListUtil; + +import javax.swing.*; +import javax.swing.border.*; +import java.awt.*; +import java.awt.event.*; + +/** + * This JDialog allows the user to enter a String. + * + * @author Eric Lafortune + */ +final class MemberSpecificationDialog extends JDialog +{ + /** + * Return value if the dialog is canceled (with the Cancel button or by + * closing the dialog window). + */ + public static final int CANCEL_OPTION = 1; + + /** + * Return value if the dialog is approved (with the Ok button). + */ + public static final int APPROVE_OPTION = 0; + + + private final boolean isField; + + private final JRadioButton[] publicRadioButtons; + private final JRadioButton[] privateRadioButtons; + private final JRadioButton[] protectedRadioButtons; + private final JRadioButton[] staticRadioButtons; + private final JRadioButton[] finalRadioButtons; + + private JRadioButton[] volatileRadioButtons; + private JRadioButton[] transientRadioButtons; + + private JRadioButton[] synchronizedRadioButtons; + private JRadioButton[] nativeRadioButtons; + private JRadioButton[] abstractRadioButtons; + private JRadioButton[] strictRadioButtons; + + private final JTextField annotationTypeTextField = new JTextField(20); + private final JTextField nameTextField = new JTextField(20); + private final JTextField typeTextField = new JTextField(20); + private final JTextField argumentTypesTextField = new JTextField(20); + + private int returnValue; + + + public MemberSpecificationDialog(JDialog owner, boolean isField) + { + super(owner, msg(isField ? "specifyFields" : "specifyMethods"), true); + setResizable(true); + + // Create some constraints that can be reused. + GridBagConstraints constraints = new GridBagConstraints(); + constraints.anchor = GridBagConstraints.WEST; + constraints.insets = new Insets(1, 2, 1, 2); + + GridBagConstraints constraintsStretch = new GridBagConstraints(); + constraintsStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsStretch.weightx = 1.0; + constraintsStretch.anchor = GridBagConstraints.WEST; + constraintsStretch.insets = constraints.insets; + + GridBagConstraints constraintsLast = new GridBagConstraints(); + constraintsLast.gridwidth = GridBagConstraints.REMAINDER; + constraintsLast.anchor = GridBagConstraints.WEST; + constraintsLast.insets = constraints.insets; + + GridBagConstraints constraintsLastStretch = new GridBagConstraints(); + constraintsLastStretch.gridwidth = GridBagConstraints.REMAINDER; + constraintsLastStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsLastStretch.weightx = 1.0; + constraintsLastStretch.anchor = GridBagConstraints.WEST; + constraintsLastStretch.insets = constraints.insets; + + GridBagConstraints panelConstraints = new GridBagConstraints(); + panelConstraints.gridwidth = GridBagConstraints.REMAINDER; + panelConstraints.fill = GridBagConstraints.HORIZONTAL; + panelConstraints.weightx = 1.0; + panelConstraints.weighty = 0.0; + panelConstraints.anchor = GridBagConstraints.NORTHWEST; + panelConstraints.insets = constraints.insets; + + GridBagConstraints stretchPanelConstraints = new GridBagConstraints(); + stretchPanelConstraints.gridwidth = GridBagConstraints.REMAINDER; + stretchPanelConstraints.fill = GridBagConstraints.BOTH; + stretchPanelConstraints.weightx = 1.0; + stretchPanelConstraints.weighty = 1.0; + stretchPanelConstraints.anchor = GridBagConstraints.NORTHWEST; + stretchPanelConstraints.insets = constraints.insets; + + GridBagConstraints labelConstraints = new GridBagConstraints(); + labelConstraints.anchor = GridBagConstraints.CENTER; + labelConstraints.insets = new Insets(2, 10, 2, 10); + + GridBagConstraints lastLabelConstraints = new GridBagConstraints(); + lastLabelConstraints.gridwidth = GridBagConstraints.REMAINDER; + lastLabelConstraints.anchor = GridBagConstraints.CENTER; + lastLabelConstraints.insets = labelConstraints.insets; + + GridBagConstraints advancedButtonConstraints = new GridBagConstraints(); + advancedButtonConstraints.weightx = 1.0; + advancedButtonConstraints.weighty = 1.0; + advancedButtonConstraints.anchor = GridBagConstraints.SOUTHWEST; + advancedButtonConstraints.insets = new Insets(4, 4, 8, 4); + + GridBagConstraints okButtonConstraints = new GridBagConstraints(); + okButtonConstraints.weightx = 1.0; + okButtonConstraints.weighty = 1.0; + okButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + okButtonConstraints.insets = advancedButtonConstraints.insets; + + GridBagConstraints cancelButtonConstraints = new GridBagConstraints(); + cancelButtonConstraints.gridwidth = GridBagConstraints.REMAINDER; + cancelButtonConstraints.weighty = 1.0; + cancelButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + cancelButtonConstraints.insets = okButtonConstraints.insets; + + GridBagLayout layout = new GridBagLayout(); + + Border etchedBorder = BorderFactory.createEtchedBorder(EtchedBorder.RAISED); + + this.isField = isField; + + // Create the access panel. + JPanel accessPanel = new JPanel(layout); + accessPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("access"))); + + accessPanel.add(Box.createGlue(), labelConstraints); + accessPanel.add(tip(new JLabel(msg("required")), "requiredTip"), labelConstraints); + accessPanel.add(tip(new JLabel(msg("not")), "notTip"), labelConstraints); + accessPanel.add(tip(new JLabel(msg("dontCare")), "dontCareTip"), labelConstraints); + accessPanel.add(Box.createGlue(), constraintsLastStretch); + + publicRadioButtons = addRadioButtonTriplet("Public", accessPanel); + privateRadioButtons = addRadioButtonTriplet("Private", accessPanel); + protectedRadioButtons = addRadioButtonTriplet("Protected", accessPanel); + staticRadioButtons = addRadioButtonTriplet("Static", accessPanel); + finalRadioButtons = addRadioButtonTriplet("Final", accessPanel); + + if (isField) + { + volatileRadioButtons = addRadioButtonTriplet("Volatile", accessPanel); + transientRadioButtons = addRadioButtonTriplet("Transient", accessPanel); + } + else + { + synchronizedRadioButtons = addRadioButtonTriplet("Synchronized", accessPanel); + nativeRadioButtons = addRadioButtonTriplet("Native", accessPanel); + abstractRadioButtons = addRadioButtonTriplet("Abstract", accessPanel); + strictRadioButtons = addRadioButtonTriplet("Strict", accessPanel); + } + + // Create the type panel. + JPanel typePanel = new JPanel(layout); + typePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg(isField ? "fieldType" : + "returnType"))); + + typePanel.add(tip(typeTextField, "typeTip"), constraintsLastStretch); + + // Create the annotation type panel. + final JPanel annotationTypePanel = new JPanel(layout); + annotationTypePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("annotation"))); + + annotationTypePanel.add(tip(annotationTypeTextField, "classNameTip"), constraintsLastStretch); + + // Create the name panel. + JPanel namePanel = new JPanel(layout); + namePanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("name"))); + + namePanel.add(tip(nameTextField, isField ? "fieldNameTip" : + "methodNameTip"), constraintsLastStretch); + + // Create the arguments panel. + JPanel argumentsPanel = new JPanel(layout); + argumentsPanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, + msg("argumentTypes"))); + + argumentsPanel.add(tip(argumentTypesTextField, "argumentTypes2Tip"), constraintsLastStretch); + + // Create the Advanced button. + final JButton advancedButton = new JButton(msg("basic")); + advancedButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + boolean visible = !annotationTypePanel.isVisible(); + + annotationTypePanel.setVisible(visible); + + advancedButton.setText(msg(visible ? "basic" : "advanced")); + + pack(); + } + }); + advancedButton.doClick(); + + // Create the Ok button. + JButton okButton = new JButton(msg("ok")); + okButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + returnValue = APPROVE_OPTION; + hide(); + } + }); + + // Create the Cancel button. + JButton cancelButton = new JButton(msg("cancel")); + cancelButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + hide(); + } + }); + + // Add all panels to the main panel. + JPanel mainPanel = new JPanel(layout); + mainPanel.add(tip(accessPanel, "accessTip"), panelConstraints); + mainPanel.add(tip(annotationTypePanel, "annotationTip"), panelConstraints); + mainPanel.add(tip(typePanel, isField ? "fieldTypeTip" : + "returnTypeTip"), panelConstraints); + mainPanel.add(tip(namePanel, "nameTip"), panelConstraints); + + if (!isField) + { + mainPanel.add(tip(argumentsPanel, "argumentTypesTip"), panelConstraints); + } + + mainPanel.add(tip(advancedButton, "advancedTip"), advancedButtonConstraints); + mainPanel.add(okButton, okButtonConstraints); + mainPanel.add(cancelButton, cancelButtonConstraints); + + getContentPane().add(new JScrollPane(mainPanel)); + } + + + /** + * Adds a JLabel and three JRadioButton instances in a ButtonGroup to the + * given panel with a GridBagLayout, and returns the buttons in an array. + */ + private JRadioButton[] addRadioButtonTriplet(String labelText, + JPanel panel) + { + GridBagConstraints labelConstraints = new GridBagConstraints(); + labelConstraints.anchor = GridBagConstraints.WEST; + labelConstraints.insets = new Insets(2, 10, 2, 10); + + GridBagConstraints buttonConstraints = new GridBagConstraints(); + buttonConstraints.insets = labelConstraints.insets; + + GridBagConstraints lastGlueConstraints = new GridBagConstraints(); + lastGlueConstraints.gridwidth = GridBagConstraints.REMAINDER; + lastGlueConstraints.weightx = 1.0; + + // Create the radio buttons. + JRadioButton radioButton0 = new JRadioButton(); + JRadioButton radioButton1 = new JRadioButton(); + JRadioButton radioButton2 = new JRadioButton(); + + // Put them in a button group. + ButtonGroup buttonGroup = new ButtonGroup(); + buttonGroup.add(radioButton0); + buttonGroup.add(radioButton1); + buttonGroup.add(radioButton2); + + // Add the label and the buttons to the panel. + panel.add(new JLabel(labelText), labelConstraints); + panel.add(radioButton0, buttonConstraints); + panel.add(radioButton1, buttonConstraints); + panel.add(radioButton2, buttonConstraints); + panel.add(Box.createGlue(), lastGlueConstraints); + + return new JRadioButton[] + { + radioButton0, + radioButton1, + radioButton2 + }; + } + + + /** + * Sets the MemberSpecification to be represented in this dialog. + */ + public void setMemberSpecification(MemberSpecification memberSpecification) + { + String annotationType = memberSpecification.annotationType; + String name = memberSpecification.name; + String descriptor = memberSpecification.descriptor; + + // Set the class name text fields. + annotationTypeTextField.setText(annotationType == null ? "" : ClassUtil.externalType(annotationType)); + + // Set the access radio buttons. + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_PUBLIC, publicRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_PRIVATE, privateRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_PROTECTED, protectedRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_STATIC, staticRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_FINAL, finalRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_VOLATILE, volatileRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_TRANSIENT, transientRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_SYNCHRONIZED, synchronizedRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_NATIVE, nativeRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_ABSTRACT, abstractRadioButtons); + setMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_STRICT, strictRadioButtons); + + // Set the class name text fields. + nameTextField.setText(name == null ? "*" : name); + + if (isField) + { + typeTextField .setText(descriptor == null ? "***" : ClassUtil.externalType(descriptor)); + } + else + { + typeTextField .setText(descriptor == null ? "***" : ClassUtil.externalMethodReturnType(descriptor)); + argumentTypesTextField.setText(descriptor == null ? "..." : ClassUtil.externalMethodArguments(descriptor)); + } + } + + + /** + * Returns the MemberSpecification currently represented in this dialog. + */ + public MemberSpecification getMemberSpecification() + { + String annotationType = annotationTypeTextField.getText(); + String name = nameTextField.getText(); + String type = typeTextField.getText(); + String arguments = argumentTypesTextField.getText(); + + // Convert all class member specifications into the internal format. + annotationType = + annotationType.equals("") || + annotationType.equals("***") ? null : ClassUtil.internalType(annotationType); + + if (name.equals("") || + name.equals("*")) + { + name = null; + } + + if (isField) + { + type = + type.equals("") || + type.equals("***") ? null : ClassUtil.internalType(type); + } + else + { + if (type.equals("")) + { + type = ClassConstants.EXTERNAL_TYPE_VOID; + } + + type = + type .equals("***") && + arguments.equals("...") ? null : + ClassUtil.internalMethodDescriptor(type, ListUtil.commaSeparatedList(arguments)); + } + + MemberSpecification memberSpecification = + new MemberSpecification(0, 0, annotationType, name, type); + + // Also get the access radio button settings. + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_PUBLIC, publicRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_PRIVATE, privateRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_PROTECTED, protectedRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_STATIC, staticRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_FINAL, finalRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_VOLATILE, volatileRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_TRANSIENT, transientRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_SYNCHRONIZED, synchronizedRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_NATIVE, nativeRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_ABSTRACT, abstractRadioButtons); + getMemberSpecificationRadioButtons(memberSpecification, ClassConstants.INTERNAL_ACC_STRICT, strictRadioButtons); + + return memberSpecification; + } + + + /** + * Shows this dialog. This method only returns when the dialog is closed. + * + * @return CANCEL_OPTION or APPROVE_OPTION, + * depending on the choice of the user. + */ + public int showDialog() + { + returnValue = CANCEL_OPTION; + + // Open the dialog in the right place, then wait for it to be closed, + // one way or another. + pack(); + setLocationRelativeTo(getOwner()); + show(); + + return returnValue; + } + + + /** + * Sets the appropriate radio button of a given triplet, based on the access + * flags of the given keep option. + */ + private void setMemberSpecificationRadioButtons(MemberSpecification memberSpecification, + int flag, + JRadioButton[] radioButtons) + { + if (radioButtons != null) + { + int index = (memberSpecification.requiredSetAccessFlags & flag) != 0 ? 0 : + (memberSpecification.requiredUnsetAccessFlags & flag) != 0 ? 1 : + 2; + radioButtons[index].setSelected(true); + } + } + + + /** + * Updates the access flag of the given keep option, based on the given radio + * button triplet. + */ + private void getMemberSpecificationRadioButtons(MemberSpecification memberSpecification, + int flag, + JRadioButton[] radioButtons) + { + if (radioButtons != null) + { + if (radioButtons[0].isSelected()) + { + memberSpecification.requiredSetAccessFlags |= flag; + } + else if (radioButtons[1].isSelected()) + { + memberSpecification.requiredUnsetAccessFlags |= flag; + } + } + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } +} diff --git a/src/proguard/gui/MemberSpecificationsPanel.java b/src/proguard/gui/MemberSpecificationsPanel.java new file mode 100644 index 0000000..20b2f17 --- /dev/null +++ b/src/proguard/gui/MemberSpecificationsPanel.java @@ -0,0 +1,304 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.*; +import proguard.classfile.ClassConstants; +import proguard.classfile.util.ClassUtil; + +import javax.swing.*; +import java.awt.*; +import java.awt.event.*; +import java.util.*; +import java.util.List; + + +/** + * This ListPanel allows the user to add, edit, move, and remove + * MemberSpecification entries in a list. + * + * @author Eric Lafortune + */ +final class MemberSpecificationsPanel extends ListPanel +{ + private final MemberSpecificationDialog fieldSpecificationDialog; + private final MemberSpecificationDialog methodSpecificationDialog; + + + public MemberSpecificationsPanel(JDialog owner, boolean fullKeepOptions) + { + super(); + + super.firstSelectionButton = fullKeepOptions ? 3 : 2; + + list.setCellRenderer(new MyListCellRenderer()); + + fieldSpecificationDialog = new MemberSpecificationDialog(owner, true); + methodSpecificationDialog = new MemberSpecificationDialog(owner, false); + + if (fullKeepOptions) + { + addAddFieldButton(); + } + addAddMethodButton(); + addEditButton(); + addRemoveButton(); + addUpButton(); + addDownButton(); + + enableSelectionButtons(); + } + + + protected void addAddFieldButton() + { + JButton addFieldButton = new JButton(msg("addField")); + addFieldButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + fieldSpecificationDialog.setMemberSpecification(new MemberSpecification()); + int returnValue = fieldSpecificationDialog.showDialog(); + if (returnValue == MemberSpecificationDialog.APPROVE_OPTION) + { + // Add the new element. + addElement(new MyMemberSpecificationWrapper(fieldSpecificationDialog.getMemberSpecification(), + true)); + } + } + }); + + addButton(tip(addFieldButton, "addFieldTip")); + } + + + protected void addAddMethodButton() + { + JButton addMethodButton = new JButton(msg("addMethod")); + addMethodButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + methodSpecificationDialog.setMemberSpecification(new MemberSpecification()); + int returnValue = methodSpecificationDialog.showDialog(); + if (returnValue == MemberSpecificationDialog.APPROVE_OPTION) + { + // Add the new element. + addElement(new MyMemberSpecificationWrapper(methodSpecificationDialog.getMemberSpecification(), + false)); + } + } + }); + + addButton(tip(addMethodButton, "addMethodTip")); + } + + + protected void addEditButton() + { + JButton editButton = new JButton(msg("edit")); + editButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + MyMemberSpecificationWrapper wrapper = + (MyMemberSpecificationWrapper)list.getSelectedValue(); + + MemberSpecificationDialog memberSpecificationDialog = + wrapper.isField ? + fieldSpecificationDialog : + methodSpecificationDialog; + + memberSpecificationDialog.setMemberSpecification(wrapper.memberSpecification); + int returnValue = memberSpecificationDialog.showDialog(); + if (returnValue == MemberSpecificationDialog.APPROVE_OPTION) + { + // Replace the old element. + wrapper.memberSpecification = memberSpecificationDialog.getMemberSpecification(); + setElementAt(wrapper, + list.getSelectedIndex()); + } + } + }); + + addButton(tip(editButton, "editTip")); + } + + + /** + * Sets the MemberSpecification instances to be represented in this panel. + */ + public void setMemberSpecifications(List fieldSpecifications, + List methodSpecifications) + { + listModel.clear(); + + if (fieldSpecifications != null) + { + for (int index = 0; index < fieldSpecifications.size(); index++) + { + listModel.addElement( + new MyMemberSpecificationWrapper((MemberSpecification)fieldSpecifications.get(index), + true)); + } + } + + if (methodSpecifications != null) + { + for (int index = 0; index < methodSpecifications.size(); index++) + { + listModel.addElement( + new MyMemberSpecificationWrapper((MemberSpecification)methodSpecifications.get(index), + false)); + } + } + + // Make sure the selection buttons are properly enabled, + // since the clear method doesn't seem to notify the listener. + enableSelectionButtons(); + } + + + /** + * Returns the MemberSpecification instances currently represented in + * this panel, referring to fields or to methods. + * + * @param isField specifies whether specifications referring to fields or + * specifications referring to methods should be returned. + */ + public List getMemberSpecifications(boolean isField) + { + int size = listModel.size(); + if (size == 0) + { + return null; + } + + List memberSpecifications = new ArrayList(size); + for (int index = 0; index < size; index++) + { + MyMemberSpecificationWrapper wrapper = + (MyMemberSpecificationWrapper)listModel.get(index); + + if (wrapper.isField == isField) + { + memberSpecifications.add(wrapper.memberSpecification); + } + } + + return memberSpecifications; + } + + + /** + * This ListCellRenderer renders MemberSpecification objects. + */ + private static class MyListCellRenderer implements ListCellRenderer + { + private final JLabel label = new JLabel(); + + + // Implementations for ListCellRenderer. + + public Component getListCellRendererComponent(JList list, + Object value, + int index, + boolean isSelected, + boolean cellHasFocus) + { + MyMemberSpecificationWrapper wrapper = (MyMemberSpecificationWrapper)value; + + MemberSpecification option = wrapper.memberSpecification; + String name = option.name; + String descriptor = option.descriptor; + + label.setText(wrapper.isField ? + (descriptor == null ? name == null ? + "" : + "***" + ' ' + name : + ClassUtil.externalFullFieldDescription(0, + name == null ? "*" : name, + descriptor)) : + (descriptor == null ? name == null ? + "" : + "***" + ' ' + name + "(...)" : + ClassUtil.externalFullMethodDescription(ClassConstants.INTERNAL_METHOD_NAME_INIT, + 0, + name == null ? "*" : name, + descriptor))); + + if (isSelected) + { + label.setBackground(list.getSelectionBackground()); + label.setForeground(list.getSelectionForeground()); + } + else + { + label.setBackground(list.getBackground()); + label.setForeground(list.getForeground()); + } + + label.setOpaque(true); + + return label; + } + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } + + + /** + * This class wraps a MemberSpecification, additionally storing whether + * the option refers to a field or to a method. + */ + private static class MyMemberSpecificationWrapper + { + public MemberSpecification memberSpecification; + public final boolean isField; + + public MyMemberSpecificationWrapper(MemberSpecification memberSpecification, + boolean isField) + { + this.memberSpecification = memberSpecification; + this.isField = isField; + } + } +} diff --git a/src/proguard/gui/MessageDialogRunnable.java b/src/proguard/gui/MessageDialogRunnable.java new file mode 100644 index 0000000..e58f1c6 --- /dev/null +++ b/src/proguard/gui/MessageDialogRunnable.java @@ -0,0 +1,90 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import javax.swing.*; +import java.awt.*; +import java.lang.reflect.InvocationTargetException; + + +/** + * This Runnable can show a message dialog. + * + * @author Eric Lafortune + */ +final class MessageDialogRunnable implements Runnable +{ + private final Component parentComponent; + private final Object message; + private final String title; + private final int messageType; + + + /** + * Creates a new MessageDialogRunnable object. + * @see JOptionPane#showMessageDialog(Component, Object, String, int) + */ + public static void showMessageDialog(Component parentComponent, + Object message, + String title, + int messageType) + { + try + { + SwingUtil.invokeAndWait(new MessageDialogRunnable(parentComponent, + message, + title, + messageType)); + } + catch (Exception e) + { + // Nothing. + } + } + + + /** + * Creates a new MessageDialogRunnable object. + * @see JOptionPane#showMessageDialog(Component, Object, String, int) + */ + public MessageDialogRunnable(Component parentComponent, + Object message, + String title, + int messageType) + { + this.parentComponent = parentComponent; + this.message = message; + this.title = title; + this.messageType = messageType; + } + + + + // Implementation for Runnable. + + public void run() + { + JOptionPane.showMessageDialog(parentComponent, + message, + title, + messageType); + } +} diff --git a/src/proguard/gui/OptimizationsDialog.java b/src/proguard/gui/OptimizationsDialog.java new file mode 100644 index 0000000..044c338 --- /dev/null +++ b/src/proguard/gui/OptimizationsDialog.java @@ -0,0 +1,251 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.optimize.Optimizer; +import proguard.util.*; + +import javax.swing.*; +import javax.swing.border.*; +import java.awt.*; +import java.awt.event.*; + +/** + * This JDialog allows the user to enter a String. + * + * @author Eric Lafortune + */ +final class OptimizationsDialog extends JDialog +{ + /** + * Return value if the dialog is canceled (with the Cancel button or by + * closing the dialog window). + */ + public static final int CANCEL_OPTION = 1; + + /** + * Return value if the dialog is approved (with the Ok button). + */ + public static final int APPROVE_OPTION = 0; + + + private final JCheckBox[] optimizationCheckBoxes = new JCheckBox[Optimizer.OPTIMIZATION_NAMES.length]; + + private int returnValue; + + + public OptimizationsDialog(JFrame owner) + { + super(owner, msg("selectOptimizations"), true); + setResizable(true); + + // Create some constraints that can be reused. + GridBagConstraints constraintsLast = new GridBagConstraints(); + constraintsLast.gridwidth = GridBagConstraints.REMAINDER; + constraintsLast.anchor = GridBagConstraints.WEST; + constraintsLast.insets = new Insets(1, 2, 1, 2); + + GridBagConstraints constraintsLastStretch = new GridBagConstraints(); + constraintsLastStretch.gridwidth = GridBagConstraints.REMAINDER; + constraintsLastStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsLastStretch.weightx = 1.0; + constraintsLastStretch.anchor = GridBagConstraints.WEST; + constraintsLastStretch.insets = constraintsLast.insets; + + GridBagConstraints panelConstraints = new GridBagConstraints(); + panelConstraints.gridwidth = GridBagConstraints.REMAINDER; + panelConstraints.fill = GridBagConstraints.HORIZONTAL; + panelConstraints.weightx = 1.0; + panelConstraints.weighty = 0.0; + panelConstraints.anchor = GridBagConstraints.NORTHWEST; + panelConstraints.insets = constraintsLast.insets; + + GridBagConstraints selectButtonConstraints = new GridBagConstraints(); + selectButtonConstraints.weighty = 1.0; + selectButtonConstraints.anchor = GridBagConstraints.SOUTHWEST; + selectButtonConstraints.insets = new Insets(4, 4, 8, 4); + + GridBagConstraints okButtonConstraints = new GridBagConstraints(); + okButtonConstraints.weightx = 1.0; + okButtonConstraints.weighty = 1.0; + okButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + okButtonConstraints.insets = selectButtonConstraints.insets; + + GridBagConstraints cancelButtonConstraints = new GridBagConstraints(); + cancelButtonConstraints.gridwidth = GridBagConstraints.REMAINDER; + cancelButtonConstraints.weighty = 1.0; + cancelButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + cancelButtonConstraints.insets = selectButtonConstraints.insets; + + GridBagLayout layout = new GridBagLayout(); + + Border etchedBorder = BorderFactory.createEtchedBorder(EtchedBorder.RAISED); + + // Create the optimizations panel. + JPanel optimizationsPanel = new JPanel(layout); + JPanel optimizationSubpanel = null; + String lastOptimizationPrefix = null; + + for (int index = 0; index < Optimizer.OPTIMIZATION_NAMES.length; index++) + { + String optimizationName = Optimizer.OPTIMIZATION_NAMES[index]; + + String optimizationPrefix = optimizationName.substring(0, optimizationName.indexOf('/')); + + if (optimizationSubpanel == null || !optimizationPrefix.equals(lastOptimizationPrefix)) + { + // Create a new keep subpanel and add it. + optimizationSubpanel = new JPanel(layout); + optimizationSubpanel.setBorder(BorderFactory.createTitledBorder(etchedBorder, msg(optimizationPrefix))); + optimizationsPanel.add(optimizationSubpanel, panelConstraints); + + lastOptimizationPrefix = optimizationPrefix; + } + + JCheckBox optimizationCheckBox = new JCheckBox(optimizationName); + optimizationCheckBoxes[index] = optimizationCheckBox; + + optimizationSubpanel.add(tip(optimizationCheckBox, optimizationName.replace('/', '_')+"Tip"), constraintsLastStretch); + } + + // Create the Select All button. + JButton selectAllButton = new JButton(msg("selectAll")); + selectAllButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + for (int index = 0; index < optimizationCheckBoxes.length; index++) + { + optimizationCheckBoxes[index].setSelected(true); + } + } + }); + + // Create the Select All button. + JButton selectNoneButton = new JButton(msg("selectNone")); + selectNoneButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + for (int index = 0; index < optimizationCheckBoxes.length; index++) + { + optimizationCheckBoxes[index].setSelected(false); + } + } + }); + + // Create the Ok button. + JButton okButton = new JButton(msg("ok")); + okButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + returnValue = APPROVE_OPTION; + hide(); + } + }); + + // Create the Cancel button. + JButton cancelButton = new JButton(msg("cancel")); + cancelButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + hide(); + } + }); + + // Add all panels to the main panel. + optimizationsPanel.add(selectAllButton, selectButtonConstraints); + optimizationsPanel.add(selectNoneButton, selectButtonConstraints); + optimizationsPanel.add(okButton, okButtonConstraints); + optimizationsPanel.add(cancelButton, cancelButtonConstraints); + + getContentPane().add(new JScrollPane(optimizationsPanel)); + } + + + /** + * Sets the initial optimization filter to be used by the dialog. + */ + public void setFilter(String optimizations) + { + StringMatcher filter = optimizations != null && optimizations.length() > 0 ? + new ListParser(new NameParser()).parse(optimizations) : + new FixedStringMatcher(""); + + for (int index = 0; index < Optimizer.OPTIMIZATION_NAMES.length; index++) + { + optimizationCheckBoxes[index].setSelected(filter.matches(Optimizer.OPTIMIZATION_NAMES[index])); + } + } + + + /** + * Returns the optimization filter composed from the settings in the dialog. + */ + public String getFilter() + { + return new FilterBuilder(optimizationCheckBoxes, '/').buildFilter(); + } + + + /** + * Shows this dialog. This method only returns when the dialog is closed. + * + * @return CANCEL_OPTION or APPROVE_OPTION, + * depending on the choice of the user. + */ + public int showDialog() + { + returnValue = CANCEL_OPTION; + + // Open the dialog in the right place, then wait for it to be closed, + // one way or another. + pack(); + setLocationRelativeTo(getOwner()); + show(); + + return returnValue; + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } +} \ No newline at end of file diff --git a/src/proguard/gui/ProGuardGUI.java b/src/proguard/gui/ProGuardGUI.java new file mode 100644 index 0000000..f27d698 --- /dev/null +++ b/src/proguard/gui/ProGuardGUI.java @@ -0,0 +1,1738 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.*; +import proguard.classfile.util.ClassUtil; +import proguard.gui.splash.*; +import proguard.util.ListUtil; + +import javax.swing.*; +import javax.swing.border.*; +import java.awt.*; +import java.awt.event.*; +import java.io.*; +import java.net.URL; +import java.util.*; +import java.util.List; +import java.lang.reflect.InvocationTargetException; + + +/** + * GUI for configuring and executing ProGuard and ReTrace. + * + * @author Eric Lafortune + */ +public class ProGuardGUI extends JFrame +{ + private static final String NO_SPLASH_OPTION = "-nosplash"; + + private static final String TITLE_IMAGE_FILE = "vtitle.png"; + private static final String BOILERPLATE_CONFIGURATION = "boilerplate.pro"; + private static final String DEFAULT_CONFIGURATION = "default.pro"; + + private static final String OPTIMIZATIONS_DEFAULT = "*"; + private static final String KEEP_ATTRIBUTE_DEFAULT = "Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,LocalVariable*Table,*Annotation*,Synthetic,EnclosingMethod"; + private static final String SOURCE_FILE_ATTRIBUTE_DEFAULT = "SourceFile"; + private static final String ADAPT_RESOURCE_FILE_NAMES_DEFAULT = "**.properties"; + private static final String ADAPT_RESOURCE_FILE_CONTENTS_DEFAULT = "**.properties,META-INF/MANIFEST.MF"; + + private static final Border BORDER = BorderFactory.createEtchedBorder(EtchedBorder.RAISED); + + static boolean systemOutRedirected; + + private final JFileChooser configurationChooser = new JFileChooser(""); + private final JFileChooser fileChooser = new JFileChooser(""); + + private final SplashPanel splashPanel; + + private final ClassPathPanel programPanel = new ClassPathPanel(this, true); + private final ClassPathPanel libraryPanel = new ClassPathPanel(this, false); + + private KeepClassSpecification[] boilerplateKeep; + private final JCheckBox[] boilerplateKeepCheckBoxes; + private final JTextField[] boilerplateKeepTextFields; + + private final KeepSpecificationsPanel additionalKeepPanel = new KeepSpecificationsPanel(this, true, false, false, false, false); + + private KeepClassSpecification[] boilerplateKeepNames; + private final JCheckBox[] boilerplateKeepNamesCheckBoxes; + private final JTextField[] boilerplateKeepNamesTextFields; + + private final KeepSpecificationsPanel additionalKeepNamesPanel = new KeepSpecificationsPanel(this, true, false, true, false, false); + + private ClassSpecification[] boilerplateNoSideEffectMethods; + private final JCheckBox[] boilerplateNoSideEffectMethodCheckBoxes; + + private final ClassSpecificationsPanel additionalNoSideEffectsPanel = new ClassSpecificationsPanel(this, false); + + private final ClassSpecificationsPanel whyAreYouKeepingPanel = new ClassSpecificationsPanel(this, false); + + private final JCheckBox shrinkCheckBox = new JCheckBox(msg("shrink")); + private final JCheckBox printUsageCheckBox = new JCheckBox(msg("printUsage")); + + private final JCheckBox optimizeCheckBox = new JCheckBox(msg("optimize")); + private final JCheckBox allowAccessModificationCheckBox = new JCheckBox(msg("allowAccessModification")); + private final JCheckBox mergeInterfacesAggressivelyCheckBox = new JCheckBox(msg("mergeInterfacesAggressively")); + private final JLabel optimizationsLabel = new JLabel(msg("optimizations")); + private final JLabel optimizationPassesLabel = new JLabel(msg("optimizationPasses")); + + private final JSpinner optimizationPassesSpinner = new JSpinner(new SpinnerNumberModel(1, 1, 9, 1)); + + private final JCheckBox obfuscateCheckBox = new JCheckBox(msg("obfuscate")); + private final JCheckBox printMappingCheckBox = new JCheckBox(msg("printMapping")); + private final JCheckBox applyMappingCheckBox = new JCheckBox(msg("applyMapping")); + private final JCheckBox obfuscationDictionaryCheckBox = new JCheckBox(msg("obfuscationDictionary")); + private final JCheckBox classObfuscationDictionaryCheckBox = new JCheckBox(msg("classObfuscationDictionary")); + private final JCheckBox packageObfuscationDictionaryCheckBox = new JCheckBox(msg("packageObfuscationDictionary")); + private final JCheckBox overloadAggressivelyCheckBox = new JCheckBox(msg("overloadAggressively")); + private final JCheckBox useUniqueClassMemberNamesCheckBox = new JCheckBox(msg("useUniqueClassMemberNames")); + private final JCheckBox useMixedCaseClassNamesCheckBox = new JCheckBox(msg("useMixedCaseClassNames")); + private final JCheckBox keepPackageNamesCheckBox = new JCheckBox(msg("keepPackageNames")); + private final JCheckBox flattenPackageHierarchyCheckBox = new JCheckBox(msg("flattenPackageHierarchy")); + private final JCheckBox repackageClassesCheckBox = new JCheckBox(msg("repackageClasses")); + private final JCheckBox keepAttributesCheckBox = new JCheckBox(msg("keepAttributes")); + private final JCheckBox newSourceFileAttributeCheckBox = new JCheckBox(msg("renameSourceFileAttribute")); + private final JCheckBox adaptClassStringsCheckBox = new JCheckBox(msg("adaptClassStrings")); + private final JCheckBox adaptResourceFileNamesCheckBox = new JCheckBox(msg("adaptResourceFileNames")); + private final JCheckBox adaptResourceFileContentsCheckBox = new JCheckBox(msg("adaptResourceFileContents")); + + private final JCheckBox preverifyCheckBox = new JCheckBox(msg("preverify")); + private final JCheckBox microEditionCheckBox = new JCheckBox(msg("microEdition")); + private final JCheckBox targetCheckBox = new JCheckBox(msg("target")); + + private final JComboBox targetComboBox = new JComboBox(ListUtil.commaSeparatedList(msg("targets")).toArray()); + + private final JCheckBox verboseCheckBox = new JCheckBox(msg("verbose")); + private final JCheckBox noteCheckBox = new JCheckBox(msg("note")); + private final JCheckBox warnCheckBox = new JCheckBox(msg("warn")); + private final JCheckBox ignoreWarningsCheckBox = new JCheckBox(msg("ignoreWarnings")); + private final JCheckBox skipNonPublicLibraryClassesCheckBox = new JCheckBox(msg("skipNonPublicLibraryClasses")); + private final JCheckBox skipNonPublicLibraryClassMembersCheckBox = new JCheckBox(msg("skipNonPublicLibraryClassMembers")); + private final JCheckBox keepDirectoriesCheckBox = new JCheckBox(msg("keepDirectories")); + private final JCheckBox forceProcessingCheckBox = new JCheckBox(msg("forceProcessing")); + private final JCheckBox printSeedsCheckBox = new JCheckBox(msg("printSeeds")); + private final JCheckBox printConfigurationCheckBox = new JCheckBox(msg("printConfiguration")); + private final JCheckBox dumpCheckBox = new JCheckBox(msg("dump")); + + private final JTextField printUsageTextField = new JTextField(40); + private final JTextField optimizationsTextField = new JTextField(40); + private final JTextField printMappingTextField = new JTextField(40); + private final JTextField applyMappingTextField = new JTextField(40); + private final JTextField obfuscationDictionaryTextField = new JTextField(40); + private final JTextField classObfuscationDictionaryTextField = new JTextField(40); + private final JTextField packageObfuscationDictionaryTextField = new JTextField(40); + private final JTextField keepPackageNamesTextField = new JTextField(40); + private final JTextField flattenPackageHierarchyTextField = new JTextField(40); + private final JTextField repackageClassesTextField = new JTextField(40); + private final JTextField keepAttributesTextField = new JTextField(40); + private final JTextField newSourceFileAttributeTextField = new JTextField(40); + private final JTextField adaptClassStringsTextField = new JTextField(40); + private final JTextField adaptResourceFileNamesTextField = new JTextField(40); + private final JTextField adaptResourceFileContentsTextField = new JTextField(40); + private final JTextField noteTextField = new JTextField(40); + private final JTextField warnTextField = new JTextField(40); + private final JTextField keepDirectoriesTextField = new JTextField(40); + private final JTextField printSeedsTextField = new JTextField(40); + private final JTextField printConfigurationTextField = new JTextField(40); + private final JTextField dumpTextField = new JTextField(40); + + private final JTextArea consoleTextArea = new JTextArea(msg("processingInfo"), 3, 40); + + private final JCheckBox reTraceVerboseCheckBox = new JCheckBox(msg("verbose")); + private final JTextField reTraceMappingTextField = new JTextField(40); + private final JTextArea stackTraceTextArea = new JTextArea(3, 40); + private final JTextArea reTraceTextArea = new JTextArea(msg("reTraceInfo"), 3, 40); + + + /** + * Creates a new ProGuardGUI. + */ + public ProGuardGUI() + { + setTitle("ProGuard"); + setDefaultCloseOperation(EXIT_ON_CLOSE); + + // Create some constraints that can be reused. + GridBagConstraints constraints = new GridBagConstraints(); + constraints.anchor = GridBagConstraints.WEST; + constraints.insets = new Insets(0, 4, 0, 4); + + GridBagConstraints constraintsStretch = new GridBagConstraints(); + constraintsStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsStretch.weightx = 1.0; + constraintsStretch.anchor = GridBagConstraints.WEST; + constraintsStretch.insets = constraints.insets; + + GridBagConstraints constraintsLast = new GridBagConstraints(); + constraintsLast.gridwidth = GridBagConstraints.REMAINDER; + constraintsLast.anchor = GridBagConstraints.WEST; + constraintsLast.insets = constraints.insets; + + GridBagConstraints constraintsLastStretch = new GridBagConstraints(); + constraintsLastStretch.gridwidth = GridBagConstraints.REMAINDER; + constraintsLastStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsLastStretch.weightx = 1.0; + constraintsLastStretch.anchor = GridBagConstraints.WEST; + constraintsLastStretch.insets = constraints.insets; + + GridBagConstraints splashPanelConstraints = new GridBagConstraints(); + splashPanelConstraints.gridwidth = GridBagConstraints.REMAINDER; + splashPanelConstraints.fill = GridBagConstraints.BOTH; + splashPanelConstraints.weightx = 1.0; + splashPanelConstraints.weighty = 0.02; + splashPanelConstraints.anchor = GridBagConstraints.NORTHWEST; + //splashPanelConstraints.insets = constraints.insets; + + GridBagConstraints welcomeTextAreaConstraints = new GridBagConstraints(); + welcomeTextAreaConstraints.gridwidth = GridBagConstraints.REMAINDER; + welcomeTextAreaConstraints.fill = GridBagConstraints.NONE; + welcomeTextAreaConstraints.weightx = 1.0; + welcomeTextAreaConstraints.weighty = 0.01; + welcomeTextAreaConstraints.anchor = GridBagConstraints.CENTER;//NORTHWEST; + welcomeTextAreaConstraints.insets = new Insets(20, 40, 20, 40); + + GridBagConstraints panelConstraints = new GridBagConstraints(); + panelConstraints.gridwidth = GridBagConstraints.REMAINDER; + panelConstraints.fill = GridBagConstraints.HORIZONTAL; + panelConstraints.weightx = 1.0; + panelConstraints.anchor = GridBagConstraints.NORTHWEST; + panelConstraints.insets = constraints.insets; + + GridBagConstraints stretchPanelConstraints = new GridBagConstraints(); + stretchPanelConstraints.gridwidth = GridBagConstraints.REMAINDER; + stretchPanelConstraints.fill = GridBagConstraints.BOTH; + stretchPanelConstraints.weightx = 1.0; + stretchPanelConstraints.weighty = 1.0; + stretchPanelConstraints.anchor = GridBagConstraints.NORTHWEST; + stretchPanelConstraints.insets = constraints.insets; + + GridBagConstraints glueConstraints = new GridBagConstraints(); + glueConstraints.fill = GridBagConstraints.BOTH; + glueConstraints.weightx = 0.01; + glueConstraints.weighty = 0.01; + glueConstraints.anchor = GridBagConstraints.NORTHWEST; + glueConstraints.insets = constraints.insets; + + GridBagConstraints bottomButtonConstraints = new GridBagConstraints(); + bottomButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + bottomButtonConstraints.insets = new Insets(2, 2, 4, 6); + bottomButtonConstraints.ipadx = 10; + bottomButtonConstraints.ipady = 2; + + GridBagConstraints lastBottomButtonConstraints = new GridBagConstraints(); + lastBottomButtonConstraints.gridwidth = GridBagConstraints.REMAINDER; + lastBottomButtonConstraints.anchor = GridBagConstraints.SOUTHEAST; + lastBottomButtonConstraints.insets = bottomButtonConstraints.insets; + lastBottomButtonConstraints.ipadx = bottomButtonConstraints.ipadx; + lastBottomButtonConstraints.ipady = bottomButtonConstraints.ipady; + + // Leave room for a growBox on Mac OS X. + if (System.getProperty("os.name").toLowerCase().startsWith("mac os x")) + { + lastBottomButtonConstraints.insets = new Insets(2, 2, 4, 6 + 16); + } + + GridBagLayout layout = new GridBagLayout(); + + configurationChooser.addChoosableFileFilter( + new ExtensionFileFilter(msg("proExtension"), new String[] { ".pro" })); + + // Create the opening panel. + Sprite splash = + new CompositeSprite(new Sprite[] + { + new ColorSprite(new ConstantColor(Color.gray), + new FontSprite(new ConstantFont(new Font("sansserif", Font.BOLD, 90)), + new TextSprite(new ConstantString("ProGuard"), + new ConstantInt(160), + new LinearInt(-10, 120, new SmoothTiming(500, 1000))))), + + new ColorSprite(new ConstantColor(Color.white), + new FontSprite(new ConstantFont(new Font("sansserif", Font.BOLD, 45)), + new ShadowedSprite(new ConstantInt(3), + new ConstantInt(3), + new ConstantDouble(0.4), + new ConstantInt(1), + new CompositeSprite(new Sprite[] + { + new TextSprite(new ConstantString(msg("shrinking")), + new LinearInt(1000, 60, new SmoothTiming(1000, 2000)), + new ConstantInt(70)), + new TextSprite(new ConstantString(msg("optimization")), + new LinearInt(1000, 400, new SmoothTiming(1500, 2500)), + new ConstantInt(60)), + new TextSprite(new ConstantString(msg("obfuscation")), + new LinearInt(1000, 10, new SmoothTiming(2000, 3000)), + new ConstantInt(145)), + new TextSprite(new ConstantString(msg("preverification")), + new LinearInt(1000, 350, new SmoothTiming(2500, 3500)), + new ConstantInt(140)), + new FontSprite(new ConstantFont(new Font("sansserif", Font.BOLD, 30)), + new TextSprite(new TypeWriterString(msg("developed"), new LinearTiming(3500, 5500)), + new ConstantInt(250), + new ConstantInt(200))), + })))), + }); + splashPanel = new SplashPanel(splash, 0.5, 5500L); + splashPanel.setPreferredSize(new Dimension(0, 200)); + + JTextArea welcomeTextArea = new JTextArea(msg("proGuardInfo"), 18, 50); + welcomeTextArea.setOpaque(false); + welcomeTextArea.setEditable(false); + welcomeTextArea.setLineWrap(true); + welcomeTextArea.setWrapStyleWord(true); + welcomeTextArea.setPreferredSize(new Dimension(0, 0)); + welcomeTextArea.setBorder(new EmptyBorder(20, 20, 20, 20)); + addBorder(welcomeTextArea, "welcome"); + + JPanel proGuardPanel = new JPanel(layout); + proGuardPanel.add(splashPanel, splashPanelConstraints); + proGuardPanel.add(welcomeTextArea, welcomeTextAreaConstraints); + + // Create the input panel. + // TODO: properly clone the ClassPath objects. + // This is awkward to implement in the generic ListPanel.addElements(...) + // method, since the Object.clone() method is not public. + programPanel.addCopyToPanelButton("moveToLibraries", "moveToLibrariesTip", libraryPanel); + libraryPanel.addCopyToPanelButton("moveToProgram", "moveToProgramTip", programPanel); + + // Collect all buttons of these panels and make sure they are equally + // sized. + List panelButtons = new ArrayList(); + panelButtons.addAll(programPanel.getButtons()); + panelButtons.addAll(libraryPanel.getButtons()); + setCommonPreferredSize(panelButtons); + + addBorder(programPanel, "programJars" ); + addBorder(libraryPanel, "libraryJars" ); + + JPanel inputOutputPanel = new JPanel(layout); + inputOutputPanel.add(tip(programPanel, "programJarsTip"), stretchPanelConstraints); + inputOutputPanel.add(tip(libraryPanel, "libraryJarsTip"), stretchPanelConstraints); + + // Load the boiler plate options. + loadBoilerplateConfiguration(); + + // Create the boiler plate keep panels. + boilerplateKeepCheckBoxes = new JCheckBox[boilerplateKeep.length]; + boilerplateKeepTextFields = new JTextField[boilerplateKeep.length]; + + JButton printUsageBrowseButton = createBrowseButton(printUsageTextField, + msg("selectUsageFile")); + + JPanel shrinkingOptionsPanel = new JPanel(layout); + addBorder(shrinkingOptionsPanel, "options"); + + shrinkingOptionsPanel.add(tip(shrinkCheckBox, "shrinkTip"), constraintsLastStretch); + shrinkingOptionsPanel.add(tip(printUsageCheckBox, "printUsageTip"), constraints); + shrinkingOptionsPanel.add(tip(printUsageTextField, "outputFileTip"), constraintsStretch); + shrinkingOptionsPanel.add(tip(printUsageBrowseButton, "selectUsageFile"), constraintsLast); + + JPanel shrinkingPanel = new JPanel(layout); + + shrinkingPanel.add(shrinkingOptionsPanel, panelConstraints); + addClassSpecifications(extractClassSpecifications(boilerplateKeep), + shrinkingPanel, + boilerplateKeepCheckBoxes, + boilerplateKeepTextFields); + + addBorder(additionalKeepPanel, "keepAdditional"); + shrinkingPanel.add(tip(additionalKeepPanel, "keepAdditionalTip"), stretchPanelConstraints); + + // Create the boiler plate keep names panels. + boilerplateKeepNamesCheckBoxes = new JCheckBox[boilerplateKeepNames.length]; + boilerplateKeepNamesTextFields = new JTextField[boilerplateKeepNames.length]; + + JButton printMappingBrowseButton = createBrowseButton(printMappingTextField, + msg("selectPrintMappingFile")); + JButton applyMappingBrowseButton = createBrowseButton(applyMappingTextField, + msg("selectApplyMappingFile")); + JButton obfucationDictionaryBrowseButton = createBrowseButton(obfuscationDictionaryTextField, + msg("selectObfuscationDictionaryFile")); + JButton classObfucationDictionaryBrowseButton = createBrowseButton(classObfuscationDictionaryTextField, + msg("selectObfuscationDictionaryFile")); + JButton packageObfucationDictionaryBrowseButton = createBrowseButton(packageObfuscationDictionaryTextField, + msg("selectObfuscationDictionaryFile")); + + JPanel obfuscationOptionsPanel = new JPanel(layout); + addBorder(obfuscationOptionsPanel, "options"); + + obfuscationOptionsPanel.add(tip(obfuscateCheckBox, "obfuscateTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(printMappingCheckBox, "printMappingTip"), constraints); + obfuscationOptionsPanel.add(tip(printMappingTextField, "outputFileTip"), constraintsStretch); + obfuscationOptionsPanel.add(tip(printMappingBrowseButton, "selectPrintMappingFile"), constraintsLast); + obfuscationOptionsPanel.add(tip(applyMappingCheckBox, "applyMappingTip"), constraints); + obfuscationOptionsPanel.add(tip(applyMappingTextField, "inputFileTip"), constraintsStretch); + obfuscationOptionsPanel.add(tip(applyMappingBrowseButton, "selectApplyMappingFile"), constraintsLast); + obfuscationOptionsPanel.add(tip(obfuscationDictionaryCheckBox, "obfuscationDictionaryTip"), constraints); + obfuscationOptionsPanel.add(tip(obfuscationDictionaryTextField, "inputFileTip"), constraintsStretch); + obfuscationOptionsPanel.add(tip(obfucationDictionaryBrowseButton, "selectObfuscationDictionaryFile"), constraintsLast); + obfuscationOptionsPanel.add(tip(classObfuscationDictionaryCheckBox, "classObfuscationDictionaryTip"), constraints); + obfuscationOptionsPanel.add(tip(classObfuscationDictionaryTextField, "inputFileTip"), constraintsStretch); + obfuscationOptionsPanel.add(tip(classObfucationDictionaryBrowseButton, "selectObfuscationDictionaryFile"), constraintsLast); + obfuscationOptionsPanel.add(tip(packageObfuscationDictionaryCheckBox, "packageObfuscationDictionaryTip"), constraints); + obfuscationOptionsPanel.add(tip(packageObfuscationDictionaryTextField, "inputFileTip"), constraintsStretch); + obfuscationOptionsPanel.add(tip(packageObfucationDictionaryBrowseButton, "selectObfuscationDictionaryFile"), constraintsLast); + obfuscationOptionsPanel.add(tip(overloadAggressivelyCheckBox, "overloadAggressivelyTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(useUniqueClassMemberNamesCheckBox, "useUniqueClassMemberNamesTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(useMixedCaseClassNamesCheckBox, "useMixedCaseClassNamesTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(keepPackageNamesCheckBox, "keepPackageNamesTip"), constraints); + obfuscationOptionsPanel.add(tip(keepPackageNamesTextField, "packageNamesTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(flattenPackageHierarchyCheckBox, "flattenPackageHierarchyTip"), constraints); + obfuscationOptionsPanel.add(tip(flattenPackageHierarchyTextField, "packageTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(repackageClassesCheckBox, "repackageClassesTip"), constraints); + obfuscationOptionsPanel.add(tip(repackageClassesTextField, "packageTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(keepAttributesCheckBox, "keepAttributesTip"), constraints); + obfuscationOptionsPanel.add(tip(keepAttributesTextField, "attributesTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(newSourceFileAttributeCheckBox, "renameSourceFileAttributeTip"), constraints); + obfuscationOptionsPanel.add(tip(newSourceFileAttributeTextField, "sourceFileAttributeTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(adaptClassStringsCheckBox, "adaptClassStringsTip"), constraints); + obfuscationOptionsPanel.add(tip(adaptClassStringsTextField, "classNamesTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(adaptResourceFileNamesCheckBox, "adaptResourceFileNamesTip"), constraints); + obfuscationOptionsPanel.add(tip(adaptResourceFileNamesTextField, "fileNameFilterTip"), constraintsLastStretch); + obfuscationOptionsPanel.add(tip(adaptResourceFileContentsCheckBox, "adaptResourceFileContentsTip"), constraints); + obfuscationOptionsPanel.add(tip(adaptResourceFileContentsTextField, "fileNameFilterTip"), constraintsLastStretch); + + JPanel obfuscationPanel = new JPanel(layout); + + obfuscationPanel.add(obfuscationOptionsPanel, panelConstraints); + addClassSpecifications(extractClassSpecifications(boilerplateKeepNames), + obfuscationPanel, + boilerplateKeepNamesCheckBoxes, + boilerplateKeepNamesTextFields); + + addBorder(additionalKeepNamesPanel, "keepNamesAdditional"); + obfuscationPanel.add(tip(additionalKeepNamesPanel, "keepNamesAdditionalTip"), stretchPanelConstraints); + + // Create the boiler plate "no side effect methods" panels. + boilerplateNoSideEffectMethodCheckBoxes = new JCheckBox[boilerplateNoSideEffectMethods.length]; + + JPanel optimizationOptionsPanel = new JPanel(layout); + addBorder(optimizationOptionsPanel, "options"); + + JButton optimizationsButton = + createOptimizationsButton(optimizationsTextField); + + optimizationOptionsPanel.add(tip(optimizeCheckBox, "optimizeTip"), constraintsLastStretch); + optimizationOptionsPanel.add(tip(allowAccessModificationCheckBox, "allowAccessModificationTip"), constraintsLastStretch); + optimizationOptionsPanel.add(tip(mergeInterfacesAggressivelyCheckBox, "mergeInterfacesAggressivelyTip"), constraintsLastStretch); + optimizationOptionsPanel.add(tip(optimizationsLabel, "optimizationsTip"), constraints); + optimizationOptionsPanel.add(tip(optimizationsTextField, "optimizationsFilterTip"), constraintsStretch); + optimizationOptionsPanel.add(tip(optimizationsButton, "optimizationsSelectTip"), constraintsLast); + optimizationOptionsPanel.add(tip(optimizationPassesLabel, "optimizationPassesTip"), constraints); + optimizationOptionsPanel.add(tip(optimizationPassesSpinner, "optimizationPassesTip"), constraintsLast); + + JPanel optimizationPanel = new JPanel(layout); + + optimizationPanel.add(optimizationOptionsPanel, panelConstraints); + addClassSpecifications(boilerplateNoSideEffectMethods, + optimizationPanel, + boilerplateNoSideEffectMethodCheckBoxes, + null); + + addBorder(additionalNoSideEffectsPanel, "assumeNoSideEffectsAdditional"); + optimizationPanel.add(tip(additionalNoSideEffectsPanel, "assumeNoSideEffectsAdditionalTip"), stretchPanelConstraints); + + // Create the options panel. + JPanel preverificationOptionsPanel = new JPanel(layout); + addBorder(preverificationOptionsPanel, "preverificationAndTargeting"); + + preverificationOptionsPanel.add(tip(preverifyCheckBox, "preverifyTip"), constraintsLastStretch); + preverificationOptionsPanel.add(tip(microEditionCheckBox, "microEditionTip"), constraintsLastStretch); + preverificationOptionsPanel.add(tip(targetCheckBox, "targetTip"), constraints); + preverificationOptionsPanel.add(tip(targetComboBox, "targetTip"), constraintsLast); + + JButton printSeedsBrowseButton = + createBrowseButton(printSeedsTextField, msg("selectSeedsFile")); + + JButton printConfigurationBrowseButton = + createBrowseButton(printConfigurationTextField, msg( "selectConfigurationFile")); + + JButton dumpBrowseButton = + createBrowseButton(dumpTextField, msg("selectDumpFile")); + + // Select the most recent target by default. + targetComboBox.setSelectedIndex(targetComboBox.getItemCount() - 1); + + JPanel consistencyPanel = new JPanel(layout); + addBorder(consistencyPanel, "consistencyAndCorrectness"); + + consistencyPanel.add(tip(verboseCheckBox, "verboseTip"), constraintsLastStretch); + consistencyPanel.add(tip(noteCheckBox, "noteTip"), constraints); + consistencyPanel.add(tip(noteTextField, "noteFilterTip"), constraintsLastStretch); + consistencyPanel.add(tip(warnCheckBox, "warnTip"), constraints); + consistencyPanel.add(tip(warnTextField, "warnFilterTip"), constraintsLastStretch); + consistencyPanel.add(tip(ignoreWarningsCheckBox, "ignoreWarningsTip"), constraintsLastStretch); + consistencyPanel.add(tip(skipNonPublicLibraryClassesCheckBox, "skipNonPublicLibraryClassesTip"), constraintsLastStretch); + consistencyPanel.add(tip(skipNonPublicLibraryClassMembersCheckBox, "skipNonPublicLibraryClassMembersTip"), constraintsLastStretch); + consistencyPanel.add(tip(keepDirectoriesCheckBox, "keepDirectoriesTip"), constraints); + consistencyPanel.add(tip(keepDirectoriesTextField, "directoriesTip"), constraintsLastStretch); + consistencyPanel.add(tip(forceProcessingCheckBox, "forceProcessingTip"), constraintsLastStretch); + consistencyPanel.add(tip(printSeedsCheckBox, "printSeedsTip"), constraints); + consistencyPanel.add(tip(printSeedsTextField, "outputFileTip"), constraintsStretch); + consistencyPanel.add(tip(printSeedsBrowseButton, "selectSeedsFile"), constraintsLast); + consistencyPanel.add(tip(printConfigurationCheckBox, "printConfigurationTip"), constraints); + consistencyPanel.add(tip(printConfigurationTextField, "outputFileTip"), constraintsStretch); + consistencyPanel.add(tip(printConfigurationBrowseButton, "selectConfigurationFile"), constraintsLast); + consistencyPanel.add(tip(dumpCheckBox, "dumpTip"), constraints); + consistencyPanel.add(tip(dumpTextField, "outputFileTip"), constraintsStretch); + consistencyPanel.add(tip(dumpBrowseButton, "selectDumpFile"), constraintsLast); + + // Collect all components that are followed by text fields and make + // sure they are equally sized. That way the text fields start at the + // same horizontal position. + setCommonPreferredSize(Arrays.asList(new JComponent[] { + printMappingCheckBox, + applyMappingCheckBox, + flattenPackageHierarchyCheckBox, + repackageClassesCheckBox, + newSourceFileAttributeCheckBox, + })); + + JPanel optionsPanel = new JPanel(layout); + + optionsPanel.add(preverificationOptionsPanel, panelConstraints); + optionsPanel.add(consistencyPanel, panelConstraints); + + addBorder(whyAreYouKeepingPanel, "whyAreYouKeeping"); + optionsPanel.add(tip(whyAreYouKeepingPanel, "whyAreYouKeepingTip"), stretchPanelConstraints); + + // Create the process panel. + consoleTextArea.setOpaque(false); + consoleTextArea.setEditable(false); + consoleTextArea.setLineWrap(false); + consoleTextArea.setWrapStyleWord(false); + JScrollPane consoleScrollPane = new JScrollPane(consoleTextArea); + consoleScrollPane.setBorder(new EmptyBorder(1, 1, 1, 1)); + addBorder(consoleScrollPane, "processingConsole"); + + JPanel processPanel = new JPanel(layout); + processPanel.add(consoleScrollPane, stretchPanelConstraints); + + // Create the load, save, and process buttons. + JButton loadButton = new JButton(msg("loadConfiguration")); + loadButton.addActionListener(new MyLoadConfigurationActionListener()); + + JButton viewButton = new JButton(msg("viewConfiguration")); + viewButton.addActionListener(new MyViewConfigurationActionListener()); + + JButton saveButton = new JButton(msg("saveConfiguration")); + saveButton.addActionListener(new MySaveConfigurationActionListener()); + + JButton processButton = new JButton(msg("process")); + processButton.addActionListener(new MyProcessActionListener()); + + // Create the ReTrace panel. + JPanel reTraceSettingsPanel = new JPanel(layout); + addBorder(reTraceSettingsPanel, "reTraceSettings"); + + JButton reTraceMappingBrowseButton = createBrowseButton(reTraceMappingTextField, + msg("selectApplyMappingFile")); + + JLabel reTraceMappingLabel = new JLabel(msg("mappingFile")); + reTraceMappingLabel.setForeground(reTraceVerboseCheckBox.getForeground()); + + reTraceSettingsPanel.add(tip(reTraceVerboseCheckBox, "verboseTip"), constraintsLastStretch); + reTraceSettingsPanel.add(tip(reTraceMappingLabel, "mappingFileTip"), constraints); + reTraceSettingsPanel.add(tip(reTraceMappingTextField, "inputFileTip"), constraintsStretch); + reTraceSettingsPanel.add(tip(reTraceMappingBrowseButton, "selectApplyMappingFile"), constraintsLast); + + stackTraceTextArea.setOpaque(true); + stackTraceTextArea.setEditable(true); + stackTraceTextArea.setLineWrap(false); + stackTraceTextArea.setWrapStyleWord(true); + JScrollPane stackTraceScrollPane = new JScrollPane(stackTraceTextArea); + addBorder(stackTraceScrollPane, "obfuscatedStackTrace"); + + reTraceTextArea.setOpaque(false); + reTraceTextArea.setEditable(false); + reTraceTextArea.setLineWrap(true); + reTraceTextArea.setWrapStyleWord(true); + JScrollPane reTraceScrollPane = new JScrollPane(reTraceTextArea); + reTraceScrollPane.setBorder(new EmptyBorder(1, 1, 1, 1)); + addBorder(reTraceScrollPane, "deobfuscatedStackTrace"); + + JPanel reTracePanel = new JPanel(layout); + reTracePanel.add(reTraceSettingsPanel, panelConstraints); + reTracePanel.add(tip(stackTraceScrollPane, "obfuscatedStackTraceTip"), panelConstraints); + reTracePanel.add(reTraceScrollPane, stretchPanelConstraints); + + // Create the load button. + JButton loadStackTraceButton = new JButton(msg("loadStackTrace")); + loadStackTraceButton.addActionListener(new MyLoadStackTraceActionListener()); + + JButton reTraceButton = new JButton(msg("reTrace")); + reTraceButton.addActionListener(new MyReTraceActionListener()); + + // Create the main tabbed pane. + TabbedPane tabs = new TabbedPane(); + tabs.add(msg("proGuardTab"), proGuardPanel); + tabs.add(msg("inputOutputTab"), inputOutputPanel); + tabs.add(msg("shrinkingTab"), shrinkingPanel); + tabs.add(msg("obfuscationTab"), obfuscationPanel); + tabs.add(msg("optimizationTab"), optimizationPanel); + tabs.add(msg("informationTab"), optionsPanel); + tabs.add(msg("processTab"), processPanel); + tabs.add(msg("reTraceTab"), reTracePanel); + tabs.addImage(Toolkit.getDefaultToolkit().getImage( + this.getClass().getResource(TITLE_IMAGE_FILE))); + + // Add the bottom buttons to each panel. + proGuardPanel .add(Box.createGlue(), glueConstraints); + proGuardPanel .add(tip(loadButton, "loadConfigurationTip"), bottomButtonConstraints); + proGuardPanel .add(createNextButton(tabs), lastBottomButtonConstraints); + + inputOutputPanel .add(Box.createGlue(), glueConstraints); + inputOutputPanel .add(createPreviousButton(tabs), bottomButtonConstraints); + inputOutputPanel .add(createNextButton(tabs), lastBottomButtonConstraints); + + shrinkingPanel .add(Box.createGlue(), glueConstraints); + shrinkingPanel .add(createPreviousButton(tabs), bottomButtonConstraints); + shrinkingPanel .add(createNextButton(tabs), lastBottomButtonConstraints); + + obfuscationPanel .add(Box.createGlue(), glueConstraints); + obfuscationPanel .add(createPreviousButton(tabs), bottomButtonConstraints); + obfuscationPanel .add(createNextButton(tabs), lastBottomButtonConstraints); + + optimizationPanel .add(Box.createGlue(), glueConstraints); + optimizationPanel .add(createPreviousButton(tabs), bottomButtonConstraints); + optimizationPanel .add(createNextButton(tabs), lastBottomButtonConstraints); + + optionsPanel .add(Box.createGlue(), glueConstraints); + optionsPanel .add(createPreviousButton(tabs), bottomButtonConstraints); + optionsPanel .add(createNextButton(tabs), lastBottomButtonConstraints); + + processPanel .add(Box.createGlue(), glueConstraints); + processPanel .add(createPreviousButton(tabs), bottomButtonConstraints); + processPanel .add(tip(viewButton, "viewConfigurationTip"), bottomButtonConstraints); + processPanel .add(tip(saveButton, "saveConfigurationTip"), bottomButtonConstraints); + processPanel .add(tip(processButton, "processTip"), lastBottomButtonConstraints); + + reTracePanel .add(Box.createGlue(), glueConstraints); + reTracePanel .add(tip(loadStackTraceButton, "loadStackTraceTip"), bottomButtonConstraints); + reTracePanel .add(tip(reTraceButton, "reTraceTip"), lastBottomButtonConstraints); + + // Initialize the GUI settings to reasonable defaults. + loadConfiguration(this.getClass().getResource(DEFAULT_CONFIGURATION)); + + // Add the main tabs to the frame and pack it. + getContentPane().add(tabs); + } + + + public void startSplash() + { + splashPanel.start(); + } + + + public void skipSplash() + { + splashPanel.stop(); + } + + + /** + * Loads the boilerplate keep class options from the boilerplate file + * into the boilerplate array. + */ + private void loadBoilerplateConfiguration() + { + try + { + // Parse the boilerplate configuration file. + ConfigurationParser parser = new ConfigurationParser( + this.getClass().getResource(BOILERPLATE_CONFIGURATION)); + Configuration configuration = new Configuration(); + + try + { + parser.parse(configuration); + + // We're interested in the keep options. + boilerplateKeep = + extractKeepSpecifications(configuration.keep, false, false); + + // We're interested in the keep options. + boilerplateKeepNames = + extractKeepSpecifications(configuration.keep, true, false); + + // We're interested in the side effects options. + boilerplateNoSideEffectMethods = new ClassSpecification[configuration.assumeNoSideEffects.size()]; + configuration.assumeNoSideEffects.toArray(boilerplateNoSideEffectMethods); + } + finally + { + parser.close(); + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } + + + /** + * Returns an array containing the ClassSpecifications instances with + * matching flags. + */ + private KeepClassSpecification[] extractKeepSpecifications(List keepSpecifications, + boolean allowShrinking, + boolean allowObfuscation) + { + List matches = new ArrayList(); + + for (int index = 0; index < keepSpecifications.size(); index++) + { + KeepClassSpecification keepClassSpecification = (KeepClassSpecification)keepSpecifications.get(index); + if (keepClassSpecification.allowShrinking == allowShrinking && + keepClassSpecification.allowObfuscation == allowObfuscation) + { + matches.add(keepClassSpecification); + } + } + + KeepClassSpecification[] matchingKeepClassSpecifications = new KeepClassSpecification[matches.size()]; + matches.toArray(matchingKeepClassSpecifications); + + return matchingKeepClassSpecifications; + } + + + /** + * Returns an array containing the ClassSpecification instances of the + * given array of KeepClassSpecification instances. + */ + private ClassSpecification[] extractClassSpecifications(KeepClassSpecification[] keepClassSpecifications) + { + ClassSpecification[] classSpecifications = new ClassSpecification[keepClassSpecifications.length]; + + for (int index = 0; index < classSpecifications.length; index++) + { + classSpecifications[index] = keepClassSpecifications[index]; + } + + return classSpecifications; + } + + + /** + * Creates a panel with the given boiler plate class specifications. + */ + private void addClassSpecifications(ClassSpecification[] boilerplateClassSpecifications, + JPanel classSpecificationsPanel, + JCheckBox[] boilerplateCheckBoxes, + JTextField[] boilerplateTextFields) + { + // Create some constraints that can be reused. + GridBagConstraints constraints = new GridBagConstraints(); + constraints.anchor = GridBagConstraints.WEST; + constraints.insets = new Insets(0, 4, 0, 4); + + GridBagConstraints constraintsLastStretch = new GridBagConstraints(); + constraintsLastStretch.gridwidth = GridBagConstraints.REMAINDER; + constraintsLastStretch.fill = GridBagConstraints.HORIZONTAL; + constraintsLastStretch.weightx = 1.0; + constraintsLastStretch.anchor = GridBagConstraints.WEST; + constraintsLastStretch.insets = constraints.insets; + + GridBagConstraints panelConstraints = new GridBagConstraints(); + panelConstraints.gridwidth = GridBagConstraints.REMAINDER; + panelConstraints.fill = GridBagConstraints.HORIZONTAL; + panelConstraints.weightx = 1.0; + panelConstraints.anchor = GridBagConstraints.NORTHWEST; + panelConstraints.insets = constraints.insets; + + GridBagLayout layout = new GridBagLayout(); + + String lastPanelName = null; + JPanel keepSubpanel = null; + for (int index = 0; index < boilerplateClassSpecifications.length; index++) + { + // The panel structure is derived from the comments. + String comments = boilerplateClassSpecifications[index].comments; + int dashIndex = comments.indexOf('-'); + int periodIndex = comments.indexOf('.', dashIndex); + String panelName = comments.substring(0, dashIndex).trim(); + String optionName = comments.substring(dashIndex + 1, periodIndex).replace('_', '.').trim(); + String toolTip = comments.substring(periodIndex + 1); + if (keepSubpanel == null || !panelName.equals(lastPanelName)) + { + // Create a new keep subpanel and add it. + keepSubpanel = new JPanel(layout); + keepSubpanel.setBorder(BorderFactory.createTitledBorder(BORDER, panelName)); + classSpecificationsPanel.add(keepSubpanel, panelConstraints); + + lastPanelName = panelName; + } + + // Add the check box to the subpanel. + JCheckBox boilerplateCheckBox = new JCheckBox(optionName); + boilerplateCheckBox.setToolTipText(toolTip); + boilerplateCheckBoxes[index] = boilerplateCheckBox; + keepSubpanel.add(boilerplateCheckBox, + boilerplateTextFields != null ? + constraints : + constraintsLastStretch); + + if (boilerplateTextFields != null) + { + // Add the text field to the subpanel. + boilerplateTextFields[index] = new JTextField(40); + keepSubpanel.add(tip(boilerplateTextFields[index], "classNamesTip"), constraintsLastStretch); + } + } + } + + + /** + * Adds a standard border with the title that corresponds to the given key + * in the GUI resources. + */ + private void addBorder(JComponent component, String titleKey) + { + Border oldBorder = component.getBorder(); + Border newBorder = BorderFactory.createTitledBorder(BORDER, msg(titleKey)); + + component.setBorder(oldBorder == null ? + newBorder : + new CompoundBorder(newBorder, oldBorder)); + } + + + /** + * Creates a Previous button for the given tabbed pane. + */ + private JButton createPreviousButton(final TabbedPane tabbedPane) + { + JButton browseButton = new JButton(msg("previous")); + browseButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + tabbedPane.previous(); + } + }); + + return browseButton; + } + + + /** + * Creates a Next button for the given tabbed pane. + */ + private JButton createNextButton(final TabbedPane tabbedPane) + { + JButton browseButton = new JButton(msg("next")); + browseButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + tabbedPane.next(); + } + }); + + return browseButton; + } + + + /** + * Creates a browse button that opens a file browser for the given text field. + */ + private JButton createBrowseButton(final JTextField textField, + final String title) + { + JButton browseButton = new JButton(msg("browse")); + browseButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + // Update the file chooser. + fileChooser.setDialogTitle(title); + fileChooser.setSelectedFile(new File(textField.getText())); + + int returnVal = fileChooser.showDialog(ProGuardGUI.this, msg("ok")); + if (returnVal == JFileChooser.APPROVE_OPTION) + { + // Update the text field. + textField.setText(fileChooser.getSelectedFile().getPath()); + } + } + }); + + return browseButton; + } + + + protected JButton createOptimizationsButton(final JTextField textField) + { + final OptimizationsDialog optimizationsDialog = new OptimizationsDialog(ProGuardGUI.this); + + JButton optimizationsButton = new JButton(msg("select")); + optimizationsButton.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + // Update the dialog. + optimizationsDialog.setFilter(textField.getText()); + + int returnValue = optimizationsDialog.showDialog(); + if (returnValue == OptimizationsDialog.APPROVE_OPTION) + { + // Update the text field. + textField.setText(optimizationsDialog.getFilter()); + } + } + }); + + return optimizationsButton; + } + + + /** + * Sets the preferred sizes of the given components to the maximum of their + * current preferred sizes. + */ + private void setCommonPreferredSize(List components) + { + // Find the maximum preferred size. + Dimension maximumSize = null; + for (int index = 0; index < components.size(); index++) + { + JComponent component = (JComponent)components.get(index); + Dimension size = component.getPreferredSize(); + if (maximumSize == null || + size.getWidth() > maximumSize.getWidth()) + { + maximumSize = size; + } + } + + // Set the size that we found as the preferred size for all components. + for (int index = 0; index < components.size(); index++) + { + JComponent component = (JComponent)components.get(index); + component.setPreferredSize(maximumSize); + } + } + + + /** + * Updates to GUI settings to reflect the given ProGuard configuration. + */ + private void setProGuardConfiguration(Configuration configuration) + { + // Set up the input and output jars and directories. + programPanel.setClassPath(configuration.programJars); + libraryPanel.setClassPath(configuration.libraryJars); + + // Set up the boilerplate keep options. + for (int index = 0; index < boilerplateKeep.length; index++) + { + String classNames = + findMatchingKeepSpecifications(boilerplateKeep[index], + configuration.keep); + + boilerplateKeepCheckBoxes[index].setSelected(classNames != null); + boilerplateKeepTextFields[index].setText(classNames == null ? "*" : classNames); + } + + + // Set up the boilerplate keep names options. + for (int index = 0; index < boilerplateKeepNames.length; index++) + { + String classNames = + findMatchingKeepSpecifications(boilerplateKeepNames[index], + configuration.keep); + + boilerplateKeepNamesCheckBoxes[index].setSelected(classNames != null); + boilerplateKeepNamesTextFields[index].setText(classNames == null ? "*" : classNames); + } + + // Set up the additional keep options. Note that the matched boilerplate + // options have been removed from the list. + additionalKeepPanel.setClassSpecifications(filteredKeepSpecifications(configuration.keep, + false)); + + // Set up the additional keep options. Note that the matched boilerplate + // options have been removed from the list. + additionalKeepNamesPanel.setClassSpecifications(filteredKeepSpecifications(configuration.keep, + true)); + + + // Set up the boilerplate "no side effect methods" options. + for (int index = 0; index < boilerplateNoSideEffectMethods.length; index++) + { + boolean found = + findClassSpecification(boilerplateNoSideEffectMethods[index], + configuration.assumeNoSideEffects); + + boilerplateNoSideEffectMethodCheckBoxes[index].setSelected(found); + } + + // Set up the additional keep options. Note that the matched boilerplate + // options have been removed from the list. + additionalNoSideEffectsPanel.setClassSpecifications(configuration.assumeNoSideEffects); + + // Set up the "why are you keeping" options. + whyAreYouKeepingPanel.setClassSpecifications(configuration.whyAreYouKeeping); + + // Set up the other options. + shrinkCheckBox .setSelected(configuration.shrink); + printUsageCheckBox .setSelected(configuration.printUsage != null); + + optimizeCheckBox .setSelected(configuration.optimize); + allowAccessModificationCheckBox .setSelected(configuration.allowAccessModification); + mergeInterfacesAggressivelyCheckBox .setSelected(configuration.mergeInterfacesAggressively); + optimizationPassesSpinner.getModel() .setValue(new Integer(configuration.optimizationPasses)); + + obfuscateCheckBox .setSelected(configuration.obfuscate); + printMappingCheckBox .setSelected(configuration.printMapping != null); + applyMappingCheckBox .setSelected(configuration.applyMapping != null); + obfuscationDictionaryCheckBox .setSelected(configuration.obfuscationDictionary != null); + classObfuscationDictionaryCheckBox .setSelected(configuration.classObfuscationDictionary != null); + packageObfuscationDictionaryCheckBox .setSelected(configuration.packageObfuscationDictionary != null); + overloadAggressivelyCheckBox .setSelected(configuration.overloadAggressively); + useUniqueClassMemberNamesCheckBox .setSelected(configuration.useUniqueClassMemberNames); + useMixedCaseClassNamesCheckBox .setSelected(configuration.useMixedCaseClassNames); + keepPackageNamesCheckBox .setSelected(configuration.keepPackageNames != null); + flattenPackageHierarchyCheckBox .setSelected(configuration.flattenPackageHierarchy != null); + repackageClassesCheckBox .setSelected(configuration.repackageClasses != null); + keepAttributesCheckBox .setSelected(configuration.keepAttributes != null); + newSourceFileAttributeCheckBox .setSelected(configuration.newSourceFileAttribute != null); + adaptClassStringsCheckBox .setSelected(configuration.adaptClassStrings != null); + adaptResourceFileNamesCheckBox .setSelected(configuration.adaptResourceFileNames != null); + adaptResourceFileContentsCheckBox .setSelected(configuration.adaptResourceFileContents != null); + + preverifyCheckBox .setSelected(configuration.preverify); + microEditionCheckBox .setSelected(configuration.microEdition); + targetCheckBox .setSelected(configuration.targetClassVersion != 0); + + verboseCheckBox .setSelected(configuration.verbose); + noteCheckBox .setSelected(configuration.note == null || !configuration.note.isEmpty()); + warnCheckBox .setSelected(configuration.warn == null || !configuration.warn.isEmpty()); + ignoreWarningsCheckBox .setSelected(configuration.ignoreWarnings); + skipNonPublicLibraryClassesCheckBox .setSelected(configuration.skipNonPublicLibraryClasses); + skipNonPublicLibraryClassMembersCheckBox.setSelected(configuration.skipNonPublicLibraryClassMembers); + keepDirectoriesCheckBox .setSelected(configuration.keepDirectories != null); + forceProcessingCheckBox .setSelected(configuration.lastModified == Long.MAX_VALUE); + printSeedsCheckBox .setSelected(configuration.printSeeds != null); + printConfigurationCheckBox .setSelected(configuration.printConfiguration != null); + dumpCheckBox .setSelected(configuration.dump != null); + + printUsageTextField .setText(fileName(configuration.printUsage)); + optimizationsTextField .setText(configuration.optimizations == null ? OPTIMIZATIONS_DEFAULT : ListUtil.commaSeparatedString(configuration.optimizations)); + printMappingTextField .setText(fileName(configuration.printMapping)); + applyMappingTextField .setText(fileName(configuration.applyMapping)); + obfuscationDictionaryTextField .setText(fileName(configuration.obfuscationDictionary)); + keepPackageNamesTextField .setText(configuration.keepPackageNames == null ? "" : ClassUtil.externalClassName(ListUtil.commaSeparatedString(configuration.keepPackageNames))); + flattenPackageHierarchyTextField .setText(configuration.flattenPackageHierarchy); + repackageClassesTextField .setText(configuration.repackageClasses); + keepAttributesTextField .setText(configuration.keepAttributes == null ? KEEP_ATTRIBUTE_DEFAULT : ListUtil.commaSeparatedString(configuration.keepAttributes)); + newSourceFileAttributeTextField .setText(configuration.newSourceFileAttribute == null ? SOURCE_FILE_ATTRIBUTE_DEFAULT : configuration.newSourceFileAttribute); + adaptClassStringsTextField .setText(configuration.adaptClassStrings == null ? "" : ClassUtil.externalClassName(ListUtil.commaSeparatedString(configuration.adaptClassStrings))); + adaptResourceFileNamesTextField .setText(configuration.adaptResourceFileNames == null ? ADAPT_RESOURCE_FILE_NAMES_DEFAULT : ListUtil.commaSeparatedString(configuration.adaptResourceFileNames)); + adaptResourceFileContentsTextField .setText(configuration.adaptResourceFileContents == null ? ADAPT_RESOURCE_FILE_CONTENTS_DEFAULT : ListUtil.commaSeparatedString(configuration.adaptResourceFileContents)); + noteTextField .setText(ListUtil.commaSeparatedString(configuration.note)); + warnTextField .setText(ListUtil.commaSeparatedString(configuration.warn)); + keepDirectoriesTextField .setText(ListUtil.commaSeparatedString(configuration.keepDirectories)); + printSeedsTextField .setText(fileName(configuration.printSeeds)); + printConfigurationTextField .setText(fileName(configuration.printConfiguration)); + dumpTextField .setText(fileName(configuration.dump)); + + if (configuration.targetClassVersion != 0) + { + targetComboBox.setSelectedItem(ClassUtil.externalClassVersion(configuration.targetClassVersion)); + } + else + { + targetComboBox.setSelectedIndex(targetComboBox.getItemCount() - 1); + } + + if (configuration.printMapping != null) + { + reTraceMappingTextField.setText(fileName(configuration.printMapping)); + } + } + + + /** + * Returns the ProGuard configuration that reflects the current GUI settings. + */ + private Configuration getProGuardConfiguration() + { + Configuration configuration = new Configuration(); + + // Get the input and output jars and directories. + configuration.programJars = programPanel.getClassPath(); + configuration.libraryJars = libraryPanel.getClassPath(); + + List keep = new ArrayList(); + + // Collect the additional keep options. + List additionalKeep = additionalKeepPanel.getClassSpecifications(); + if (additionalKeep != null) + { + keep.addAll(additionalKeep); + } + + // Collect the additional keep names options. + List additionalKeepNames = additionalKeepNamesPanel.getClassSpecifications(); + if (additionalKeepNames != null) + { + keep.addAll(additionalKeepNames); + } + + // Collect the boilerplate keep options. + for (int index = 0; index < boilerplateKeep.length; index++) + { + if (boilerplateKeepCheckBoxes[index].isSelected()) + { + keep.add(classSpecification(boilerplateKeep[index], + boilerplateKeepTextFields[index].getText())); + } + } + + // Collect the boilerplate keep names options. + for (int index = 0; index < boilerplateKeepNames.length; index++) + { + if (boilerplateKeepNamesCheckBoxes[index].isSelected()) + { + keep.add(classSpecification(boilerplateKeepNames[index], + boilerplateKeepNamesTextFields[index].getText())); + } + } + + // Put the list of keep specifications in the configuration. + if (keep.size() > 0) + { + configuration.keep = keep; + } + + + // Collect the boilerplate "no side effect methods" options. + List noSideEffectMethods = new ArrayList(); + + for (int index = 0; index < boilerplateNoSideEffectMethods.length; index++) + { + if (boilerplateNoSideEffectMethodCheckBoxes[index].isSelected()) + { + noSideEffectMethods.add(boilerplateNoSideEffectMethods[index]); + } + } + + // Collect the additional "no side effect methods" options. + List additionalNoSideEffectOptions = additionalNoSideEffectsPanel.getClassSpecifications(); + if (additionalNoSideEffectOptions != null) + { + noSideEffectMethods.addAll(additionalNoSideEffectOptions); + } + + // Put the list of "no side effect methods" options in the configuration. + if (noSideEffectMethods.size() > 0) + { + configuration.assumeNoSideEffects = noSideEffectMethods; + } + + + // Collect the "why are you keeping" options. + configuration.whyAreYouKeeping = whyAreYouKeepingPanel.getClassSpecifications(); + + + // Get the other options. + configuration.shrink = shrinkCheckBox .isSelected(); + configuration.printUsage = printUsageCheckBox .isSelected() ? new File(printUsageTextField .getText()) : null; + + configuration.optimize = optimizeCheckBox .isSelected(); + configuration.allowAccessModification = allowAccessModificationCheckBox .isSelected(); + configuration.mergeInterfacesAggressively = mergeInterfacesAggressivelyCheckBox .isSelected(); + configuration.optimizations = optimizationsTextField.getText().length() > 1 ? ListUtil.commaSeparatedList(optimizationsTextField .getText()) : null; + configuration.optimizationPasses = ((SpinnerNumberModel)optimizationPassesSpinner.getModel()).getNumber().intValue(); + + configuration.obfuscate = obfuscateCheckBox .isSelected(); + configuration.printMapping = printMappingCheckBox .isSelected() ? new File(printMappingTextField .getText()) : null; + configuration.applyMapping = applyMappingCheckBox .isSelected() ? new File(applyMappingTextField .getText()) : null; + configuration.obfuscationDictionary = obfuscationDictionaryCheckBox .isSelected() ? new File(obfuscationDictionaryTextField .getText()) : null; + configuration.classObfuscationDictionary = classObfuscationDictionaryCheckBox .isSelected() ? new File(classObfuscationDictionaryTextField .getText()) : null; + configuration.packageObfuscationDictionary = packageObfuscationDictionaryCheckBox .isSelected() ? new File(packageObfuscationDictionaryTextField .getText()) : null; + configuration.overloadAggressively = overloadAggressivelyCheckBox .isSelected(); + configuration.useUniqueClassMemberNames = useUniqueClassMemberNamesCheckBox .isSelected(); + configuration.useMixedCaseClassNames = useMixedCaseClassNamesCheckBox .isSelected(); + configuration.keepPackageNames = keepPackageNamesCheckBox .isSelected() ? keepPackageNamesTextField.getText().length() > 0 ? ListUtil.commaSeparatedList(ClassUtil.internalClassName(keepPackageNamesTextField.getText())) : new ArrayList() : null; + configuration.flattenPackageHierarchy = flattenPackageHierarchyCheckBox .isSelected() ? ClassUtil.internalClassName(flattenPackageHierarchyTextField .getText()) : null; + configuration.repackageClasses = repackageClassesCheckBox .isSelected() ? ClassUtil.internalClassName(repackageClassesTextField .getText()) : null; + configuration.keepAttributes = keepAttributesCheckBox .isSelected() ? ListUtil.commaSeparatedList(keepAttributesTextField .getText()) : null; + configuration.newSourceFileAttribute = newSourceFileAttributeCheckBox .isSelected() ? newSourceFileAttributeTextField .getText() : null; + configuration.adaptClassStrings = adaptClassStringsCheckBox .isSelected() ? adaptClassStringsTextField.getText().length() > 0 ? ListUtil.commaSeparatedList(ClassUtil.internalClassName(adaptClassStringsTextField.getText())) : new ArrayList() : null; + configuration.adaptResourceFileNames = adaptResourceFileNamesCheckBox .isSelected() ? ListUtil.commaSeparatedList(adaptResourceFileNamesTextField .getText()) : null; + configuration.adaptResourceFileContents = adaptResourceFileContentsCheckBox .isSelected() ? ListUtil.commaSeparatedList(adaptResourceFileContentsTextField .getText()) : null; + + configuration.preverify = preverifyCheckBox .isSelected(); + configuration.microEdition = microEditionCheckBox .isSelected(); + configuration.targetClassVersion = targetCheckBox .isSelected() ? ClassUtil.internalClassVersion(targetComboBox.getSelectedItem().toString()) : 0; + + configuration.verbose = verboseCheckBox .isSelected(); + configuration.note = noteCheckBox .isSelected() ? noteTextField.getText().length() > 0 ? ListUtil.commaSeparatedList(ClassUtil.internalClassName(noteTextField.getText())) : null : new ArrayList(); + configuration.warn = warnCheckBox .isSelected() ? warnTextField.getText().length() > 0 ? ListUtil.commaSeparatedList(ClassUtil.internalClassName(warnTextField.getText())) : null : new ArrayList(); + configuration.ignoreWarnings = ignoreWarningsCheckBox .isSelected(); + configuration.skipNonPublicLibraryClasses = skipNonPublicLibraryClassesCheckBox .isSelected(); + configuration.skipNonPublicLibraryClassMembers = skipNonPublicLibraryClassMembersCheckBox.isSelected(); + configuration.keepDirectories = keepDirectoriesCheckBox .isSelected() ? keepDirectoriesTextField.getText().length() > 0 ? ListUtil.commaSeparatedList(ClassUtil.internalClassName(keepDirectoriesTextField.getText())) : new ArrayList() : null; + configuration.lastModified = forceProcessingCheckBox .isSelected() ? Long.MAX_VALUE : System.currentTimeMillis(); + configuration.printSeeds = printSeedsCheckBox .isSelected() ? new File(printSeedsTextField .getText()) : null; + configuration.printConfiguration = printConfigurationCheckBox .isSelected() ? new File(printConfigurationTextField .getText()) : null; + configuration.dump = dumpCheckBox .isSelected() ? new File(dumpTextField .getText()) : null; + + return configuration; + } + + + /** + * Looks in the given list for a class specification that is identical to + * the given template. Returns true if it is found, and removes the matching + * class specification as a side effect. + */ + private boolean findClassSpecification(ClassSpecification classSpecificationTemplate, + List classSpecifications) + { + if (classSpecifications == null) + { + return false; + } + + for (int index = 0; index < classSpecifications.size(); index++) + { + if (classSpecificationTemplate.equals(classSpecifications.get(index))) + { + // Remove the matching option as a side effect. + classSpecifications.remove(index); + + return true; + } + } + + return false; + } + + + /** + * Returns the subset of the given list of keep specifications, with + * matching shrinking flag. + */ + private List filteredKeepSpecifications(List keepSpecifications, + boolean allowShrinking) + { + List filteredKeepSpecifications = new ArrayList(); + + for (int index = 0; index < keepSpecifications.size(); index++) + { + KeepClassSpecification keepClassSpecification = + (KeepClassSpecification)keepSpecifications.get(index); + + if (keepClassSpecification.allowShrinking == allowShrinking) + { + filteredKeepSpecifications.add(keepClassSpecification); + } + } + + return filteredKeepSpecifications; + } + + + /** + * Looks in the given list for keep specifications that match the given + * template. Returns a comma-separated string of class names from + * matching keep specifications, and removes the matching keep + * specifications as a side effect. + */ + private String findMatchingKeepSpecifications(KeepClassSpecification keepClassSpecificationTemplate, + List keepSpecifications) + { + if (keepSpecifications == null) + { + return null; + } + + StringBuffer buffer = null; + + for (int index = 0; index < keepSpecifications.size(); index++) + { + KeepClassSpecification listedKeepClassSpecification = + (KeepClassSpecification)keepSpecifications.get(index); + String className = listedKeepClassSpecification.className; + keepClassSpecificationTemplate.className = className; + if (keepClassSpecificationTemplate.equals(listedKeepClassSpecification)) + { + if (buffer == null) + { + buffer = new StringBuffer(); + } + else + { + buffer.append(','); + } + buffer.append(className == null ? "*" : ClassUtil.externalClassName(className)); + + // Remove the matching option as a side effect. + keepSpecifications.remove(index--); + } + } + + return buffer == null ? null : buffer.toString(); + } + + + /** + * Returns a class specification or keep specification, based on the given + * template and the class name to be filled in. + */ + private ClassSpecification classSpecification(ClassSpecification classSpecificationTemplate, + String className) + { + // Create a copy of the template. + ClassSpecification classSpecification = + (ClassSpecification)classSpecificationTemplate.clone(); + + // Set the class name in the copy. + classSpecification.className = + className.equals("") || + className.equals("*") ? + null : + ClassUtil.internalClassName(className); + + // Return the modified copy. + return classSpecification; + } + + + // Methods and internal classes related to actions. + + /** + * Loads the given ProGuard configuration into the GUI. + */ + private void loadConfiguration(File file) + { + // Set the default directory and file in the file choosers. + configurationChooser.setSelectedFile(file.getAbsoluteFile()); + fileChooser.setCurrentDirectory(file.getAbsoluteFile().getParentFile()); + + try + { + // Parse the configuration file. + ConfigurationParser parser = new ConfigurationParser(file); + Configuration configuration = new Configuration(); + + try + { + parser.parse(configuration); + + // Let the GUI reflect the configuration. + setProGuardConfiguration(configuration); + } + catch (ParseException ex) + { + JOptionPane.showMessageDialog(getContentPane(), + msg("cantParseConfigurationFile", file.getPath()), + msg("warning"), + JOptionPane.ERROR_MESSAGE); + } + finally + { + parser.close(); + } + } + catch (IOException ex) + { + JOptionPane.showMessageDialog(getContentPane(), + msg("cantOpenConfigurationFile", file.getPath()), + msg("warning"), + JOptionPane.ERROR_MESSAGE); + } + } + + + /** + * Loads the given ProGuard configuration into the GUI. + */ + private void loadConfiguration(URL url) + { + try + { + // Parse the configuration file. + ConfigurationParser parser = new ConfigurationParser(url); + Configuration configuration = new Configuration(); + + try + { + parser.parse(configuration); + + // Let the GUI reflect the configuration. + setProGuardConfiguration(configuration); + } + catch (ParseException ex) + { + JOptionPane.showMessageDialog(getContentPane(), + msg("cantParseConfigurationFile", url), + msg("warning"), + JOptionPane.ERROR_MESSAGE); + } + finally + { + parser.close(); + } + } + catch (IOException ex) + { + JOptionPane.showMessageDialog(getContentPane(), + msg("cantOpenConfigurationFile", url), + msg("warning"), + JOptionPane.ERROR_MESSAGE); + } + } + + + /** + * Saves the current ProGuard configuration to the given file. + */ + private void saveConfiguration(File file) + { + try + { + // Save the configuration file. + ConfigurationWriter writer = new ConfigurationWriter(file); + writer.write(getProGuardConfiguration()); + writer.close(); + } + catch (Exception ex) + { + JOptionPane.showMessageDialog(getContentPane(), + msg("cantSaveConfigurationFile", file.getPath()), + msg("warning"), + JOptionPane.ERROR_MESSAGE); + } + } + + + /** + * Loads the given stack trace into the GUI. + */ + private void loadStackTrace(String fileName) + { + try + { + StringBuffer buffer = new StringBuffer(1024); + + Reader reader = new BufferedReader(new FileReader(fileName)); + try + { + while (true) + { + int c = reader.read(); + if (c < 0) + { + break; + } + + buffer.append(c); + } + } + finally + { + reader.close(); + } + + // Put the stack trace in the text area. + stackTraceTextArea.setText(buffer.toString()); + } + catch (IOException ex) + { + JOptionPane.showMessageDialog(getContentPane(), + msg("cantOpenStackTraceFile", fileName), + msg("warning"), + JOptionPane.ERROR_MESSAGE); + } + } + + + /** + * This ActionListener loads a ProGuard configuration file and initializes + * the GUI accordingly. + */ + private class MyLoadConfigurationActionListener implements ActionListener + { + public void actionPerformed(ActionEvent e) + { + configurationChooser.setDialogTitle(msg("selectConfigurationFile")); + + int returnValue = configurationChooser.showOpenDialog(ProGuardGUI.this); + if (returnValue == JFileChooser.APPROVE_OPTION) + { + loadConfiguration(configurationChooser.getSelectedFile()); + } + } + } + + + /** + * This ActionListener saves a ProGuard configuration file based on the + * current GUI settings. + */ + private class MySaveConfigurationActionListener implements ActionListener + { + public void actionPerformed(ActionEvent e) + { + configurationChooser.setDialogTitle(msg("saveConfigurationFile")); + + int returnVal = configurationChooser.showSaveDialog(ProGuardGUI.this); + if (returnVal == JFileChooser.APPROVE_OPTION) + { + saveConfiguration(configurationChooser.getSelectedFile()); + } + } + } + + + /** + * This ActionListener displays the ProGuard configuration specified by the + * current GUI settings. + */ + private class MyViewConfigurationActionListener implements ActionListener + { + public void actionPerformed(ActionEvent e) + { + // Make sure System.out has not been redirected yet. + if (!systemOutRedirected) + { + consoleTextArea.setText(""); + + TextAreaOutputStream outputStream = + new TextAreaOutputStream(consoleTextArea); + + try + { + // TODO: write out relative path names and path names with system properties. + + // Write the configuration. + ConfigurationWriter writer = new ConfigurationWriter(outputStream); + try + { + writer.write(getProGuardConfiguration()); + } + finally + { + writer.close(); + } + } + catch (IOException ex) + { + // This shouldn't happen. + } + + // Scroll to the top of the configuration. + consoleTextArea.setCaretPosition(0); + } + } + } + + + /** + * This ActionListener executes ProGuard based on the current GUI settings. + */ + private class MyProcessActionListener implements ActionListener + { + public void actionPerformed(ActionEvent e) + { + // Make sure System.out has not been redirected yet. + if (!systemOutRedirected) + { + systemOutRedirected = true; + + // Get the informational configuration file name. + File configurationFile = configurationChooser.getSelectedFile(); + String configurationFileName = configurationFile != null ? + configurationFile.getName() : + msg("sampleConfigurationFileName"); + + // Create the ProGuard thread. + Thread proGuardThread = + new Thread(new ProGuardRunnable(consoleTextArea, + getProGuardConfiguration(), + configurationFileName)); + + // Run it. + proGuardThread.start(); + } + } + } + + + /** + * This ActionListener loads an obfuscated stack trace from a file and puts + * it in the proper text area. + */ + private class MyLoadStackTraceActionListener implements ActionListener + { + public void actionPerformed(ActionEvent e) + { + fileChooser.setDialogTitle(msg("selectStackTraceFile")); + fileChooser.setSelectedFile(null); + + int returnValue = fileChooser.showOpenDialog(ProGuardGUI.this); + if (returnValue == JFileChooser.APPROVE_OPTION) + { + File selectedFile = fileChooser.getSelectedFile(); + String fileName = selectedFile.getPath(); + + loadStackTrace(fileName); + } + } + } + + + /** + * This ActionListener executes ReTrace based on the current GUI settings. + */ + private class MyReTraceActionListener implements ActionListener + { + public void actionPerformed(ActionEvent e) + { + // Make sure System.out has not been redirected yet. + if (!systemOutRedirected) + { + systemOutRedirected = true; + + boolean verbose = reTraceVerboseCheckBox.isSelected(); + File retraceMappingFile = new File(reTraceMappingTextField.getText()); + String stackTrace = stackTraceTextArea.getText(); + + // Create the ReTrace runnable. + Runnable reTraceRunnable = new ReTraceRunnable(reTraceTextArea, + verbose, + retraceMappingFile, + stackTrace); + + // Run it in this thread, because it won't take long anyway. + reTraceRunnable.run(); + } + } + } + + + // Small utility methods. + + /** + * Returns the file name of the given file, if any. + */ + private static String fileName(File file) + { + return file == null ? "" : file.getAbsolutePath(); + } + + + /** + * Attaches the tool tip from the GUI resources that corresponds to the + * given key, to the given component. + */ + private static JComponent tip(JComponent component, String messageKey) + { + component.setToolTipText(msg(messageKey)); + + return component; + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private static String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key and argument. + */ + private String msg(String messageKey, + Object messageArgument) + { + return GUIResources.getMessage(messageKey, new Object[] {messageArgument}); + } + + + /** + * The main method for the ProGuard GUI. + */ + public static void main(final String[] args) + { + try + { + SwingUtil.invokeAndWait(new Runnable() + { + public void run() + { + ProGuardGUI gui = new ProGuardGUI(); + gui.pack(); + + Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize(); + Dimension guiSize = gui.getSize(); + gui.setLocation((screenSize.width - guiSize.width) / 2, + (screenSize.height - guiSize.height) / 2); + gui.show(); + + // Start the splash animation, unless specified otherwise. + int argIndex = 0; + if (argIndex < args.length && + NO_SPLASH_OPTION.startsWith(args[argIndex])) + { + gui.skipSplash(); + argIndex++; + } + else + { + gui.startSplash(); + } + + // Load an initial configuration, if specified. + if (argIndex < args.length) + { + gui.loadConfiguration(new File(args[argIndex])); + argIndex++; + } + + if (argIndex < args.length) + { + System.out.println(gui.getClass().getName() + ": ignoring extra arguments [" + args[argIndex] + "...]"); + } + + } + }); + } + catch (Exception e) + { + // Nothing. + } + } +} diff --git a/src/proguard/gui/ProGuardRunnable.java b/src/proguard/gui/ProGuardRunnable.java new file mode 100644 index 0000000..c5c5937 --- /dev/null +++ b/src/proguard/gui/ProGuardRunnable.java @@ -0,0 +1,154 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.*; + +import javax.swing.*; +import java.awt.*; +import java.io.PrintStream; + + +/** + * This Runnable runs ProGuard, sending console output to a text + * area and any exceptions to message dialogs. + * + * @see ProGuard + * @author Eric Lafortune + */ +final class ProGuardRunnable implements Runnable +{ + private final JTextArea consoleTextArea; + private final Configuration configuration; + private final String configurationFileName; + + + /** + * Creates a new ProGuardRunnable object. + * @param consoleTextArea the text area to send the console output to. + * @param configuration the ProGuard configuration. + * @param configurationFileName the optional file name of the configuration, + * for informational purposes. + */ + public ProGuardRunnable(JTextArea consoleTextArea, + Configuration configuration, + String configurationFileName) + { + this.consoleTextArea = consoleTextArea; + this.configuration = configuration; + this.configurationFileName = configurationFileName; + } + + + // Implementation for Runnable. + + public void run() + { + consoleTextArea.setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR)); + consoleTextArea.setText(""); + + // Redirect the System's out and err streams to the console text area. + PrintStream oldOut = System.out; + PrintStream oldErr = System.err; + + PrintStream printStream = + new PrintStream(new TextAreaOutputStream(consoleTextArea), true); + + System.setOut(printStream); + System.setErr(printStream); + + try + { + // Create a new ProGuard object with the GUI's configuration. + ProGuard proGuard = new ProGuard(configuration); + + // Run it. + proGuard.execute(); + + // Print out the completion message. + System.out.println("Processing completed successfully"); + } + catch (Exception ex) + { + //ex.printStackTrace(); + + // Print out the exception message. + System.out.println(ex.getMessage()); + + // Show a dialog as well. + MessageDialogRunnable.showMessageDialog(consoleTextArea, + ex.getMessage(), + msg("errorProcessing"), + JOptionPane.ERROR_MESSAGE); + } + catch (OutOfMemoryError er) + { + // Forget about the ProGuard object as quickly as possible. + System.gc(); + + // Print out a message suggesting what to do next. + System.out.println(msg("outOfMemoryInfo", configurationFileName)); + + // Show a dialog as well. + MessageDialogRunnable.showMessageDialog(consoleTextArea, + msg("outOfMemory"), + msg("errorProcessing"), + JOptionPane.ERROR_MESSAGE); + } + finally + { + // Make sure all output has been sent to the console text area. + printStream.close(); + + // Restore the old System's out and err streams. + System.setOut(oldOut); + System.setErr(oldErr); + } + + consoleTextArea.setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR)); + + // Reset the global static redirection lock. + ProGuardGUI.systemOutRedirected = false; + } + + + // Small utility methods. + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } + + + /** + * Returns the message from the GUI resources that corresponds to the given + * key and argument. + */ + private String msg(String messageKey, + Object messageArgument) + { + return GUIResources.getMessage(messageKey, new Object[] {messageArgument}); + } +} diff --git a/src/proguard/gui/ReTraceRunnable.java b/src/proguard/gui/ReTraceRunnable.java new file mode 100644 index 0000000..1ca19ca --- /dev/null +++ b/src/proguard/gui/ReTraceRunnable.java @@ -0,0 +1,149 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import proguard.retrace.ReTrace; + +import javax.swing.*; +import java.awt.*; +import java.io.*; + + +/** + * This Runnable runs ReTrace, sending console output to a text + * area and any exceptions to message dialogs. + * + * @see ReTrace + * @author Eric Lafortune + */ +final class ReTraceRunnable implements Runnable +{ + private final JTextArea consoleTextArea; + private final boolean verbose; + private final File mappingFile; + private final String stackTrace; + + + /** + * Creates a new ProGuardRunnable object. + * @param consoleTextArea the text area to send the console output to. + * @param verbose specifies whether the de-obfuscated stack trace + * should be verbose. + * @param mappingFile the mapping file that was written out by ProGuard. + */ + public ReTraceRunnable(JTextArea consoleTextArea, + boolean verbose, + File mappingFile, + String stackTrace) + { + this.consoleTextArea = consoleTextArea; + this.verbose = verbose; + this.mappingFile = mappingFile; + this.stackTrace = stackTrace; + } + + + // Implementation for Runnable. + + public void run() + { + consoleTextArea.setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR)); + consoleTextArea.setText(""); + + // Redirect the stack trace string to the System's in stream, and the + // out and err streams to the console text area. + InputStream oldIn = System.in; + PrintStream oldOut = System.out; + PrintStream oldErr = System.err; + + ByteArrayInputStream inputStream = + new ByteArrayInputStream(stackTrace.getBytes()); + + PrintStream printStream = + new PrintStream(new TextAreaOutputStream(consoleTextArea), true); + + System.setIn(inputStream); + System.setOut(printStream); + System.setErr(printStream); + + try + { + // Create a new ProGuard object with the GUI's configuration. + ReTrace reTrace = new ReTrace(ReTrace.STACK_TRACE_EXPRESSION, + verbose, + mappingFile); + + // Run it. + reTrace.execute(); + } + catch (Exception ex) + { + // Print out the exception message. + System.out.println(ex.getMessage()); + + // Show a dialog as well. + MessageDialogRunnable.showMessageDialog(consoleTextArea, + ex.getMessage(), + msg("errorReTracing"), + JOptionPane.ERROR_MESSAGE); + } + catch (OutOfMemoryError er) + { + // Forget about the ProGuard object as quickly as possible. + System.gc(); + + // Print out a message suggesting what to do next. + System.out.println(msg("outOfMemory")); + + // Show a dialog as well. + MessageDialogRunnable.showMessageDialog(consoleTextArea, + msg("outOfMemory"), + msg("errorReTracing"), + JOptionPane.ERROR_MESSAGE); + } + + // Make sure all output has been sent to the console text area. + printStream.flush(); + + // Restore the old System's in, out, and err streams. + System.setIn(oldIn); + System.setOut(oldOut); + System.setErr(oldErr); + + consoleTextArea.setCursor(Cursor.getPredefinedCursor(Cursor.DEFAULT_CURSOR)); + consoleTextArea.setCaretPosition(0); + + // Reset the global static redirection lock. + ProGuardGUI.systemOutRedirected = false; + } + + + // Small utility methods. + + /** + * Returns the message from the GUI resources that corresponds to the given + * key. + */ + private String msg(String messageKey) + { + return GUIResources.getMessage(messageKey); + } +} diff --git a/src/proguard/gui/SwingUtil.java b/src/proguard/gui/SwingUtil.java new file mode 100644 index 0000000..75d2f02 --- /dev/null +++ b/src/proguard/gui/SwingUtil.java @@ -0,0 +1,82 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import javax.swing.*; +import java.lang.reflect.InvocationTargetException; + + +/** + * This utility class provides variants of the invocation method from the + * SwingUtilities class. + * + * @see SwingUtilities + * @author Eric Lafortune + */ +public class SwingUtil +{ + /** + * Invokes the given Runnable in the AWT event dispatching thread, + * and waits for it to finish. This method may be called from any thread, + * including the event dispatching thread itself. + * @see SwingUtilities#invokeAndWait(Runnable) + * @param runnable the Runnable to be executed. + */ + public static void invokeAndWait(Runnable runnable) + throws InterruptedException, InvocationTargetException + { + try + { + if (SwingUtilities.isEventDispatchThread()) + { + runnable.run(); + } + else + { + SwingUtilities.invokeAndWait(runnable); + } + } + catch (Exception ex) + { + // Ignore any exceptions. + } + } + + + /** + * Invokes the given Runnable in the AWT event dispatching thread, not + * necessarily right away. This method may be called from any thread, + * including the event dispatching thread itself. + * @see SwingUtilities#invokeLater(Runnable) + * @param runnable the Runnable to be executed. + */ + public static void invokeLater(Runnable runnable) + { + if (SwingUtilities.isEventDispatchThread()) + { + runnable.run(); + } + else + { + SwingUtilities.invokeLater(runnable); + } + } +} diff --git a/src/proguard/gui/TabbedPane.java b/src/proguard/gui/TabbedPane.java new file mode 100644 index 0000000..a6460f5 --- /dev/null +++ b/src/proguard/gui/TabbedPane.java @@ -0,0 +1,229 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import javax.swing.*; +import java.awt.*; +import java.awt.event.*; + + +/** + * This Jpanel is similar to a JTabbedPane. + * It uses buttons on the left-hand side to switch between panels. + * An image can be added below these buttons. + * Some methods are provided to switch between tabs. + * + * @author Eric Lafortune + */ +public class TabbedPane + extends JPanel +{ + private final CardLayout cardLayout = new CardLayout(); + private final JPanel cardPanel = new JPanel(cardLayout); + private final ButtonGroup buttonGroup = new ButtonGroup(); + + + /** + * Creates a new TabbedPane. + */ + public TabbedPane() + { + GridBagLayout layout = new GridBagLayout(); + setLayout(layout); + + GridBagConstraints cardConstraints = new GridBagConstraints(); + cardConstraints.gridx = 1; + cardConstraints.gridy = 0; + cardConstraints.gridheight = GridBagConstraints.REMAINDER; + cardConstraints.fill = GridBagConstraints.BOTH; + cardConstraints.weightx = 1.0; + cardConstraints.weighty = 1.0; + cardConstraints.anchor = GridBagConstraints.NORTHWEST; + + add(cardPanel, cardConstraints); + } + + + /** + * Adds a component with a given title to the tabbed pane. + * + * @param title the title that will be used in the tab button. + * @param component the component that will be added as a tab. + */ + public Component add(final String title, Component component) + { + GridBagConstraints buttonConstraints = new GridBagConstraints(); + buttonConstraints.gridx = 0; + buttonConstraints.fill = GridBagConstraints.HORIZONTAL; + buttonConstraints.anchor = GridBagConstraints.NORTHWEST; + buttonConstraints.ipadx = 10; + buttonConstraints.ipady = 4; + + JToggleButton button = new JToggleButton(title); + + // Let the button react on the mouse press, instead of waiting for the + // mouse release. + button.setModel(new JToggleButton.ToggleButtonModel() + { + public void setPressed(boolean b) + { + if ((isPressed() == b) || !isEnabled()) + { + return; + } + + if (!b && isArmed()) + { + setSelected(!this.isSelected()); + } + + if (b) + { + stateMask |= PRESSED; + } + else + { + stateMask &= ~PRESSED; + } + + fireStateChanged(); + + if (isPressed()) + { + fireActionPerformed(new ActionEvent(this, ActionEvent.ACTION_PERFORMED, getActionCommand())); + } + } + + }); + + // Switch to the tab on a button press. + button.addActionListener(new ActionListener() + { + public void actionPerformed(ActionEvent e) + { + cardLayout.show(cardPanel, title); + } + }); + + // Only one button can be selected at the same time. + buttonGroup.add(button); + + // If this is the first tab, make sure its button is selected. + if (cardPanel.getComponentCount() == 0) + { + button.setSelected(true); + } + + // Add the button and its panel. + add(button, buttonConstraints); + cardPanel.add(title, component); + + return component; + } + + + /** + * Adds an image below the tab buttons, after all tabs have been added. + * The image will only be as visible as permitted by the available space. + * + * @param image the image. + * @return the component containing the image. + */ + public Component addImage(final Image image) + { + GridBagConstraints imageConstraints = new GridBagConstraints(); + imageConstraints.gridx = 0; + imageConstraints.weighty = 1.0; + imageConstraints.fill = GridBagConstraints.BOTH; + imageConstraints.anchor = GridBagConstraints.SOUTHWEST; + + JButton component = new JButton(new ImageIcon(image)); + component.setFocusPainted(false); + component.setFocusable(false); + component.setRequestFocusEnabled(false); + component.setRolloverEnabled(false); + component.setMargin(new Insets(0, 0, 0, 0)); + component.setHorizontalAlignment(JButton.LEFT); + component.setVerticalAlignment(JButton.BOTTOM); + component.setPreferredSize(new Dimension(0, 0)); + + add(component, imageConstraints); + + return component; + } + + + /** + * Selects the first tab. + */ + public void first() + { + cardLayout.first(cardPanel); + updateButtonSelection(); + } + + + /** + * Selects the last tab. + */ + public void last() + { + cardLayout.last(cardPanel); + updateButtonSelection(); + } + + + /** + * Selects the previous tab. + */ + public void previous() + { + cardLayout.previous(cardPanel); + updateButtonSelection(); + } + + + /** + * Selects the next tab. + */ + public void next() + { + cardLayout.next(cardPanel); + updateButtonSelection(); + } + + + /** + * Lets the button selection reflect the currently visible panel. + */ + private void updateButtonSelection() + { + int count = cardPanel.getComponentCount(); + for (int index = 0 ; index < count ; index++) { + Component card = cardPanel.getComponent(index); + if (card.isShowing()) + { + JToggleButton button = (JToggleButton)getComponent(index+1); + button.setSelected(true); + } + } + } +} diff --git a/src/proguard/gui/TextAreaOutputStream.java b/src/proguard/gui/TextAreaOutputStream.java new file mode 100644 index 0000000..57f983d --- /dev/null +++ b/src/proguard/gui/TextAreaOutputStream.java @@ -0,0 +1,81 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui; + +import javax.swing.*; +import java.io.*; +import java.lang.reflect.InvocationTargetException; + + +/** + * This PrintStream appends its output to a given text area. + * + * @author Eric Lafortune + */ +final class TextAreaOutputStream extends FilterOutputStream implements Runnable +{ + private final JTextArea textArea; + + + public TextAreaOutputStream(JTextArea textArea) + { + super(new ByteArrayOutputStream()); + + this.textArea = textArea; + } + + + // Implementation for FilterOutputStream. + + public void flush() throws IOException + { + super.flush(); + + try + { + // Append the accumulated buffer contents to the text area. + SwingUtil.invokeAndWait(this); + } + catch (Exception e) + { + // Nothing. + } + } + + + // Implementation for Runnable. + + public void run() + { + ByteArrayOutputStream out = (ByteArrayOutputStream)super.out; + + // Has any new text been written? + String text = out.toString(); + if (text.length() > 0) + { + // Append the accumulated text to the text area. + textArea.append(text); + + // Clear the buffer. + out.reset(); + } + } +} diff --git a/src/proguard/gui/arrow.gif b/src/proguard/gui/arrow.gif new file mode 100644 index 0000000000000000000000000000000000000000..c58e34ea4726f80091a00338154b01a88132c1b5 GIT binary patch literal 112 zcmZ?wbhEHblwlBHSjfQe|NsB9XU{%+_U!-v|B63Z7`Ygj8FUyJ7#KkE3`~x5`d6NQ z%e<&(ePe@hghN1C>Wt+r_rkhvTDCqeFL~v&f5pRVyLzAR_G|i4w@6q?NkJ^Jb6Rob SYLm*K2^+i4X7REzSOWlPZZNO_ literal 0 HcmV?d00001 diff --git a/src/proguard/gui/boilerplate.pro b/src/proguard/gui/boilerplate.pro new file mode 100644 index 0000000..70efb82 --- /dev/null +++ b/src/proguard/gui/boilerplate.pro @@ -0,0 +1,410 @@ +# Keep - Applications. Keep all application classes, along with their 'main' +# methods. +-keepclasseswithmembers public class * { + public static void main(java.lang.String[]); +} + +# Keep - Applets. Keep all extensions of java.applet.Applet. +-keep public class * extends java.applet.Applet + +# Keep - Servlets. Keep all extensions of javax.servlet.Servlet. +-keep public class * extends javax.servlet.Servlet + +# Keep - Midlets. Keep all extensions of javax.microedition.midlet.MIDlet. +-keep public class * extends javax.microedition.midlet.MIDlet + +# Keep - Xlets. Keep all extensions of javax.tv.xlet.Xlet. +-keep public class * extends javax.tv.xlet.Xlet + +# Keep - Library. Keep all public and protected classes, fields, and methods. +-keep public class * { + public protected ; + public protected ; +} + +# Also keep - Enumerations. Keep the special static methods that are required in +# enumeration classes. +-keepclassmembers enum * { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Also keep - Serialization code. Keep all fields and methods that are used for +# serialization. +-keepclassmembers class * extends java.io.Serializable { + static final long serialVersionUID; + static final java.io.ObjectStreamField[] serialPersistentFields; + private void writeObject(java.io.ObjectOutputStream); + private void readObject(java.io.ObjectInputStream); + java.lang.Object writeReplace(); + java.lang.Object readResolve(); +} + +# Also keep - BeanInfo classes. Keep all implementations of java.beans.BeanInfo. +-keep class * implements java.beans.BeanInfo + +# Also keep - Bean classes. Keep all specified classes, along with their getters +# and setters. +-keep class * { + void set*(***); + void set*(int,***); + + boolean is*(); + boolean is*(int); + + *** get*(); + *** get*(int); +} + +# Also keep - Database drivers. Keep all implementations of java.sql.Driver. +-keep class * implements java.sql.Driver + +# Also keep - Swing UI L&F. Keep all extensions of javax.swing.plaf.ComponentUI, +# along with the special 'createUI' method. +-keep class * extends javax.swing.plaf.ComponentUI { + public static javax.swing.plaf.ComponentUI createUI(javax.swing.JComponent); +} + +# Also keep - RMI interfaces. Keep all interfaces that extend the +# java.rmi.Remote interface, and their methods. +-keep interface * extends java.rmi.Remote { + ; +} + +# Also keep - RMI implementations. Keep all implementations of java.rmi.Remote, +# including any explicit or implicit implementations of Activatable, with their +# two-argument constructors. +-keep class * implements java.rmi.Remote { + (java.rmi.activation.ActivationID,java.rmi.MarshalledObject); +} + +# Keep names - Native method names. Keep all native class/method names. +-keepclasseswithmembernames class * { + native ; +} + +# Keep names - _class method names. Keep all .class method names. This may be +# useful for libraries that will be obfuscated again with different obfuscators. +-keepclassmembernames class * { + java.lang.Class class$(java.lang.String); + java.lang.Class class$(java.lang.String,boolean); +} + +# Remove - System method calls. Remove all invocations of System +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.System { + public static long currentTimeMillis(); + static java.lang.Class getCallerClass(); + public static int identityHashCode(java.lang.Object); + public static java.lang.SecurityManager getSecurityManager(); + public static java.util.Properties getProperties(); + public static java.lang.String getProperty(java.lang.String); + public static java.lang.String getenv(java.lang.String); + public static java.lang.String mapLibraryName(java.lang.String); + public static java.lang.String getProperty(java.lang.String,java.lang.String); +} + +# Remove - Math method calls. Remove all invocations of Math +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.Math { + public static double sin(double); + public static double cos(double); + public static double tan(double); + public static double asin(double); + public static double acos(double); + public static double atan(double); + public static double toRadians(double); + public static double toDegrees(double); + public static double exp(double); + public static double log(double); + public static double log10(double); + public static double sqrt(double); + public static double cbrt(double); + public static double IEEEremainder(double,double); + public static double ceil(double); + public static double floor(double); + public static double rint(double); + public static double atan2(double,double); + public static double pow(double,double); + public static int round(float); + public static long round(double); + public static double random(); + public static int abs(int); + public static long abs(long); + public static float abs(float); + public static double abs(double); + public static int max(int,int); + public static long max(long,long); + public static float max(float,float); + public static double max(double,double); + public static int min(int,int); + public static long min(long,long); + public static float min(float,float); + public static double min(double,double); + public static double ulp(double); + public static float ulp(float); + public static double signum(double); + public static float signum(float); + public static double sinh(double); + public static double cosh(double); + public static double tanh(double); + public static double hypot(double,double); + public static double expm1(double); + public static double log1p(double); +} + +# Remove - Number method calls. Remove all invocations of Number +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.* extends java.lang.Number { + public static java.lang.String toString(byte); + public static java.lang.Byte valueOf(byte); + public static byte parseByte(java.lang.String); + public static byte parseByte(java.lang.String,int); + public static java.lang.Byte valueOf(java.lang.String,int); + public static java.lang.Byte valueOf(java.lang.String); + public static java.lang.Byte decode(java.lang.String); + public int compareTo(java.lang.Byte); + + public static java.lang.String toString(short); + public static short parseShort(java.lang.String); + public static short parseShort(java.lang.String,int); + public static java.lang.Short valueOf(java.lang.String,int); + public static java.lang.Short valueOf(java.lang.String); + public static java.lang.Short valueOf(short); + public static java.lang.Short decode(java.lang.String); + public static short reverseBytes(short); + public int compareTo(java.lang.Short); + + public static java.lang.String toString(int,int); + public static java.lang.String toHexString(int); + public static java.lang.String toOctalString(int); + public static java.lang.String toBinaryString(int); + public static java.lang.String toString(int); + public static int parseInt(java.lang.String,int); + public static int parseInt(java.lang.String); + public static java.lang.Integer valueOf(java.lang.String,int); + public static java.lang.Integer valueOf(java.lang.String); + public static java.lang.Integer valueOf(int); + public static java.lang.Integer getInteger(java.lang.String); + public static java.lang.Integer getInteger(java.lang.String,int); + public static java.lang.Integer getInteger(java.lang.String,java.lang.Integer); + public static java.lang.Integer decode(java.lang.String); + public static int highestOneBit(int); + public static int lowestOneBit(int); + public static int numberOfLeadingZeros(int); + public static int numberOfTrailingZeros(int); + public static int bitCount(int); + public static int rotateLeft(int,int); + public static int rotateRight(int,int); + public static int reverse(int); + public static int signum(int); + public static int reverseBytes(int); + public int compareTo(java.lang.Integer); + + public static java.lang.String toString(long,int); + public static java.lang.String toHexString(long); + public static java.lang.String toOctalString(long); + public static java.lang.String toBinaryString(long); + public static java.lang.String toString(long); + public static long parseLong(java.lang.String,int); + public static long parseLong(java.lang.String); + public static java.lang.Long valueOf(java.lang.String,int); + public static java.lang.Long valueOf(java.lang.String); + public static java.lang.Long valueOf(long); + public static java.lang.Long decode(java.lang.String); + public static java.lang.Long getLong(java.lang.String); + public static java.lang.Long getLong(java.lang.String,long); + public static java.lang.Long getLong(java.lang.String,java.lang.Long); + public static long highestOneBit(long); + public static long lowestOneBit(long); + public static int numberOfLeadingZeros(long); + public static int numberOfTrailingZeros(long); + public static int bitCount(long); + public static long rotateLeft(long,int); + public static long rotateRight(long,int); + public static long reverse(long); + public static int signum(long); + public static long reverseBytes(long); + public int compareTo(java.lang.Long); + + public static java.lang.String toString(float); + public static java.lang.String toHexString(float); + public static java.lang.Float valueOf(java.lang.String); + public static java.lang.Float valueOf(float); + public static float parseFloat(java.lang.String); + public static boolean isNaN(float); + public static boolean isInfinite(float); + public static int floatToIntBits(float); + public static int floatToRawIntBits(float); + public static float intBitsToFloat(int); + public static int compare(float,float); + public boolean isNaN(); + public boolean isInfinite(); + public int compareTo(java.lang.Float); + + public static java.lang.String toString(double); + public static java.lang.String toHexString(double); + public static java.lang.Double valueOf(java.lang.String); + public static java.lang.Double valueOf(double); + public static double parseDouble(java.lang.String); + public static boolean isNaN(double); + public static boolean isInfinite(double); + public static long doubleToLongBits(double); + public static long doubleToRawLongBits(double); + public static double longBitsToDouble(long); + public static int compare(double,double); + public boolean isNaN(); + public boolean isInfinite(); + public int compareTo(java.lang.Double); + + public (byte); + public (short); + public (int); + public (long); + public (float); + public (double); + public (java.lang.String); + public byte byteValue(); + public short shortValue(); + public int intValue(); + public long longValue(); + public float floatValue(); + public double doubleValue(); + + public int compareTo(java.lang.Object); + public boolean equals(java.lang.Object); + public int hashCode(); + public java.lang.String toString(); +} + +# Remove - String method calls. Remove all invocations of String +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.String { + public java.lang.String(); + public java.lang.String(byte[]); + public java.lang.String(byte[],int); + public java.lang.String(byte[],int,int); + public java.lang.String(byte[],int,int,int); + public java.lang.String(byte[],int,int,java.lang.String); + public java.lang.String(byte[],java.lang.String); + public java.lang.String(char[]); + public java.lang.String(char[],int,int); + public java.lang.String(java.lang.String); + public java.lang.String(java.lang.StringBuffer); + public static java.lang.String copyValueOf(char[]); + public static java.lang.String copyValueOf(char[],int,int); + public static java.lang.String valueOf(boolean); + public static java.lang.String valueOf(char); + public static java.lang.String valueOf(char[]); + public static java.lang.String valueOf(char[],int,int); + public static java.lang.String valueOf(double); + public static java.lang.String valueOf(float); + public static java.lang.String valueOf(int); + public static java.lang.String valueOf(java.lang.Object); + public static java.lang.String valueOf(long); + public boolean contentEquals(java.lang.StringBuffer); + public boolean endsWith(java.lang.String); + public boolean equalsIgnoreCase(java.lang.String); + public boolean equals(java.lang.Object); + public boolean matches(java.lang.String); + public boolean regionMatches(boolean,int,java.lang.String,int,int); + public boolean regionMatches(int,java.lang.String,int,int); + public boolean startsWith(java.lang.String); + public boolean startsWith(java.lang.String,int); + public byte[] getBytes(); + public byte[] getBytes(java.lang.String); + public char charAt(int); + public char[] toCharArray(); + public int compareToIgnoreCase(java.lang.String); + public int compareTo(java.lang.Object); + public int compareTo(java.lang.String); + public int hashCode(); + public int indexOf(int); + public int indexOf(int,int); + public int indexOf(java.lang.String); + public int indexOf(java.lang.String,int); + public int lastIndexOf(int); + public int lastIndexOf(int,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.CharSequence subSequence(int,int); + public java.lang.String concat(java.lang.String); + public java.lang.String replaceAll(java.lang.String,java.lang.String); + public java.lang.String replace(char,char); + public java.lang.String replaceFirst(java.lang.String,java.lang.String); + public java.lang.String[] split(java.lang.String); + public java.lang.String[] split(java.lang.String,int); + public java.lang.String substring(int); + public java.lang.String substring(int,int); + public java.lang.String toLowerCase(); + public java.lang.String toLowerCase(java.util.Locale); + public java.lang.String toString(); + public java.lang.String toUpperCase(); + public java.lang.String toUpperCase(java.util.Locale); + public java.lang.String trim(); +} + +# Remove - StringBuffer method calls. Remove all invocations of StringBuffer +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.StringBuffer { + public java.lang.StringBuffer(); + public java.lang.StringBuffer(int); + public java.lang.StringBuffer(java.lang.String); + public java.lang.StringBuffer(java.lang.CharSequence); + public java.lang.String toString(); + public char charAt(int); + public int capacity(); + public int codePointAt(int); + public int codePointBefore(int); + public int indexOf(java.lang.String,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.String substring(int); + public java.lang.String substring(int,int); +} + +# Remove - StringBuilder method calls. Remove all invocations of StringBuilder +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.StringBuilder { + public java.lang.StringBuilder(); + public java.lang.StringBuilder(int); + public java.lang.StringBuilder(java.lang.String); + public java.lang.StringBuilder(java.lang.CharSequence); + public java.lang.String toString(); + public char charAt(int); + public int capacity(); + public int codePointAt(int); + public int codePointBefore(int); + public int indexOf(java.lang.String,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.String substring(int); + public java.lang.String substring(int,int); +} + +# Remove debugging - Throwable_printStackTrace calls. Remove all invocations of +# Throwable.printStackTrace(). +-assumenosideeffects public class java.lang.Throwable { + public void printStackTrace(); +} + +# Remove debugging - Thread_dumpStack calls. Remove all invocations of +# Thread.dumpStack(). +-assumenosideeffects public class java.lang.Thread { + public static void dumpStack(); +} + +# Remove debugging - All logging API calls. Remove all invocations of the +# logging API whose return values are not used. +-assumenosideeffects public class java.util.logging.* { + ; +} + +# Remove debugging - All Log4j API calls. Remove all invocations of the +# Log4j API whose return values are not used. +-assumenosideeffects public class org.apache.log4j.** { + ; +} diff --git a/src/proguard/gui/default.pro b/src/proguard/gui/default.pro new file mode 100644 index 0000000..3bfe2d6 --- /dev/null +++ b/src/proguard/gui/default.pro @@ -0,0 +1,318 @@ +# The default configuration when starting up the GUI. + +-libraryjars /lib/rt.jar + +# Keep - Applications. Keep all application classes, along with their 'main' +# methods. +-keepclasseswithmembers public class * { + public static void main(java.lang.String[]); +} + +# Also keep - Enumerations. Keep the special static methods that are required in +# enumeration classes. +-keepclassmembers enum * { + public static **[] values(); + public static ** valueOf(java.lang.String); +} + +# Also keep - Database drivers. Keep all implementations of java.sql.Driver. +-keep class * extends java.sql.Driver + +# Also keep - Swing UI L&F. Keep all extensions of javax.swing.plaf.ComponentUI, +# along with the special 'createUI' method. +-keep class * extends javax.swing.plaf.ComponentUI { + public static javax.swing.plaf.ComponentUI createUI(javax.swing.JComponent); +} + +# Keep names - Native method names. Keep all native class/method names. +-keepclasseswithmembers,allowshrinking class * { + native ; +} + +# Remove - System method calls. Remove all invocations of System +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.System { + public static long currentTimeMillis(); + static java.lang.Class getCallerClass(); + public static int identityHashCode(java.lang.Object); + public static java.lang.SecurityManager getSecurityManager(); + public static java.util.Properties getProperties(); + public static java.lang.String getProperty(java.lang.String); + public static java.lang.String getenv(java.lang.String); + public static java.lang.String mapLibraryName(java.lang.String); + public static java.lang.String getProperty(java.lang.String,java.lang.String); +} + +# Remove - Math method calls. Remove all invocations of Math +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.Math { + public static double sin(double); + public static double cos(double); + public static double tan(double); + public static double asin(double); + public static double acos(double); + public static double atan(double); + public static double toRadians(double); + public static double toDegrees(double); + public static double exp(double); + public static double log(double); + public static double log10(double); + public static double sqrt(double); + public static double cbrt(double); + public static double IEEEremainder(double,double); + public static double ceil(double); + public static double floor(double); + public static double rint(double); + public static double atan2(double,double); + public static double pow(double,double); + public static int round(float); + public static long round(double); + public static double random(); + public static int abs(int); + public static long abs(long); + public static float abs(float); + public static double abs(double); + public static int max(int,int); + public static long max(long,long); + public static float max(float,float); + public static double max(double,double); + public static int min(int,int); + public static long min(long,long); + public static float min(float,float); + public static double min(double,double); + public static double ulp(double); + public static float ulp(float); + public static double signum(double); + public static float signum(float); + public static double sinh(double); + public static double cosh(double); + public static double tanh(double); + public static double hypot(double,double); + public static double expm1(double); + public static double log1p(double); +} + +# Remove - Number method calls. Remove all invocations of Number +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.* extends java.lang.Number { + public static java.lang.String toString(byte); + public static java.lang.Byte valueOf(byte); + public static byte parseByte(java.lang.String); + public static byte parseByte(java.lang.String,int); + public static java.lang.Byte valueOf(java.lang.String,int); + public static java.lang.Byte valueOf(java.lang.String); + public static java.lang.Byte decode(java.lang.String); + public int compareTo(java.lang.Byte); + public static java.lang.String toString(short); + public static short parseShort(java.lang.String); + public static short parseShort(java.lang.String,int); + public static java.lang.Short valueOf(java.lang.String,int); + public static java.lang.Short valueOf(java.lang.String); + public static java.lang.Short valueOf(short); + public static java.lang.Short decode(java.lang.String); + public static short reverseBytes(short); + public int compareTo(java.lang.Short); + public static java.lang.String toString(int,int); + public static java.lang.String toHexString(int); + public static java.lang.String toOctalString(int); + public static java.lang.String toBinaryString(int); + public static java.lang.String toString(int); + public static int parseInt(java.lang.String,int); + public static int parseInt(java.lang.String); + public static java.lang.Integer valueOf(java.lang.String,int); + public static java.lang.Integer valueOf(java.lang.String); + public static java.lang.Integer valueOf(int); + public static java.lang.Integer getInteger(java.lang.String); + public static java.lang.Integer getInteger(java.lang.String,int); + public static java.lang.Integer getInteger(java.lang.String,java.lang.Integer); + public static java.lang.Integer decode(java.lang.String); + public static int highestOneBit(int); + public static int lowestOneBit(int); + public static int numberOfLeadingZeros(int); + public static int numberOfTrailingZeros(int); + public static int bitCount(int); + public static int rotateLeft(int,int); + public static int rotateRight(int,int); + public static int reverse(int); + public static int signum(int); + public static int reverseBytes(int); + public int compareTo(java.lang.Integer); + public static java.lang.String toString(long,int); + public static java.lang.String toHexString(long); + public static java.lang.String toOctalString(long); + public static java.lang.String toBinaryString(long); + public static java.lang.String toString(long); + public static long parseLong(java.lang.String,int); + public static long parseLong(java.lang.String); + public static java.lang.Long valueOf(java.lang.String,int); + public static java.lang.Long valueOf(java.lang.String); + public static java.lang.Long valueOf(long); + public static java.lang.Long decode(java.lang.String); + public static java.lang.Long getLong(java.lang.String); + public static java.lang.Long getLong(java.lang.String,long); + public static java.lang.Long getLong(java.lang.String,java.lang.Long); + public static long highestOneBit(long); + public static long lowestOneBit(long); + public static int numberOfLeadingZeros(long); + public static int numberOfTrailingZeros(long); + public static int bitCount(long); + public static long rotateLeft(long,int); + public static long rotateRight(long,int); + public static long reverse(long); + public static int signum(long); + public static long reverseBytes(long); + public int compareTo(java.lang.Long); + public static java.lang.String toString(float); + public static java.lang.String toHexString(float); + public static java.lang.Float valueOf(java.lang.String); + public static java.lang.Float valueOf(float); + public static float parseFloat(java.lang.String); + public static boolean isNaN(float); + public static boolean isInfinite(float); + public static int floatToIntBits(float); + public static int floatToRawIntBits(float); + public static float intBitsToFloat(int); + public static int compare(float,float); + public boolean isNaN(); + public boolean isInfinite(); + public int compareTo(java.lang.Float); + public static java.lang.String toString(double); + public static java.lang.String toHexString(double); + public static java.lang.Double valueOf(java.lang.String); + public static java.lang.Double valueOf(double); + public static double parseDouble(java.lang.String); + public static boolean isNaN(double); + public static boolean isInfinite(double); + public static long doubleToLongBits(double); + public static long doubleToRawLongBits(double); + public static double longBitsToDouble(long); + public static int compare(double,double); + public boolean isNaN(); + public boolean isInfinite(); + public int compareTo(java.lang.Double); + public (byte); + public (short); + public (int); + public (long); + public (float); + public (double); + public (java.lang.String); + public byte byteValue(); + public short shortValue(); + public int intValue(); + public long longValue(); + public float floatValue(); + public double doubleValue(); + public int compareTo(java.lang.Object); + public boolean equals(java.lang.Object); + public int hashCode(); + public java.lang.String toString(); +} + +# Remove - String method calls. Remove all invocations of String +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.String { + public (); + public (byte[]); + public (byte[],int); + public (byte[],int,int); + public (byte[],int,int,int); + public (byte[],int,int,java.lang.String); + public (byte[],java.lang.String); + public (char[]); + public (char[],int,int); + public (java.lang.String); + public (java.lang.StringBuffer); + public static java.lang.String copyValueOf(char[]); + public static java.lang.String copyValueOf(char[],int,int); + public static java.lang.String valueOf(boolean); + public static java.lang.String valueOf(char); + public static java.lang.String valueOf(char[]); + public static java.lang.String valueOf(char[],int,int); + public static java.lang.String valueOf(double); + public static java.lang.String valueOf(float); + public static java.lang.String valueOf(int); + public static java.lang.String valueOf(java.lang.Object); + public static java.lang.String valueOf(long); + public boolean contentEquals(java.lang.StringBuffer); + public boolean endsWith(java.lang.String); + public boolean equalsIgnoreCase(java.lang.String); + public boolean equals(java.lang.Object); + public boolean matches(java.lang.String); + public boolean regionMatches(boolean,int,java.lang.String,int,int); + public boolean regionMatches(int,java.lang.String,int,int); + public boolean startsWith(java.lang.String); + public boolean startsWith(java.lang.String,int); + public byte[] getBytes(); + public byte[] getBytes(java.lang.String); + public char charAt(int); + public char[] toCharArray(); + public int compareToIgnoreCase(java.lang.String); + public int compareTo(java.lang.Object); + public int compareTo(java.lang.String); + public int hashCode(); + public int indexOf(int); + public int indexOf(int,int); + public int indexOf(java.lang.String); + public int indexOf(java.lang.String,int); + public int lastIndexOf(int); + public int lastIndexOf(int,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.CharSequence subSequence(int,int); + public java.lang.String concat(java.lang.String); + public java.lang.String replaceAll(java.lang.String,java.lang.String); + public java.lang.String replace(char,char); + public java.lang.String replaceFirst(java.lang.String,java.lang.String); + public java.lang.String[] split(java.lang.String); + public java.lang.String[] split(java.lang.String,int); + public java.lang.String substring(int); + public java.lang.String substring(int,int); + public java.lang.String toLowerCase(); + public java.lang.String toLowerCase(java.util.Locale); + public java.lang.String toString(); + public java.lang.String toUpperCase(); + public java.lang.String toUpperCase(java.util.Locale); + public java.lang.String trim(); +} + +# Remove - StringBuffer method calls. Remove all invocations of StringBuffer +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.StringBuffer { + public (); + public (int); + public (java.lang.String); + public (java.lang.CharSequence); + public java.lang.String toString(); + public char charAt(int); + public int capacity(); + public int codePointAt(int); + public int codePointBefore(int); + public int indexOf(java.lang.String,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.String substring(int); + public java.lang.String substring(int,int); +} + +# Remove - StringBuilder method calls. Remove all invocations of StringBuilder +# methods without side effects whose return values are not used. +-assumenosideeffects public class java.lang.StringBuilder { + public (); + public (int); + public (java.lang.String); + public (java.lang.CharSequence); + public java.lang.String toString(); + public char charAt(int); + public int capacity(); + public int codePointAt(int); + public int codePointBefore(int); + public int indexOf(java.lang.String,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.String substring(int); + public java.lang.String substring(int,int); +} diff --git a/src/proguard/gui/package.html b/src/proguard/gui/package.html new file mode 100644 index 0000000..4eedcc2 --- /dev/null +++ b/src/proguard/gui/package.html @@ -0,0 +1,3 @@ + +This package contains a GUI for ProGuard and ReTrace. + diff --git a/src/proguard/gui/splash/BufferedSprite.java b/src/proguard/gui/splash/BufferedSprite.java new file mode 100644 index 0000000..8427832 --- /dev/null +++ b/src/proguard/gui/splash/BufferedSprite.java @@ -0,0 +1,145 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; +import java.awt.image.BufferedImage; + +/** + * This Sprite encapsulates another Sprite, which is then buffered in an Image. + * + * @author Eric Lafortune + */ +public class BufferedSprite implements Sprite +{ + private final int bufferX; + private final int bufferY; + private final Image bufferImage; + private final Color backgroundColor; + private final Sprite sprite; + private final VariableInt x; + private final VariableInt y; + + private long cachedTime = -1; + + + /** + * Creates a new BufferedSprite with an ABGR image. + * @param bufferX the x offset of the buffer image. + * @param bufferY the y offset of the buffer image. + * @param width the width of the buffer image. + * @param height the height of the buffer image. + * @param sprite the Sprite that is painted in the buffer. + * @param x the variable x ordinate of the image buffer for painting. + * @param y the variable y ordinate of the image buffer for painting. + * + */ + public BufferedSprite(int bufferX, + int bufferY, + int width, + int height, + Sprite sprite, + VariableInt x, + VariableInt y) + { + + this(bufferX, + bufferY, + new BufferedImage(width, height, BufferedImage.TYPE_4BYTE_ABGR), + null, + sprite, + x, + y); + } + + + /** + * Creates a new BufferedSprite with the given image. + * @param bufferX the x offset of the buffer image. + * @param bufferY the y offset of the buffer image. + * @param bufferImage the Image that is used for the buffering. + * @param backgroundColor the background color that is used for the buffer. + * @param sprite the Sprite that is painted in the buffer. + * @param x the variable x ordinate of the image buffer for + * painting. + * @param y the variable y ordinate of the image buffer for + * painting. + */ + public BufferedSprite(int bufferX, + int bufferY, + Image bufferImage, + Color backgroundColor, + Sprite sprite, + VariableInt x, + VariableInt y) + { + this.bufferX = bufferX; + this.bufferY = bufferY; + this.bufferImage = bufferImage; + this.backgroundColor = backgroundColor; + this.sprite = sprite; + this.x = x; + this.y = y; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + if (time != cachedTime) + { + Graphics bufferGraphics = bufferImage.getGraphics(); + + // Clear the background. + if (backgroundColor != null) + { + Graphics2D bufferGraphics2D = (Graphics2D)bufferGraphics; + bufferGraphics2D.setComposite(AlphaComposite.Clear); + bufferGraphics.fillRect(0, 0, bufferImage.getWidth(null), bufferImage.getHeight(null)); + bufferGraphics2D.setComposite(AlphaComposite.Src); + } + else + { + bufferGraphics.setColor(backgroundColor); + bufferGraphics.fillRect(0, 0, bufferImage.getWidth(null), bufferImage.getHeight(null)); + } + + // Set up the buffer graphics. + bufferGraphics.translate(-bufferX, -bufferY); + bufferGraphics.setColor(graphics.getColor()); + bufferGraphics.setFont(graphics.getFont()); + + // Draw the sprite. + sprite.paint(bufferGraphics, time); + + bufferGraphics.dispose(); + + cachedTime = time; + } + + // Draw the buffer image. + graphics.drawImage(bufferImage, + bufferX + x.getInt(time), + bufferY + y.getInt(time), + null); + } +} diff --git a/src/proguard/gui/splash/CircleSprite.java b/src/proguard/gui/splash/CircleSprite.java new file mode 100644 index 0000000..5dc65eb --- /dev/null +++ b/src/proguard/gui/splash/CircleSprite.java @@ -0,0 +1,74 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite represents an animated circle. It can optionally be filled. + * + * @author Eric Lafortune + */ +public class CircleSprite implements Sprite +{ + private final boolean filled; + private final VariableInt x; + private final VariableInt y; + private final VariableInt radius; + + + /** + * Creates a new CircleSprite. + * @param filled specifies whether the rectangle should be filled. + * @param x the variable x-coordinate of the center of the circle. + * @param y the variable y-coordinate of the center of the circle. + * @param radius the variable radius of the circle. + */ + public CircleSprite(boolean filled, + VariableInt x, + VariableInt y, + VariableInt radius) + { + this.filled = filled; + this.x = x; + this.y = y; + this.radius = radius; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + int xt = x.getInt(time); + int yt = y.getInt(time); + int r = radius.getInt(time); + + if (filled) + { + graphics.fillOval(xt - r, yt - r, 2 * r, 2 * r); + } + else + { + graphics.drawOval(xt - r, yt - r, 2 * r, 2 * r); + } + } +} diff --git a/src/proguard/gui/splash/ClipSprite.java b/src/proguard/gui/splash/ClipSprite.java new file mode 100644 index 0000000..55f9eac --- /dev/null +++ b/src/proguard/gui/splash/ClipSprite.java @@ -0,0 +1,85 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite encapsulates another Sprite, which is clipped by a clip Sprite. + * + * @author Eric Lafortune + */ +public class ClipSprite implements Sprite +{ + private final VariableColor insideClipColor; + private final VariableColor outsideClipColor; + private final Sprite clipSprite; + private final Sprite sprite; + + + /** + * Creates a new ClipSprite. + * @param insideClipColor the background color inside the clip sprite. + * @param outsideClipColor the background color outside the clip sprite. + * @param clipSprite the clip Sprite. + * @param sprite the clipped Sprite. + */ + public ClipSprite(VariableColor insideClipColor, + VariableColor outsideClipColor, + Sprite clipSprite, + Sprite sprite) + { + this.insideClipColor = insideClipColor; + this.outsideClipColor = outsideClipColor; + this.clipSprite = clipSprite; + this.sprite = sprite; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + // Clear the background. + Color outsideColor = outsideClipColor.getColor(time); + Rectangle clip = graphics.getClipBounds(); + graphics.setPaintMode(); + graphics.setColor(outsideColor); + graphics.fillRect(0, 0, clip.width, clip.height); + + // Draw the sprite in XOR mode. + OverrideGraphics2D g = new OverrideGraphics2D((Graphics2D)graphics); + Color insideColor = insideClipColor.getColor(time); + g.setOverrideXORMode(insideColor); + sprite.paint(g, time); + g.setOverrideXORMode(null); + + // Clear the clip area. + g.setOverrideColor(insideColor); + clipSprite.paint(g, time); + g.setOverrideColor(null); + + // Draw the sprite in XOR mode. + g.setOverrideXORMode(insideColor); + sprite.paint(g, time); + g.setOverrideXORMode(null); + } +} diff --git a/src/proguard/gui/splash/ColorSprite.java b/src/proguard/gui/splash/ColorSprite.java new file mode 100644 index 0000000..3f9bc3b --- /dev/null +++ b/src/proguard/gui/splash/ColorSprite.java @@ -0,0 +1,65 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite colors another given sprite. + * + * @author Eric Lafortune + */ +public class ColorSprite implements Sprite +{ + private final VariableColor color; + private final Sprite sprite; + + + /** + * Creates a new ColorSprite. + * @param color the variable color of the given sprite. + * @param sprite the sprite that will be colored and painted. + */ + public ColorSprite(VariableColor color, + Sprite sprite) + { + this.color = color; + this.sprite = sprite; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + // Save the old color. + Color oldColor = graphics.getColor(); + + // Set the new color. + graphics.setColor(color.getColor(time)); + + // Paint the actual sprite. + sprite.paint(graphics, time); + + // Restore the old color. + graphics.setColor(oldColor); + } +} diff --git a/src/proguard/gui/splash/CompositeSprite.java b/src/proguard/gui/splash/CompositeSprite.java new file mode 100644 index 0000000..2480ead --- /dev/null +++ b/src/proguard/gui/splash/CompositeSprite.java @@ -0,0 +1,56 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite is the composition of a list of Sprite objects. + * + * @author Eric Lafortune + */ +public class CompositeSprite implements Sprite +{ + private final Sprite[] sprites; + + + /** + * Creates a new CompositeSprite. + * @param sprites the array of Sprite objects to which the painting will + * be delegated, starting with the first element. + */ + public CompositeSprite(Sprite[] sprites) + { + this.sprites = sprites; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + // Draw the sprites. + for (int index = 0; index < sprites.length; index++) + { + sprites[index].paint(graphics, time); + } + } +} diff --git a/src/proguard/gui/splash/ConstantColor.java b/src/proguard/gui/splash/ConstantColor.java new file mode 100644 index 0000000..94c78df --- /dev/null +++ b/src/proguard/gui/splash/ConstantColor.java @@ -0,0 +1,51 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This VariableColor is constant over time. + * + * @author Eric Lafortune + */ +public class ConstantColor implements VariableColor +{ + private final Color value; + + + /** + * Creates a new ConstantColor. + * @param value the constant value. + */ + public ConstantColor(Color value) + { + this.value = value; + } + + + // Implementation for VariableColor. + + public Color getColor(long time) + { + return value; + } +} diff --git a/src/proguard/gui/splash/ConstantDouble.java b/src/proguard/gui/splash/ConstantDouble.java new file mode 100644 index 0000000..0874d6d --- /dev/null +++ b/src/proguard/gui/splash/ConstantDouble.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This VariableDouble is constant over time. + * + * @author Eric Lafortune + */ +public class ConstantDouble implements VariableDouble +{ + private final double value; + + + /** + * Creates a new ConstantDouble. + * @param value the constant value. + */ + public ConstantDouble(double value) + { + this.value = value; + } + + + // Implementation for VariableDouble. + + public double getDouble(long time) + { + return value; + } +} diff --git a/src/proguard/gui/splash/ConstantFont.java b/src/proguard/gui/splash/ConstantFont.java new file mode 100644 index 0000000..3f1ac03 --- /dev/null +++ b/src/proguard/gui/splash/ConstantFont.java @@ -0,0 +1,46 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This VariableFont is constant over time. + * + * @author Eric Lafortune + */ +public class ConstantFont implements VariableFont +{ + private final Font value; + + public ConstantFont(Font value) + { + this.value = value; + } + + + // Implementation for VariableFont. + + public Font getFont(long time) + { + return value; + } +} diff --git a/src/proguard/gui/splash/ConstantInt.java b/src/proguard/gui/splash/ConstantInt.java new file mode 100644 index 0000000..537196d --- /dev/null +++ b/src/proguard/gui/splash/ConstantInt.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This VariableInt is constant over time. + * + * @author Eric Lafortune + */ +public class ConstantInt implements VariableInt +{ + private final int value; + + + /** + * Creates a new ConstantInt. + * @param value the constant value. + */ + public ConstantInt(int value) + { + this.value = value; + } + + + // Implementation for VariableInt. + + public int getInt(long time) + { + return value; + } +} diff --git a/src/proguard/gui/splash/ConstantString.java b/src/proguard/gui/splash/ConstantString.java new file mode 100644 index 0000000..7617c3f --- /dev/null +++ b/src/proguard/gui/splash/ConstantString.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This VariableString is constant over time. + * + * @author Eric Lafortune + */ +public class ConstantString implements VariableString +{ + private final String value; + + + /** + * Creates a new ConstantString. + * @param value the constant value. + */ + public ConstantString(String value) + { + this.value = value; + } + + + // Implementation for VariableString. + + public String getString(long time) + { + return value; + } +} diff --git a/src/proguard/gui/splash/ConstantTiming.java b/src/proguard/gui/splash/ConstantTiming.java new file mode 100644 index 0000000..dfde644 --- /dev/null +++ b/src/proguard/gui/splash/ConstantTiming.java @@ -0,0 +1,57 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This Timing is constant over time. + * + * @author Eric Lafortune + */ +public class ConstantTiming implements Timing +{ + private final double timing; + + + /** + * Creates a new ConstantTiming with a value of 0. + */ + public ConstantTiming() + { + this(0.0); + } + + /** + * Creates a new ConstantTiming with a given value. + * @param timing the constant value of the timing. + */ + public ConstantTiming(double timing) + { + this.timing = timing; + } + + + // Implementation for Timing. + + public double getTiming(long time) + { + return timing; + } +} diff --git a/src/proguard/gui/splash/FontSprite.java b/src/proguard/gui/splash/FontSprite.java new file mode 100644 index 0000000..9a554ba --- /dev/null +++ b/src/proguard/gui/splash/FontSprite.java @@ -0,0 +1,65 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite sets the font for another given sprite. + * + * @author Eric Lafortune + */ +public class FontSprite implements Sprite +{ + private final VariableFont font; + private final Sprite sprite; + + + /** + * Creates a new FontSprite. + * @param font the variable Font of the given sprite. + * @param sprite the sprite that will be provided of a font and painted. + */ + public FontSprite(VariableFont font, + Sprite sprite) + { + this.font = font; + this.sprite = sprite; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + // Save the old font. + Font oldFont = graphics.getFont(); + + // Set the new font. + graphics.setFont(font.getFont(time)); + + // Paint the actual sprite. + sprite.paint(graphics, time); + + // Restore the old font. + graphics.setFont(oldFont); + } +} diff --git a/src/proguard/gui/splash/ImageSprite.java b/src/proguard/gui/splash/ImageSprite.java new file mode 100644 index 0000000..6e7c189 --- /dev/null +++ b/src/proguard/gui/splash/ImageSprite.java @@ -0,0 +1,76 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite represents an animated image. + * + * @author Eric Lafortune + */ +public class ImageSprite implements Sprite +{ + private final Image image; + private final VariableInt x; + private final VariableInt y; + private final VariableDouble scaleX; + private final VariableDouble scaleY; + + + /** + * Creates a new ImageSprite. + * @param image the Image to be painted. + * @param x the variable x-coordinate of the upper-left corner of the image. + * @param y the variable y-coordinate of the upper-left corner of the image. + * @param scaleX the variable x-scale of the image. + * @param scaleY the variable y-scale of the image. + */ + public ImageSprite(Image image, + VariableInt x, + VariableInt y, + VariableDouble scaleX, + VariableDouble scaleY) + { + this.image = image; + this.x = x; + this.y = y; + this.scaleX = scaleX; + this.scaleY = scaleY; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + int xt = x.getInt(time); + int yt = y.getInt(time); + + double scale_x = scaleX.getDouble(time); + double scale_y = scaleY.getDouble(time); + + int width = (int)(image.getWidth(null) * scale_x); + int height = (int)(image.getHeight(null) * scale_y); + + graphics.drawImage(image, xt, yt, width, height, null); + } +} diff --git a/src/proguard/gui/splash/LinearColor.java b/src/proguard/gui/splash/LinearColor.java new file mode 100644 index 0000000..3a7674d --- /dev/null +++ b/src/proguard/gui/splash/LinearColor.java @@ -0,0 +1,72 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This VariableColor varies linearly with respect to its Timing. + * + * @author Eric Lafortune + */ +public class LinearColor implements VariableColor +{ + private final Color fromValue; + private final Color toValue; + private final Timing timing; + + private double cachedTiming = -1.0; + private Color cachedColor; + + + /** + * Creates a new LinearColor. + * @param fromValue the value that corresponds to a timing of 0. + * @param toValue the value that corresponds to a timing of 1. + * @param timing the applied timing. + */ + public LinearColor(Color fromValue, Color toValue, Timing timing) + { + this.fromValue = fromValue; + this.toValue = toValue; + this.timing = timing; + } + + + // Implementation for VariableColor. + + public Color getColor(long time) + { + double t = timing.getTiming(time); + if (t != cachedTiming) + { + cachedTiming = t; + cachedColor = + t == 0.0 ? fromValue : + t == 1.0 ? toValue : + new Color((int)(fromValue.getRed() + t * (toValue.getRed() - fromValue.getRed())), + (int)(fromValue.getGreen() + t * (toValue.getGreen() - fromValue.getGreen())), + (int)(fromValue.getBlue() + t * (toValue.getBlue() - fromValue.getBlue()))); + } + + return cachedColor; + } +} diff --git a/src/proguard/gui/splash/LinearDouble.java b/src/proguard/gui/splash/LinearDouble.java new file mode 100644 index 0000000..046ae84 --- /dev/null +++ b/src/proguard/gui/splash/LinearDouble.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This VariableDouble varies linearly with respect to its Timing. + * + * @author Eric Lafortune + */ +public class LinearDouble implements VariableDouble +{ + private final double fromValue; + private final double toValue; + private final Timing timing; + + + /** + * Creates a new LinearDouble. + * @param fromValue the value that corresponds to a timing of 0. + * @param toValue the value that corresponds to a timing of 1. + * @param timing the applied timing. + */ + public LinearDouble(double fromValue, double toValue, Timing timing) + { + this.fromValue = fromValue; + this.toValue = toValue; + this.timing = timing; + } + + + // Implementation for VariableDouble. + + public double getDouble(long time) + { + return fromValue + timing.getTiming(time) * (toValue - fromValue); + } +} diff --git a/src/proguard/gui/splash/LinearInt.java b/src/proguard/gui/splash/LinearInt.java new file mode 100644 index 0000000..8d299bc --- /dev/null +++ b/src/proguard/gui/splash/LinearInt.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This VariableColor varies linearly with respect to its Timing. + * + * @author Eric Lafortune + */ +public class LinearInt implements VariableInt +{ + private final int fromValue; + private final int toValue; + private final Timing timing; + + + /** + * Creates a new LinearInt. + * @param fromValue the value that corresponds to a timing of 0. + * @param toValue the value that corresponds to a timing of 1. + * @param timing the applied timing. + */ + public LinearInt(int fromValue, int toValue, Timing timing) + { + this.fromValue = fromValue; + this.toValue = toValue; + this.timing = timing; + } + + + // Implementation for VariableInt. + + public int getInt(long time) + { + return (int) (fromValue + timing.getTiming(time) * (toValue - fromValue)); + } +} diff --git a/src/proguard/gui/splash/LinearTiming.java b/src/proguard/gui/splash/LinearTiming.java new file mode 100644 index 0000000..9b26644 --- /dev/null +++ b/src/proguard/gui/splash/LinearTiming.java @@ -0,0 +1,55 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This Timing ramps up linearly from 0 to 1 in a given time interval. + * + * @author Eric Lafortune + */ +public class LinearTiming implements Timing +{ + private final long fromTime; + private final long toTime; + + + /** + * Creates a new LinearTiming. + * @param fromTime the time at which the timing starts ramping up from 0. + * @param toTime the time at which the timing stops ramping up at 1. + */ + public LinearTiming(long fromTime, long toTime) + { + this.fromTime = fromTime; + this.toTime = toTime; + } + + + // Implementation for Timing. + + public double getTiming(long time) + { + // Compute the clamped linear interpolation. + return time <= fromTime ? 0.0 : + time >= toTime ? 1.0 : + (double)(time - fromTime) / (double)(toTime - fromTime); + } +} diff --git a/src/proguard/gui/splash/OverrideGraphics2D.java b/src/proguard/gui/splash/OverrideGraphics2D.java new file mode 100644 index 0000000..4333459 --- /dev/null +++ b/src/proguard/gui/splash/OverrideGraphics2D.java @@ -0,0 +1,598 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; +import java.awt.RenderingHints.Key; +import java.awt.font.*; +import java.awt.geom.AffineTransform; +import java.awt.image.*; +import java.awt.image.renderable.RenderableImage; +import java.text.AttributedCharacterIterator; +import java.util.Map; + +/** + * This Graphics2D allows to fix some basic settings (Color, Font, Paint, Stroke, + * XORMode) of a delegate Graphics2D, overriding any subsequent attempts to + * change those settings. + * + * @author Eric Lafortune + * @noinspection deprecation + */ +final class OverrideGraphics2D extends Graphics2D +{ + private final Graphics2D graphics; + + private Color overrideColor; + private Font overrideFont; + private Paint overridePaint; + private Stroke overrideStroke; + private Color overrideXORMode; + + private Color color; + private Font font; + private Paint paint; + private Stroke stroke; + + + /** + * Creates a new OverrideGraphics2D. + * @param graphics the delegate Graphics2D. + */ + public OverrideGraphics2D(Graphics2D graphics) + { + this.graphics = graphics; + this.color = graphics.getColor(); + this.font = graphics.getFont(); + this.paint = graphics.getPaint(); + this.stroke = graphics.getStroke(); + } + + + /** + * Fixes the Color of the Graphics2D. + * + * @param color the fixed Color, or null to undo the fixing. + */ + public void setOverrideColor(Color color) + { + this.overrideColor = color; + graphics.setColor(color != null ? color : this.color); + } + + /** + * Fixes the Font of the Graphics2D. + * + * @param font the fixed Font, or null to undo the fixing. + */ + public void setOverrideFont(Font font) + { + this.overrideFont = font; + graphics.setFont(font != null ? font : this.font); + } + + /** + * Fixes the Paint of the Graphics2D. + * + * @param paint the fixed Paint, or null to undo the fixing. + */ + public void setOverridePaint(Paint paint) + { + this.overridePaint = paint; + graphics.setPaint(paint != null ? paint : this.paint); + } + + /** + * Fixes the Stroke of the Graphics2D. + * + * @param stroke the fixed Stroke, or null to undo the fixing. + */ + public void setOverrideStroke(Stroke stroke) + { + this.overrideStroke = stroke; + graphics.setStroke(stroke != null ? stroke : this.stroke); + } + + /** + * Fixes the XORMode of the Graphics2D. + * + * @param color the fixed XORMode Color, or null to undo the fixing. + */ + public void setOverrideXORMode(Color color) + { + this.overrideXORMode = color; + if (color != null) + { + graphics.setXORMode(color); + } + else + { + graphics.setPaintMode(); + } + } + + + // Implementations for Graphics2D. + + public void setColor(Color color) + { + this.color = color; + if (overrideColor == null) + { + graphics.setColor(color); + } + } + + public void setFont(Font font) + { + this.font = font; + if (overrideFont == null) + { + graphics.setFont(font); + } + } + + public void setPaint(Paint paint) + { + this.paint = paint; + if (overridePaint == null) + { + graphics.setPaint(paint); + } + } + + public void setStroke(Stroke stroke) + { + this.stroke = stroke; + if (overrideStroke == null) + { + graphics.setStroke(stroke); + } + } + + public void setXORMode(Color color) + { + if (overrideXORMode == null) + { + graphics.setXORMode(color); + } + } + + public void setPaintMode() + { + if (overrideXORMode == null) + { + graphics.setPaintMode(); + } + } + + + public Color getColor() + { + return overrideColor != null ? color : graphics.getColor(); + } + + public Font getFont() + { + return overrideFont != null ? font : graphics.getFont(); + } + + public Paint getPaint() + { + return overridePaint != null ? paint : graphics.getPaint(); + } + + public Stroke getStroke() + { + return overrideStroke != null ? stroke : graphics.getStroke(); + } + + + public Graphics create() + { + OverrideGraphics2D g = new OverrideGraphics2D((Graphics2D)graphics.create()); + g.setOverrideColor(overrideColor); + g.setOverrideFont(overrideFont); + g.setOverridePaint(overridePaint); + g.setOverrideStroke(overrideStroke); + + return g; + } + + public Graphics create(int x, int y, int width, int height) + { + OverrideGraphics2D g = new OverrideGraphics2D((Graphics2D)graphics.create(x, y, width, height)); + g.setOverrideColor(overrideColor); + g.setOverrideFont(overrideFont); + g.setOverridePaint(overridePaint); + g.setOverrideStroke(overrideStroke); + + return g; + } + + + // Delegation for Graphics2D + + public void addRenderingHints(Map hints) + { + graphics.addRenderingHints(hints); + } + + public void clearRect(int x, int y, int width, int height) + { + graphics.clearRect(x, y, width, height); + } + + public void clip(Shape s) + { + graphics.clip(s); + } + + public void clipRect(int x, int y, int width, int height) + { + graphics.clipRect(x, y, width, height); + } + + public void copyArea(int x, int y, int width, int height, int dx, int dy) + { + graphics.copyArea(x, y, width, height, dx, dy); + } + + public void dispose() + { + graphics.dispose(); + } + + public void draw(Shape s) + { + graphics.draw(s); + } + + public void draw3DRect(int x, int y, int width, int height, boolean raised) + { + graphics.draw3DRect(x, y, width, height, raised); + } + + public void drawArc(int x, int y, int width, int height, int startAngle, int arcAngle) + { + graphics.drawArc(x, y, width, height, startAngle, arcAngle); + } + + public void drawBytes(byte[] data, int offset, int length, int x, int y) + { + graphics.drawBytes(data, offset, length, x, y); + } + + public void drawChars(char[] data, int offset, int length, int x, int y) + { + graphics.drawChars(data, offset, length, x, y); + } + + public void drawGlyphVector(GlyphVector g, float x, float y) + { + graphics.drawGlyphVector(g, x, y); + } + + public boolean drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, Color bgcolor, ImageObserver observer) + { + return graphics.drawImage(img, dx1, dy1, dx2, dy2, sx1, sy1, sx2, sy2, bgcolor, observer); + } + + public boolean drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer) + { + return graphics.drawImage(img, dx1, dy1, dx2, dy2, sx1, sy1, sx2, sy2, observer); + } + + public boolean drawImage(Image img, int x, int y, int width, int height, Color bgcolor, ImageObserver observer) + { + return graphics.drawImage(img, x, y, width, height, bgcolor, observer); + } + + public boolean drawImage(Image img, int x, int y, int width, int height, ImageObserver observer) + { + return graphics.drawImage(img, x, y, width, height, observer); + } + + public boolean drawImage(Image img, int x, int y, Color bgcolor, ImageObserver observer) + { + return graphics.drawImage(img, x, y, bgcolor, observer); + } + + public boolean drawImage(Image img, int x, int y, ImageObserver observer) + { + return graphics.drawImage(img, x, y, observer); + } + + public boolean drawImage(Image img, AffineTransform xform, ImageObserver obs) + { + return graphics.drawImage(img, xform, obs); + } + + public void drawImage(BufferedImage img, BufferedImageOp op, int x, int y) + { + graphics.drawImage(img, op, x, y); + } + + public void drawLine(int x1, int y1, int x2, int y2) + { + graphics.drawLine(x1, y1, x2, y2); + } + + public void drawOval(int x, int y, int width, int height) + { + graphics.drawOval(x, y, width, height); + } + + public void drawPolygon(int[] xPoints, int[] yPoints, int nPoints) + { + graphics.drawPolygon(xPoints, yPoints, nPoints); + } + + public void drawPolygon(Polygon p) + { + graphics.drawPolygon(p); + } + + public void drawPolyline(int[] xPoints, int[] yPoints, int nPoints) + { + graphics.drawPolyline(xPoints, yPoints, nPoints); + } + + public void drawRect(int x, int y, int width, int height) + { + graphics.drawRect(x, y, width, height); + } + + public void drawRenderableImage(RenderableImage img, AffineTransform xform) + { + graphics.drawRenderableImage(img, xform); + } + + public void drawRenderedImage(RenderedImage img, AffineTransform xform) + { + graphics.drawRenderedImage(img, xform); + } + + public void drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight) + { + graphics.drawRoundRect(x, y, width, height, arcWidth, arcHeight); + } + + public void drawString(String s, float x, float y) + { + graphics.drawString(s, x, y); + } + + public void drawString(String str, int x, int y) + { + graphics.drawString(str, x, y); + } + + public void drawString(AttributedCharacterIterator iterator, float x, float y) + { + graphics.drawString(iterator, x, y); + } + + public void drawString(AttributedCharacterIterator iterator, int x, int y) + { + graphics.drawString(iterator, x, y); + } + + public boolean equals(Object obj) + { + return graphics.equals(obj); + } + + public void fill(Shape s) + { + graphics.fill(s); + } + + public void fill3DRect(int x, int y, int width, int height, boolean raised) + { + graphics.fill3DRect(x, y, width, height, raised); + } + + public void fillArc(int x, int y, int width, int height, int startAngle, int arcAngle) + { + graphics.fillArc(x, y, width, height, startAngle, arcAngle); + } + + public void fillOval(int x, int y, int width, int height) + { + graphics.fillOval(x, y, width, height); + } + + public void fillPolygon(int[] xPoints, int[] yPoints, int nPoints) + { + graphics.fillPolygon(xPoints, yPoints, nPoints); + } + + public void fillPolygon(Polygon p) + { + graphics.fillPolygon(p); + } + + public void fillRect(int x, int y, int width, int height) + { + graphics.fillRect(x, y, width, height); + } + + public void fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight) + { + graphics.fillRoundRect(x, y, width, height, arcWidth, arcHeight); + } + + public Color getBackground() + { + return graphics.getBackground(); + } + + public Shape getClip() + { + return graphics.getClip(); + } + + public Rectangle getClipBounds() + { + return graphics.getClipBounds(); + } + + public Rectangle getClipBounds(Rectangle r) + { + return graphics.getClipBounds(r); + } + + public Rectangle getClipRect() + { + return graphics.getClipRect(); + } + + public Composite getComposite() + { + return graphics.getComposite(); + } + + public GraphicsConfiguration getDeviceConfiguration() + { + return graphics.getDeviceConfiguration(); + } + + public FontMetrics getFontMetrics() + { + return graphics.getFontMetrics(); + } + + public FontMetrics getFontMetrics(Font f) + { + return graphics.getFontMetrics(f); + } + + public FontRenderContext getFontRenderContext() + { + return graphics.getFontRenderContext(); + } + + public Object getRenderingHint(Key hintKey) + { + return graphics.getRenderingHint(hintKey); + } + + public RenderingHints getRenderingHints() + { + return graphics.getRenderingHints(); + } + + public AffineTransform getTransform() + { + return graphics.getTransform(); + } + + public int hashCode() + { + return graphics.hashCode(); + } + + public boolean hit(Rectangle rect, Shape s, boolean onStroke) + { + return graphics.hit(rect, s, onStroke); + } + + public boolean hitClip(int x, int y, int width, int height) + { + return graphics.hitClip(x, y, width, height); + } + + public void rotate(double theta) + { + graphics.rotate(theta); + } + + public void rotate(double theta, double x, double y) + { + graphics.rotate(theta, x, y); + } + + public void scale(double sx, double sy) + { + graphics.scale(sx, sy); + } + + public void setBackground(Color color) + { + graphics.setBackground(color); + } + + public void setClip(int x, int y, int width, int height) + { + graphics.setClip(x, y, width, height); + } + + public void setClip(Shape clip) + { + graphics.setClip(clip); + } + + public void setComposite(Composite comp) + { + graphics.setComposite(comp); + } + + public void setRenderingHint(Key hintKey, Object hintValue) + { + graphics.setRenderingHint(hintKey, hintValue); + } + + public void setRenderingHints(Map hints) + { + graphics.setRenderingHints(hints); + } + + public void setTransform(AffineTransform Tx) + { + graphics.setTransform(Tx); + } + + public void shear(double shx, double shy) + { + graphics.shear(shx, shy); + } + + public String toString() + { + return graphics.toString(); + } + + public void transform(AffineTransform Tx) + { + graphics.transform(Tx); + } + + public void translate(double tx, double ty) + { + graphics.translate(tx, ty); + } + + public void translate(int x, int y) + { + graphics.translate(x, y); + } +} diff --git a/src/proguard/gui/splash/RectangleSprite.java b/src/proguard/gui/splash/RectangleSprite.java new file mode 100644 index 0000000..d204831 --- /dev/null +++ b/src/proguard/gui/splash/RectangleSprite.java @@ -0,0 +1,114 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite represents an animated rounded rectangle. It can optionally be filled. + * + * @author Eric Lafortune + */ +public class RectangleSprite implements Sprite +{ + private final boolean filled; + private final VariableColor color; + private final VariableInt x; + private final VariableInt y; + private final VariableInt width; + private final VariableInt height; + private final VariableInt arcWidth; + private final VariableInt arcHeight; + + + /** + * Creates a new rectangular RectangleSprite. + * @param filled specifies whether the rectangle should be filled. + * @param color the variable color of the rectangle. + * @param x the variable x-ordinate of the upper-left corner of the rectangle. + * @param y the variable y-ordinate of the upper-left corner of the rectangle. + * @param width the variable width of the rectangle. + * @param height the variable height of the rectangle. + */ + public RectangleSprite(boolean filled, + VariableColor color, + VariableInt x, + VariableInt y, + VariableInt width, + VariableInt height) + { + this(filled, color, x, y, width, height, new ConstantInt(0), new ConstantInt(0)); + } + + + /** + * Creates a new RectangleSprite with rounded corners. + * @param filled specifies whether the rectangle should be filled. + * @param color the variable color of the rectangle. + * @param x the variable x-ordinate of the upper-left corner of the rectangle. + * @param y the variable y-ordinate of the upper-left corner of the rectangle. + * @param width the variable width of the rectangle. + * @param height the variable height of the rectangle. + * @param arcWidth the variable width of the corner arcs. + * @param arcHeight the variable height of the corner arcs. + */ + public RectangleSprite(boolean filled, + VariableColor color, + VariableInt x, + VariableInt y, + VariableInt width, + VariableInt height, + VariableInt arcWidth, + VariableInt arcHeight) + { + this.filled = filled; + this.color = color; + this.x = x; + this.y = y; + this.width = width; + this.height = height; + this.arcWidth = arcWidth; + this.arcHeight = arcHeight; + } + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + graphics.setColor(color.getColor(time)); + + int xt = x.getInt(time); + int yt = y.getInt(time); + int w = width.getInt(time); + int h = height.getInt(time); + int aw = arcWidth.getInt(time); + int ah = arcHeight.getInt(time); + + if (filled) + { + graphics.fillRoundRect(xt, yt, w, h, aw, ah); + } + else + { + graphics.drawRoundRect(xt, yt, w, h, aw, ah); + } + } +} diff --git a/src/proguard/gui/splash/SawToothTiming.java b/src/proguard/gui/splash/SawToothTiming.java new file mode 100644 index 0000000..076d5e2 --- /dev/null +++ b/src/proguard/gui/splash/SawToothTiming.java @@ -0,0 +1,53 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This Timing ramps up linearly from 0 to 1 in a given repeated time interval. + * + * @author Eric Lafortune + */ +public class SawToothTiming implements Timing +{ + private final long period; + private final long phase; + + + /** + * Creates a new SawToothTiming. + * @param period the time period for a full cycle. + * @param phase the phase of the cycle, which is added to the actual time. + */ + public SawToothTiming(long period, long phase) + { + this.period = period; + this.phase = phase; + } + + + // Implementation for Timing. + + public double getTiming(long time) + { + // Compute the translated and scaled saw-tooth function. + return (double)((time + phase) % period) / (double)period; + } +} diff --git a/src/proguard/gui/splash/ShadowedSprite.java b/src/proguard/gui/splash/ShadowedSprite.java new file mode 100644 index 0000000..c3504f3 --- /dev/null +++ b/src/proguard/gui/splash/ShadowedSprite.java @@ -0,0 +1,109 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite adds a drop shadow to another Sprite. + * + * @author Eric Lafortune + */ +public class ShadowedSprite implements Sprite +{ + private final VariableInt xOffset; + private final VariableInt yOffset; + private final VariableDouble alpha; + private final VariableInt blur; + private final Sprite sprite; + + private float cachedAlpha = -1.0f; + private Color cachedColor; + + + /** + * Creates a new ShadowedSprite. + * @param xOffset the variable x-offset of the shadow, relative to the sprite itself. + * @param yOffset the variable y-offset of the shadow, relative to the sprite itself. + * @param alpha the variable darkness of the shadow (between 0 and 1). + * @param blur the variable blur of the shadow (0 for sharp shadows, 1 or + * more for increasingly blurry shadows). + * @param sprite the Sprite to be painted with its shadow. + */ + public ShadowedSprite(VariableInt xOffset, + VariableInt yOffset, + VariableDouble alpha, + VariableInt blur, + Sprite sprite) + { + this.xOffset = xOffset; + this.yOffset = yOffset; + this.alpha = alpha; + this.blur = blur; + this.sprite = sprite; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + double l = alpha.getDouble(time); + int b = blur.getInt(time) + 1; + + float a = 1.0f - (float)Math.pow(1.0 - l, 1.0/(b*b)); + if (a != cachedAlpha) + { + cachedAlpha = a; + cachedColor = new Color(0f, 0f, 0f, a); + } + + // Set up the shadow graphics. + //OverrideGraphics2D g = new OverrideGraphics2D((Graphics2D)graphics); + //g.setOverrideColor(cachedColor); + + // Set the shadow color. + Color actualColor = graphics.getColor(); + graphics.setColor(cachedColor); + + int xo = xOffset.getInt(time) - b/2; + int yo = yOffset.getInt(time) - b/2; + + // Draw the sprite's shadow. + for (int x = 0; x < b; x++) + { + for (int y = 0; y < b; y++) + { + int xt = xo + x; + int yt = yo + y; + graphics.translate(xt, yt); + sprite.paint(graphics, time); + graphics.translate(-xt, -yt); + } + } + + // Restore the actual sprite color. + graphics.setColor(actualColor); + + // Draw the sprite itself in the ordinary graphics. + sprite.paint(graphics, time); + } +} diff --git a/src/proguard/gui/splash/SineTiming.java b/src/proguard/gui/splash/SineTiming.java new file mode 100644 index 0000000..eb0a7cc --- /dev/null +++ b/src/proguard/gui/splash/SineTiming.java @@ -0,0 +1,53 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This Timing varies between 0 and 1, as a sine wave over time. + * + * @author Eric Lafortune + */ +public class SineTiming implements Timing +{ + private final long period; + private final long phase; + + + /** + * Creates a new SineTiming. + * @param period the time period for a full cycle. + * @param phase the phase of the cycle, which is added to the actual time. + */ + public SineTiming(long period, long phase) + { + this.period = period; + this.phase = phase; + } + + + // Implementation for Timing. + + public double getTiming(long time) + { + // Compute the translated and scaled sine function. + return 0.5 + 0.5 * Math.sin(2.0 * Math.PI * (time + phase) / period); + } +} diff --git a/src/proguard/gui/splash/SmoothTiming.java b/src/proguard/gui/splash/SmoothTiming.java new file mode 100644 index 0000000..a985712 --- /dev/null +++ b/src/proguard/gui/splash/SmoothTiming.java @@ -0,0 +1,66 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This Timing ramps up smoothly from 0 to 1 in a given time interval. + * + * @author Eric Lafortune + */ +public class SmoothTiming implements Timing +{ + private final long fromTime; + private final long toTime; + + + /** + * Creates a new SmoothTiming. + * @param fromTime the time at which the timing starts ramping up from 0. + * @param toTime the time at which the timing stops ramping up at 1. + */ + public SmoothTiming(long fromTime, long toTime) + { + this.fromTime = fromTime; + this.toTime = toTime; + } + + + // Implementation for Timing. + + public double getTiming(long time) + { + if (time <= fromTime) + { + return 0.0; + } + + if (time >= toTime) + { + return 1.0; + } + + // Compute the linear interpolation. + double timing = (double) (time - fromTime) / (double) (toTime - fromTime); + + // Smooth the interpolation at the ends. + return timing * timing * (3.0 - 2.0 * timing); + } +} diff --git a/src/proguard/gui/splash/SplashPanel.java b/src/proguard/gui/splash/SplashPanel.java new file mode 100644 index 0000000..23a9ce4 --- /dev/null +++ b/src/proguard/gui/splash/SplashPanel.java @@ -0,0 +1,235 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import proguard.gui.SwingUtil; + +import javax.swing.*; +import java.awt.*; +import java.awt.event.*; +import java.lang.reflect.InvocationTargetException; + +/** + * This JPanel renders an animated Sprite. + * + * @author Eric Lafortune + */ +public class SplashPanel extends JPanel +{ + private final MyAnimator animator = new MyAnimator(); + private final MyRepainter repainter = new MyRepainter(); + + private final Sprite sprite; + private final double sleepFactor; + + private long startTime = Long.MAX_VALUE; + private final long stopTime; + + private volatile Thread animationThread; + + + /** + * Creates a new SplashPanel with the given Sprite, which will be animated + * indefinitely. + * @param sprite the Sprite that will be animated. + * @param processorLoad the fraction of processing time to be spend on + * animating the Sprite (between 0 and 1). + */ + public SplashPanel(Sprite sprite, double processorLoad) + { + this(sprite, processorLoad, (long)Integer.MAX_VALUE); + } + + + /** + * Creates a new SplashPanel with the given Sprite, which will be animated + * for a limited period of time. + * @param sprite the Sprite that will be animated. + * @param processorLoad the fraction of processing time to be spend on + * animating the Sprite (between 0 and 1). + * @param stopTime the number of milliseconds after which the + * animation will be stopped automatically. + */ + public SplashPanel(Sprite sprite, double processorLoad, long stopTime) + { + this.sprite = sprite; + this.sleepFactor = (1.0-processorLoad) / processorLoad; + this.stopTime = stopTime; + + // Restart the animation on a mouse click. + addMouseListener(new MouseAdapter() + { + public void mouseClicked(MouseEvent e) + { + SplashPanel.this.start(); + } + }); + } + + + /** + * Starts the animation. + */ + public void start() + { + // Go to the beginning of the animation. + startTime = System.currentTimeMillis(); + + // Make sure we have an animation thread running. + if (animationThread == null) + { + animationThread = new Thread(animator); + animationThread.start(); + } + } + + + /** + * Stops the animation. + */ + public void stop() + { + // Go to the end of the animation. + startTime = 0L; + + // Let the animation thread stop itself. + animationThread = null; + + // Repaint the SplashPanel one last time. + try + { + SwingUtil.invokeAndWait(repainter); + } + catch (InterruptedException ex) + { + // Nothing. + } + catch (InvocationTargetException ex) + { + // Nothing. + } + } + + + // Implementation for JPanel. + + public void paintComponent(Graphics graphics) + { + super.paintComponent(graphics); + + sprite.paint(graphics, System.currentTimeMillis() - startTime); + } + + + /** + * This Runnable makes sure its SplashPanel gets repainted regularly, + * depending on the targeted processor load. + */ + private class MyAnimator implements Runnable + { + public void run() + { + try + { + while (animationThread != null) + { + // Check if we should stop the animation. + long time = System.currentTimeMillis(); + if (time > startTime + stopTime) + { + animationThread = null; + } + + // Do a repaint and time it. + SwingUtil.invokeAndWait(repainter); + + // Sleep for a proportional while. + long repaintTime = System.currentTimeMillis() - time; + long sleepTime = (long)(sleepFactor * repaintTime); + if (sleepTime < 10L) + { + sleepTime = 10L; + } + + Thread.sleep(sleepTime); + } + } + catch (InterruptedException ex) + { + // Nothing. + } + catch (InvocationTargetException ex) + { + // Nothing. + } + } + } + + + /** + * This Runnable repaints its SplashPanel. + */ + private class MyRepainter implements Runnable + { + public void run() + { + SplashPanel.this.repaint(); + } + } + + + /** + * A main method for testing the splash panel. + */ + public static void main(String[] args) + { + JFrame frame = new JFrame(); + frame.setTitle("Animation"); + frame.setSize(800, 600); + Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize(); + Dimension frameSize = frame.getSize(); + frame.setLocation((screenSize.width - frameSize.width) / 2, + (screenSize.height - frameSize.height) / 2); + + Sprite sprite = + new ClipSprite( + new ConstantColor(Color.white), + new ConstantColor(Color.lightGray), + new CircleSprite(true, + new LinearInt(200, 600, new SineTiming(2345L, 0L)), + new LinearInt(200, 400, new SineTiming(3210L, 0L)), + new ConstantInt(150)), + new ColorSprite(new ConstantColor(Color.gray), + new FontSprite(new ConstantFont(new Font("sansserif", Font.BOLD, 90)), + new TextSprite(new ConstantString("ProGuard"), + new ConstantInt(200), + new ConstantInt(300))))); + + SplashPanel panel = new SplashPanel(sprite, 0.5); + panel.setBackground(Color.white); + + frame.getContentPane().add(panel); + frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); + frame.setVisible(true); + + panel.start(); + } +} diff --git a/src/proguard/gui/splash/Sprite.java b/src/proguard/gui/splash/Sprite.java new file mode 100644 index 0000000..ada7a81 --- /dev/null +++ b/src/proguard/gui/splash/Sprite.java @@ -0,0 +1,41 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This interface describes objects that can paint themselves, possibly varying + * as a function of time. + * + * @author Eric Lafortune + */ +public interface Sprite +{ + /** + * Paints the object. + * + * @param graphics the Graphics to paint on. + * @param time the time since the start of the animation, expressed in + * milliseconds. + */ + public void paint(Graphics graphics, long time); +} diff --git a/src/proguard/gui/splash/TextSprite.java b/src/proguard/gui/splash/TextSprite.java new file mode 100644 index 0000000..bbf37d4 --- /dev/null +++ b/src/proguard/gui/splash/TextSprite.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite represents a text. + * + * @author Eric Lafortune + */ +public class TextSprite implements Sprite +{ + private final VariableString[] text; + private final VariableInt spacing; + private final VariableInt x; + private final VariableInt y; + + + /** + * Creates a new TextSprite containing a single line of text. + * @param text the variable text string. + * @param x the variable x-coordinate of the lower-left corner of the text. + * @param y the variable y-coordinate of the lower-left corner of the text. + */ + public TextSprite(VariableString text, + VariableInt x, + VariableInt y) + { + this(new VariableString[] { text }, new ConstantInt(0), x, y); + } + + + /** + * Creates a new TextSprite containing a multiple lines of text. + * @param text the variable text strings. + * @param spacing the variable spacing between the lines of text. + * @param x the variable x-coordinate of the lower-left corner of the + * first line of text. + * @param y the variable y-coordinate of the lower-left corner of the + * first line of text. + */ + public TextSprite(VariableString[] text, + VariableInt spacing, + VariableInt x, + VariableInt y) + { + + this.text = text; + this.spacing = spacing; + this.x = x; + this.y = y; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + + int xt = x.getInt(time); + int yt = y.getInt(time); + + int spacingt = spacing.getInt(time); + + for (int index = 0; index < text.length; index++) + { + graphics.drawString(text[index].getString(time), xt, yt + index * spacingt); + } + } +} diff --git a/src/proguard/gui/splash/TimeSwitchSprite.java b/src/proguard/gui/splash/TimeSwitchSprite.java new file mode 100644 index 0000000..921bef2 --- /dev/null +++ b/src/proguard/gui/splash/TimeSwitchSprite.java @@ -0,0 +1,75 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This Sprite displays another Sprite in a given time interval. + * The time of the encapsulated Sprite is shifted by the start time. + * + * @author Eric Lafortune + */ +public class TimeSwitchSprite implements Sprite +{ + private final long onTime; + private final long offTime; + private final Sprite sprite; + + + /** + * Creates a new TimeSwitchSprite for displaying a given Sprite starting at + * a given time. + * @param onTime the start time. + * @param sprite the toggled Sprite. + */ + public TimeSwitchSprite(long onTime, Sprite sprite) + { + this(onTime, 0L, sprite); + } + + + /** + * Creates a new TimeSwitchSprite for displaying a given Sprite in a given + * time interval. + * @param onTime the start time. + * @param offTime the stop time. + * @param sprite the toggled Sprite. + */ + public TimeSwitchSprite(long onTime, long offTime, Sprite sprite) + { + this.onTime = onTime; + this.offTime = offTime; + this.sprite = sprite; + } + + + // Implementation for Sprite. + + public void paint(Graphics graphics, long time) + { + if (time >= onTime && (offTime <= 0 || time <= offTime)) + { + sprite.paint(graphics, time - onTime); + } + + } +} diff --git a/src/proguard/gui/splash/Timing.java b/src/proguard/gui/splash/Timing.java new file mode 100644 index 0000000..887d737 --- /dev/null +++ b/src/proguard/gui/splash/Timing.java @@ -0,0 +1,34 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This interface maps a time to a normalized timing between 0 and 1. + * + * @author Eric Lafortune + */ +interface Timing +{ + /** + * Returns the timing for the given time. + */ + public double getTiming(long time); +} diff --git a/src/proguard/gui/splash/TypeWriterString.java b/src/proguard/gui/splash/TypeWriterString.java new file mode 100644 index 0000000..9f1441e --- /dev/null +++ b/src/proguard/gui/splash/TypeWriterString.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This VariableString produces a String that grows linearly with respect to its + * Timing, as if it is being written on a typewriter. A cursor at the end + * precedes the typed characters. + * + * @author Eric Lafortune + */ +public class TypeWriterString implements VariableString +{ + private final String string; + private final Timing timing; + + private int cachedLength = -1; + private String cachedString; + + + /** + * Creates a new TypeWriterString. + * @param string the basic String. + * @param timing the applied timing. + */ + public TypeWriterString(String string, Timing timing) + { + this.string = string; + this.timing = timing; + } + + + // Implementation for VariableString. + + public String getString(long time) + { + double t = timing.getTiming(time); + + int stringLength = string.length(); + int length = (int)(stringLength * t + 0.5); + if (length != cachedLength) + { + cachedLength = length; + cachedString = string.substring(0, length); + if (t > 0.0 && length < stringLength) + { + cachedString += "_"; + } + } + + return cachedString; + } +} diff --git a/src/proguard/gui/splash/VariableColor.java b/src/proguard/gui/splash/VariableColor.java new file mode 100644 index 0000000..6a30062 --- /dev/null +++ b/src/proguard/gui/splash/VariableColor.java @@ -0,0 +1,36 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This interface represents a Color that varies with time. + * + * @author Eric Lafortune + */ +interface VariableColor +{ + /** + * Returns the Color for the given time. + */ + public Color getColor(long time); +} diff --git a/src/proguard/gui/splash/VariableDouble.java b/src/proguard/gui/splash/VariableDouble.java new file mode 100644 index 0000000..39302dd --- /dev/null +++ b/src/proguard/gui/splash/VariableDouble.java @@ -0,0 +1,34 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This interface represents a double that varies with time. + * + * @author Eric Lafortune + */ +interface VariableDouble +{ + /** + * Returns the double for the given time. + */ + public double getDouble(long time); +} diff --git a/src/proguard/gui/splash/VariableFont.java b/src/proguard/gui/splash/VariableFont.java new file mode 100644 index 0000000..a7de8d7 --- /dev/null +++ b/src/proguard/gui/splash/VariableFont.java @@ -0,0 +1,36 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This interface represents a Font that varies with time. + * + * @author Eric Lafortune + */ +interface VariableFont +{ + /** + * Returns the Font for the given time. + */ + public Font getFont(long time); +} diff --git a/src/proguard/gui/splash/VariableInt.java b/src/proguard/gui/splash/VariableInt.java new file mode 100644 index 0000000..68a33af --- /dev/null +++ b/src/proguard/gui/splash/VariableInt.java @@ -0,0 +1,34 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This interface represents an integer that varies with time. + * + * @author Eric Lafortune + */ +interface VariableInt +{ + /** + * Returns the integer for the given time. + */ + public int getInt(long time); +} diff --git a/src/proguard/gui/splash/VariableSizeFont.java b/src/proguard/gui/splash/VariableSizeFont.java new file mode 100644 index 0000000..e36d28c --- /dev/null +++ b/src/proguard/gui/splash/VariableSizeFont.java @@ -0,0 +1,65 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +import java.awt.*; + +/** + * This VariableFont varies in size with respect to its Timing. + * + * @author Eric Lafortune + */ +public class VariableSizeFont implements VariableFont +{ + private final Font font; + private final VariableDouble size; + + private float cachedSize = -1.0f; + private Font cachedFont; + + + /** + * Creates a new VariableSizeFont + * @param font the base font. + * @param size the variable size of the font. + */ + public VariableSizeFont(Font font, VariableDouble size) + { + this.font = font; + this.size = size; + } + + + // Implementation for VariableFont. + + public Font getFont(long time) + { + float s = (float)size.getDouble(time); + + if (s != cachedSize) + { + cachedSize = s; + cachedFont = font.deriveFont((float)s); + } + + return cachedFont; + } +} diff --git a/src/proguard/gui/splash/VariableString.java b/src/proguard/gui/splash/VariableString.java new file mode 100644 index 0000000..1dec23b --- /dev/null +++ b/src/proguard/gui/splash/VariableString.java @@ -0,0 +1,34 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.gui.splash; + +/** + * This interface represents a String that varies with time. + * + * @author Eric Lafortune + */ +interface VariableString +{ + /** + * Returns the String for the given time. + */ + public String getString(long time); +} diff --git a/src/proguard/gui/splash/package.html b/src/proguard/gui/splash/package.html new file mode 100644 index 0000000..209fad7 --- /dev/null +++ b/src/proguard/gui/splash/package.html @@ -0,0 +1,4 @@ + +This package contains a library for creating splash screens and animations +with text, graphical elements, and some special effects. + diff --git a/src/proguard/gui/vtitle.png b/src/proguard/gui/vtitle.png new file mode 100644 index 0000000000000000000000000000000000000000..218f71620e226a698a2b9d0b7b66cfc20ffad025 GIT binary patch literal 23313 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 literal 0 HcmV?d00001 diff --git a/src/proguard/io/CascadingDataEntryWriter.java b/src/proguard/io/CascadingDataEntryWriter.java new file mode 100644 index 0000000..15719e6 --- /dev/null +++ b/src/proguard/io/CascadingDataEntryWriter.java @@ -0,0 +1,94 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + +/** + * This DataEntryWriter delegates to a given DataEntryWriter, or failing that, + * to another given DataEntryWriter. + * + * @author Eric Lafortune + */ +public class CascadingDataEntryWriter implements DataEntryWriter +{ + private DataEntryWriter dataEntryWriter1; + private DataEntryWriter dataEntryWriter2; + + + /** + * Creates a new CascadingDataEntryWriter. + * @param dataEntryWriter1 the DataEntryWriter to which the writing will be + * delegated first. + * @param dataEntryWriter2 the DataEntryWriter to which the writing will be + * delegated, if the first one can't provide an + * output stream. + */ + public CascadingDataEntryWriter(DataEntryWriter dataEntryWriter1, + DataEntryWriter dataEntryWriter2) + { + this.dataEntryWriter1 = dataEntryWriter1; + this.dataEntryWriter2 = dataEntryWriter2; + } + + + // Implementations for DataEntryWriter. + + + public boolean createDirectory(DataEntry dataEntry) throws IOException + { + // Try to create a directory with the first data entry writer, or + // otherwise with the second data entry writer. + return dataEntryWriter1.createDirectory(dataEntry) || + dataEntryWriter2.createDirectory(dataEntry); + } + + + public OutputStream getOutputStream(DataEntry dataEntry) throws IOException + { + return getOutputStream(dataEntry, null); + } + + + public OutputStream getOutputStream(DataEntry dataEntry, + Finisher finisher) throws IOException + { + // Try to get an output stream from the first data entry writer. + OutputStream outputStream = + dataEntryWriter1.getOutputStream(dataEntry, finisher); + + // Return it, if it's not null. Otherwise try to get an output stream + // from the second data entry writer. + return outputStream != null ? + outputStream : + dataEntryWriter2.getOutputStream(dataEntry, finisher); + } + + + public void close() throws IOException + { + dataEntryWriter1.close(); + dataEntryWriter2.close(); + + dataEntryWriter1 = null; + dataEntryWriter2 = null; + } +} diff --git a/src/proguard/io/ClassFilter.java b/src/proguard/io/ClassFilter.java new file mode 100644 index 0000000..bf591ab --- /dev/null +++ b/src/proguard/io/ClassFilter.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; +import proguard.util.ExtensionMatcher; + +import java.io.IOException; + + +/** + * This DataEntryReader delegates to one of two other DataEntryReader instances, + * depending on the extension of the data entry. + * + * @author Eric Lafortune + */ +public class ClassFilter extends FilteredDataEntryReader +{ + /** + * Creates a new ClassFilter that delegates reading classes to the + * given reader. + */ + public ClassFilter(DataEntryReader classReader) + { + this(classReader, null); + } + + + /** + * Creates a new ClassFilter that delegates to either of the two given + * readers. + */ + public ClassFilter(DataEntryReader classReader, + DataEntryReader dataEntryReader) + { + super(new DataEntryNameFilter( + new ExtensionMatcher(ClassConstants.CLASS_FILE_EXTENSION)), + classReader, + dataEntryReader); + } +} diff --git a/src/proguard/io/ClassReader.java b/src/proguard/io/ClassReader.java new file mode 100644 index 0000000..e21968c --- /dev/null +++ b/src/proguard/io/ClassReader.java @@ -0,0 +1,115 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.*; +import proguard.classfile.io.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.ClassVisitor; + +import java.io.*; + +/** + * This DataEntryReader applies a given ClassVisitor to the class + * definitions that it reads. + *

    + * Class files are read as ProgramClass objects or LibraryClass objects, + * depending on the isLibrary flag. + *

    + * In case of libraries, only public classes are considered, if the + * skipNonPublicLibraryClasses flag is set. + * + * @author Eric Lafortune + */ +public class ClassReader implements DataEntryReader +{ + private final boolean isLibrary; + private final boolean skipNonPublicLibraryClasses; + private final boolean skipNonPublicLibraryClassMembers; + private final WarningPrinter warningPrinter; + private final ClassVisitor classVisitor; + + + /** + * Creates a new DataEntryClassFilter for reading the specified + * Clazz objects. + */ + public ClassReader(boolean isLibrary, + boolean skipNonPublicLibraryClasses, + boolean skipNonPublicLibraryClassMembers, + WarningPrinter warningPrinter, + ClassVisitor classVisitor) + { + this.isLibrary = isLibrary; + this.skipNonPublicLibraryClasses = skipNonPublicLibraryClasses; + this.skipNonPublicLibraryClassMembers = skipNonPublicLibraryClassMembers; + this.warningPrinter = warningPrinter; + this.classVisitor = classVisitor; + } + + + // Implementations for DataEntryReader. + + public void read(DataEntry dataEntry) throws IOException + { + try + { + // Get the input stream. + InputStream inputStream = dataEntry.getInputStream(); + + // Wrap it into a data input stream. + DataInputStream dataInputStream = new DataInputStream(inputStream); + + // Create a Clazz representation. + Clazz clazz; + if (isLibrary) + { + clazz = new LibraryClass(); + clazz.accept(new LibraryClassReader(dataInputStream, skipNonPublicLibraryClasses, skipNonPublicLibraryClassMembers)); + } + else + { + clazz = new ProgramClass(); + clazz.accept(new ProgramClassReader(dataInputStream)); + } + + // Apply the visitor, if we have a real class. + String className = clazz.getName(); + if (className != null) + { + if (!dataEntry.getName().replace(File.pathSeparatorChar, ClassConstants.INTERNAL_PACKAGE_SEPARATOR).equals(className+ClassConstants.CLASS_FILE_EXTENSION) && + warningPrinter != null) + { + warningPrinter.print(className, + "Warning: class [" + dataEntry.getName() + "] unexpectedly contains class [" + ClassUtil.externalClassName(className) + "]"); + } + + clazz.accept(classVisitor); + } + + dataEntry.closeInputStream(); + } + catch (Exception ex) + { + throw new IOException("Can't process class ["+dataEntry.getName()+"] ("+ex.getMessage()+")"); + } + } +} diff --git a/src/proguard/io/ClassRewriter.java b/src/proguard/io/ClassRewriter.java new file mode 100644 index 0000000..bd19e1d --- /dev/null +++ b/src/proguard/io/ClassRewriter.java @@ -0,0 +1,80 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.*; +import proguard.classfile.io.ProgramClassWriter; + +import java.io.*; + + +/** + * This DataEntryReader reads class entries and writes their corresponding + * versions from the ClassPool to a given DataEntryWriter. + * + * @author Eric Lafortune + */ +public class ClassRewriter implements DataEntryReader +{ + private final ClassPool classPool; + private final DataEntryWriter dataEntryWriter; + + + public ClassRewriter(ClassPool classPool, + DataEntryWriter dataEntryWriter) + { + this.classPool = classPool; + this.dataEntryWriter = dataEntryWriter; + } + + + // Implementations for DataEntryReader. + + public void read(DataEntry dataEntry) throws IOException + { + String inputName = dataEntry.getName(); + String className = inputName.substring(0, inputName.length() - ClassConstants.CLASS_FILE_EXTENSION.length()); + + // Find the modified class corrsponding to the input entry. + ProgramClass programClass = (ProgramClass)classPool.getClass(className); + if (programClass != null) + { + // Rename the data entry if necessary. + String newClassName = programClass.getName(); + if (!className.equals(newClassName)) + { + dataEntry = new RenamedDataEntry(dataEntry, newClassName + ClassConstants.CLASS_FILE_EXTENSION); + } + + // Get the output entry corresponding to this input entry. + OutputStream outputStream = dataEntryWriter.getOutputStream(dataEntry); + if (outputStream != null) + { + // Write the class to the output entry. + DataOutputStream classOutputStream = new DataOutputStream(outputStream); + + new ProgramClassWriter(classOutputStream).visitProgramClass(programClass); + + classOutputStream.flush(); + } + } + } +} diff --git a/src/proguard/io/DataEntry.java b/src/proguard/io/DataEntry.java new file mode 100644 index 0000000..af0e373 --- /dev/null +++ b/src/proguard/io/DataEntry.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + +/** + * This interface describes a data entry, e.g. a ZIP entry, a file, or a + * directory. + * + * @author Eric Lafortune + */ +public interface DataEntry +{ + /** + * Returns the name of this data entry. + */ + public String getName(); + + /** + * Returns whether the data entry represents a directory. + */ + public boolean isDirectory(); + + + /** + * Returns an input stream for reading the content of this data entry. + * The data entry may not represent a directory. + */ + public InputStream getInputStream() throws IOException; + + + /** + * Closes the previously retrieved InputStream. + */ + public void closeInputStream() throws IOException; + + + /** + * Returns the parent of this data entry, or null if it doesn't + * have one. + */ + public DataEntry getParent(); +} diff --git a/src/proguard/io/DataEntryCopier.java b/src/proguard/io/DataEntryCopier.java new file mode 100644 index 0000000..faaa555 --- /dev/null +++ b/src/proguard/io/DataEntryCopier.java @@ -0,0 +1,247 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.util.ExtensionMatcher; + +import java.io.*; + + +/** + * This DataEntryReader writes the ZIP entries and files that it reads to a + * given DataEntryWriter. + * + * @author Eric Lafortune + */ +public class DataEntryCopier implements DataEntryReader +{ + private static final int BUFFER_SIZE = 1024; + + private final DataEntryWriter dataEntryWriter; + private final byte[] buffer = new byte[BUFFER_SIZE]; + + + + public DataEntryCopier(DataEntryWriter dataEntryWriter) + { + this.dataEntryWriter = dataEntryWriter; + } + + + // Implementations for DataEntryReader. + + public void read(DataEntry dataEntry) throws IOException + { + try + { + if (dataEntry.isDirectory()) + { + dataEntryWriter.createDirectory(dataEntry); + } + else + { + // Get the output entry corresponding to this input entry. + OutputStream outputStream = dataEntryWriter.getOutputStream(dataEntry); + if (outputStream != null) + { + InputStream inputStream = dataEntry.getInputStream(); + + // Copy the data from the input entry to the output entry. + copyData(inputStream, outputStream); + + // Close the data entries. + dataEntry.closeInputStream(); + } + } + } + catch (IOException ex) + { + System.err.println("Warning: can't write resource [" + dataEntry.getName() + "] (" + ex.getMessage() + ")"); + } + } + + + /** + * Copies all data that it can read from the given input stream to the + * given output stream. + */ + protected void copyData(InputStream inputStream, + OutputStream outputStream) + throws IOException + { + while (true) + { + int count = inputStream.read(buffer); + if (count < 0) + { + break; + } + outputStream.write(buffer, 0, count); + } + + outputStream.flush(); + } + + + /** + * A main method for testing file/jar/war/directory copying. + */ + public static void main(String[] args) + { + try + { + String input = args[0]; + String output = args[1]; + + boolean outputIsJar = output.endsWith(".jar"); + boolean outputIsWar = output.endsWith(".war"); + boolean outputIsEar = output.endsWith(".ear"); + boolean outputIsZip = output.endsWith(".zip"); + + DataEntryWriter writer = new DirectoryWriter(new File(output), + outputIsJar || + outputIsWar || + outputIsEar || + outputIsZip); + + if (!outputIsJar) + { + // Zip up any zips, if necessary. + DataEntryWriter zipWriter = new JarWriter(writer); + if (outputIsZip) + { + // Always zip. + writer = zipWriter; + } + else + { + // Only zip up zips. + writer = new FilteredDataEntryWriter(new DataEntryParentFilter( + new DataEntryNameFilter( + new ExtensionMatcher(".zip"))), + zipWriter, + writer); + } + + // Zip up any wars, if necessary. + DataEntryWriter warWriter = new JarWriter(writer); + if (outputIsWar) + { + // Always zip. + writer = warWriter; + } + else + { + // Only zip up wars. + writer = new FilteredDataEntryWriter(new DataEntryParentFilter( + new DataEntryNameFilter( + new ExtensionMatcher(".war"))), + warWriter, + writer); + } + } + + // Zip up any jars, if necessary. + DataEntryWriter jarWriter = new JarWriter(writer); + if (outputIsJar) + { + // Always zip. + writer = jarWriter; + } + else + { + // Only zip up jars. + writer = new FilteredDataEntryWriter(new DataEntryParentFilter( + new DataEntryNameFilter( + new ExtensionMatcher(".jar"))), + jarWriter, + writer); + } + + + // Create the copying DataEntryReader. + DataEntryReader reader = new DataEntryCopier(writer); + + + boolean inputIsJar = input.endsWith(".jar"); + boolean inputIsWar = input.endsWith(".war"); + boolean inputIsZip = input.endsWith(".zip"); + + // Unzip any jars, if necessary. + DataEntryReader jarReader = new JarReader(reader); + if (inputIsJar) + { + // Always unzip. + reader = jarReader; + } + else + { + // Only unzip jar entries. + reader = new FilteredDataEntryReader(new DataEntryNameFilter( + new ExtensionMatcher(".jar")), + jarReader, + reader); + + // Unzip any wars, if necessary. + DataEntryReader warReader = new JarReader(reader); + if (inputIsWar) + { + // Always unzip. + reader = warReader; + } + else + { + // Only unzip war entries. + reader = new FilteredDataEntryReader(new DataEntryNameFilter( + new ExtensionMatcher(".war")), + warReader, + reader); + } + + // Unzip any zips, if necessary. + DataEntryReader zipReader = new JarReader(reader); + if (inputIsZip) + { + // Always unzip. + reader = zipReader; + } + else + { + // Only unzip zip entries. + reader = new FilteredDataEntryReader(new DataEntryNameFilter( + new ExtensionMatcher(".zip")), + zipReader, + reader); + } + } + + DirectoryPump directoryReader = new DirectoryPump(new File(input)); + + directoryReader.pumpDataEntries(reader); + + writer.close(); + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/io/DataEntryDirectoryFilter.java b/src/proguard/io/DataEntryDirectoryFilter.java new file mode 100644 index 0000000..bb36f3e --- /dev/null +++ b/src/proguard/io/DataEntryDirectoryFilter.java @@ -0,0 +1,40 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.util.StringMatcher; + +/** + * This DataEntryFilter filters data entries based on whether they represent + * directories. + * + * @author Eric Lafortune + */ +public class DataEntryDirectoryFilter +implements DataEntryFilter +{ + // Implementations for DataEntryFilter. + + public boolean accepts(DataEntry dataEntry) + { + return dataEntry != null && dataEntry.isDirectory(); + } +} \ No newline at end of file diff --git a/src/proguard/io/DataEntryFilter.java b/src/proguard/io/DataEntryFilter.java new file mode 100644 index 0000000..ddcd0be --- /dev/null +++ b/src/proguard/io/DataEntryFilter.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + + +/** + * This interface provides a method to filter data entries. + * + * @author Eric Lafortune + */ +public interface DataEntryFilter +{ + /** + * Checks whether the filter accepts the given data entry. + * @param dataEntry the data entry to filter. + * @return a boolean indicating whether the filter accepts the given data + * entry. + */ + public boolean accepts(DataEntry dataEntry); +} diff --git a/src/proguard/io/DataEntryNameFilter.java b/src/proguard/io/DataEntryNameFilter.java new file mode 100644 index 0000000..d6afd2e --- /dev/null +++ b/src/proguard/io/DataEntryNameFilter.java @@ -0,0 +1,54 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.util.StringMatcher; + +/** + * This DataEntryFilter filters data entries based on whether their names match + * a given StringMatcher. + * + * @author Eric Lafortune + */ +public class DataEntryNameFilter +implements DataEntryFilter +{ + private final StringMatcher stringMatcher; + + + /** + * Creates a new DataEntryNameFilter. + * @param stringMatcher the string matcher that will be applied to the names + * of the filtered data entries. + */ + public DataEntryNameFilter(StringMatcher stringMatcher) + { + this.stringMatcher = stringMatcher; + } + + + // Implementations for DataEntryFilter. + + public boolean accepts(DataEntry dataEntry) + { + return dataEntry != null && stringMatcher.matches(dataEntry.getName()); + } +} diff --git a/src/proguard/io/DataEntryObfuscator.java b/src/proguard/io/DataEntryObfuscator.java new file mode 100644 index 0000000..aa63af1 --- /dev/null +++ b/src/proguard/io/DataEntryObfuscator.java @@ -0,0 +1,131 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.*; +import proguard.classfile.util.ClassUtil; + +import java.io.IOException; +import java.util.Map; + +/** + * This DataEntryReader delegates to another DataEntryReader, renaming the + * data entries based on the renamed classes in the given ClassPool. + * + * @author Eric Lafortune + */ +public class DataEntryObfuscator implements DataEntryReader +{ + private final ClassPool classPool; + private final Map packagePrefixMap; + private final DataEntryReader dataEntryReader; + + + /** + * Creates a new DataEntryObfuscator. + * @param classPool the class pool that maps from old names to new + * names. + * @param packagePrefixMap the map from old package prefixes to new package + * prefixes. + * @param dataEntryReader the DataEntryReader to which calls will be + * delegated. + */ + public DataEntryObfuscator(ClassPool classPool, + Map packagePrefixMap, + DataEntryReader dataEntryReader) + { + this.classPool = classPool; + this.packagePrefixMap = packagePrefixMap; + this.dataEntryReader = dataEntryReader; + } + + + // Implementations for DataEntryReader. + + public void read(DataEntry dataEntry) throws IOException + { + // Delegate to the actual data entry reader. + dataEntryReader.read(renamedDataEntry(dataEntry)); + } + + + /** + * Create a renamed data entry, if possible. + */ + private DataEntry renamedDataEntry(DataEntry dataEntry) + { + String dataEntryName = dataEntry.getName(); + + // Try to find a corresponding class name by removing increasingly + // long suffixes, + for (int suffixIndex = dataEntryName.length() - 1; + suffixIndex > 0; + suffixIndex--) + { + char c = dataEntryName.charAt(suffixIndex); + if (!Character.isLetterOrDigit(c)) + { + // Chop off the suffix. + String className = dataEntryName.substring(0, suffixIndex); + + // Did we get to the package separator? + if (c == ClassConstants.INTERNAL_PACKAGE_SEPARATOR) + { + break; + } + + // Is there a class corresponding to the data entry? + Clazz clazz = classPool.getClass(className); + if (clazz != null) + { + // Did the class get a new name? + String newClassName = clazz.getName(); + if (!className.equals(newClassName)) + { + // Return a renamed data entry. + String newDataEntryName = + newClassName + dataEntryName.substring(suffixIndex); + + return new RenamedDataEntry(dataEntry, newDataEntryName); + } + + // Otherwise stop looking. + break; + } + } + } + + // Did the package get a new name? + String packagePrefix = ClassUtil.internalPackagePrefix(dataEntryName); + String newPackagePrefix = (String)packagePrefixMap.get(packagePrefix); + if (newPackagePrefix != null && + !packagePrefix.equals(newPackagePrefix)) + { + // Return a renamed data entry. + String newDataEntryName = + newPackagePrefix + dataEntryName.substring(packagePrefix.length()); + + return new RenamedDataEntry(dataEntry, newDataEntryName); + } + + return dataEntry; + } +} diff --git a/src/proguard/io/DataEntryParentFilter.java b/src/proguard/io/DataEntryParentFilter.java new file mode 100644 index 0000000..fbeac4f --- /dev/null +++ b/src/proguard/io/DataEntryParentFilter.java @@ -0,0 +1,51 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +/** + * This DataEntryFilter delegates filtering to a DataEntryFilter for its parent. + * + * @author Eric Lafortune + */ +public class DataEntryParentFilter +implements DataEntryFilter +{ + private final DataEntryFilter dataEntryFilter; + + + /** + * Creates a new ParentFilter. + * @param dataEntryFilter the filter that will be applied to the data + * entry's parent. + */ + public DataEntryParentFilter(DataEntryFilter dataEntryFilter) + { + this.dataEntryFilter = dataEntryFilter; + } + + + // Implementations for DataEntryFilter. + + public boolean accepts(DataEntry dataEntry) + { + return dataEntry != null && dataEntryFilter.accepts(dataEntry.getParent()); + } +} diff --git a/src/proguard/io/DataEntryPump.java b/src/proguard/io/DataEntryPump.java new file mode 100644 index 0000000..bfe22a3 --- /dev/null +++ b/src/proguard/io/DataEntryPump.java @@ -0,0 +1,43 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.IOException; + + +/** + * This interface provides a method to pump data entries. The implementation + * determines the source and the type of the data entries. Typical examples + * are zip entries coming from a zip file of file entries coming from a + * directory structure. The reader can for instance collect the classes, + * or copy the resource files that are presented. + * + * @author Eric Lafortune + */ +public interface DataEntryPump +{ + /** + * Applies the given DataEntryReader to all data entries that the + * implementation can provide. + */ + public void pumpDataEntries(DataEntryReader dataEntryReader) + throws IOException; +} diff --git a/src/proguard/io/DataEntryReader.java b/src/proguard/io/DataEntryReader.java new file mode 100644 index 0000000..e77f7bf --- /dev/null +++ b/src/proguard/io/DataEntryReader.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.IOException; + + +/** + * This interface provides methods for reading data entries. The implementation + * determines what to do with the read data, if anything. + * + * @author Eric Lafortune + */ +public interface DataEntryReader +{ + /** + * Reads the given data entry. + */ + public void read(DataEntry dataEntry) throws IOException; +} diff --git a/src/proguard/io/DataEntryRenamer.java b/src/proguard/io/DataEntryRenamer.java new file mode 100644 index 0000000..45c61ee --- /dev/null +++ b/src/proguard/io/DataEntryRenamer.java @@ -0,0 +1,104 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; + +import java.io.IOException; +import java.util.Map; + +/** + * This DataEntryReader delegates to another DataEntryReader, renaming the + * data entries based on the given map. Entries whose name does not appear + * in the map may be passed to an alternative DataEntryReader. + * + * @author Eric Lafortune + */ +public class DataEntryRenamer implements DataEntryReader +{ + private final Map nameMap; + private final DataEntryReader renamedDataEntryReader; + private final DataEntryReader missingDataEntryReader; + + + /** + * Creates a new DataEntryRenamer. + * @param nameMap the map from old names to new names. + * @param renamedDataEntryReader the DataEntryReader to which renamed data + * entries will be passed. + */ + public DataEntryRenamer(Map nameMap, + DataEntryReader renamedDataEntryReader) + { + this(nameMap, renamedDataEntryReader, null); + } + + + /** + * Creates a new DataEntryRenamer. + * @param nameMap the map from old names to new names. + * @param renamedDataEntryReader the DataEntryReader to which renamed data + * entries will be passed. + * @param missingDataEntryReader the optional DataEntryReader to which data + * entries that can't be renamed will be + * passed. + */ + public DataEntryRenamer(Map nameMap, + DataEntryReader renamedDataEntryReader, + DataEntryReader missingDataEntryReader) + { + this.nameMap = nameMap; + this.renamedDataEntryReader = renamedDataEntryReader; + this.missingDataEntryReader = missingDataEntryReader; + } + + + // Implementations for DataEntryReader. + + public void read(DataEntry dataEntry) throws IOException + { + String name = dataEntry.getName(); + + // Add a directory separator if necessary. + if (dataEntry.isDirectory() && + name.length() > 0) + { + name += ClassConstants.INTERNAL_PACKAGE_SEPARATOR; + } + + String newName = (String)nameMap.get(name); + if (newName != null) + { + // Add remove the directory separator if necessary. + if (dataEntry.isDirectory() && + newName.length() > 0) + { + newName = newName.substring(0, newName.length() - 1); + } + + renamedDataEntryReader.read(new RenamedDataEntry(dataEntry, newName)); + } + else if (missingDataEntryReader != null) + { + missingDataEntryReader.read(dataEntry); + } + } +} \ No newline at end of file diff --git a/src/proguard/io/DataEntryRewriter.java b/src/proguard/io/DataEntryRewriter.java new file mode 100644 index 0000000..eefced4 --- /dev/null +++ b/src/proguard/io/DataEntryRewriter.java @@ -0,0 +1,148 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.*; + +import java.io.*; + +/** + * This DataEntryReader writes the resource data entries that it reads to a + * given DataEntryWriter, updating their contents based on the renamed classes + * in the given ClassPool. + * + * @author Eric Lafortune + */ +public class DataEntryRewriter extends DataEntryCopier +{ + private final ClassPool classPool; + + + /** + * Creates a new DataEntryRewriter. + */ + public DataEntryRewriter(ClassPool classPool, + DataEntryWriter dataEntryWriter) + { + super(dataEntryWriter); + + this.classPool = classPool; + } + + + // Implementations for DataEntryCopier. + + protected void copyData(InputStream inputStream, + OutputStream outputStream) + throws IOException + { + Reader reader = new BufferedReader(new InputStreamReader(inputStream)); + Writer writer = new BufferedWriter(new OutputStreamWriter(outputStream)); + + copyData(reader, writer); + + writer.flush(); + outputStream.flush(); + } + + + /** + * Copies all data that it can read from the given reader to the given + * writer. + */ + protected void copyData(Reader reader, + Writer writer) + throws IOException + { + StringBuffer word = new StringBuffer(); + + while (true) + { + int i = reader.read(); + if (i < 0) + { + break; + } + + // Is the character part of a word? + char c = (char)i; + if (Character.isJavaIdentifierPart(c) || + c == '.' || + c == '-') + { + // Collect the characters in this word. + word.append(c); + } + else + { + // Write out the updated word, if any. + writeUpdatedWord(writer, word.toString()); + word.setLength(0); + + // Write out the character that terminated it. + writer.write(c); + } + } + + // Write out the final word. + writeUpdatedWord(writer, word.toString()); + } + + + // Small utility methods. + + /** + * Writes the given word to the given writer, after having adapted it, + * based on the renamed class names. + */ + private void writeUpdatedWord(Writer writer, String word) + throws IOException + { + if (word.length() > 0) + { + String newWord = word; + + boolean containsDots = word.indexOf('.') >= 0; + + // Replace dots by forward slashes. + String className = containsDots ? + word.replace('.', ClassConstants.INTERNAL_PACKAGE_SEPARATOR) : + word; + + // Find the class corrsponding to the word. + Clazz clazz = classPool.getClass(className); + if (clazz != null) + { + // Update the word if necessary. + String newClassName = clazz.getName(); + if (!className.equals(newClassName)) + { + // Replace forward slashes by dots. + newWord = containsDots ? + newClassName.replace(ClassConstants.INTERNAL_PACKAGE_SEPARATOR, '.') : + newClassName; + } + } + + writer.write(newWord); + } + } +} diff --git a/src/proguard/io/DataEntryWriter.java b/src/proguard/io/DataEntryWriter.java new file mode 100644 index 0000000..9ecf79b --- /dev/null +++ b/src/proguard/io/DataEntryWriter.java @@ -0,0 +1,73 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + + +/** + * This interface provides methods for writing data entries, such as ZIP entries + * or files. The implementation determines to which type of data entry the + * data will be written. + * + * @author Eric Lafortune + */ +public interface DataEntryWriter +{ + /** + * Creates a directory. + * @param dataEntry the data entry for which the directory is to be created. + * @return whether the directory has been created. + */ + public boolean createDirectory(DataEntry dataEntry) throws IOException; + + + /** + * Returns an output stream for writing data. The caller must not close + * the output stream; closing the output stream is the responsibility of + * the implementation of this interface. + * @param dataEntry the data entry for which the output stream is to be created. + * @return the output stream. The stream may be null to indicate + * that the data entry should not be written. + */ + public OutputStream getOutputStream(DataEntry dataEntry) throws IOException; + + + /** + * Returns an output stream for writing data. The caller must not close + * the output stream; closing the output stream is the responsibility of + * the implementation of this interface. + * @param dataEntry the data entry for which the output stream is to be created. + * @param finisher the optional finisher that will be called before this + * class closes the output stream (at some later point in + * time) that will be returned (now). + * @return the output stream. The stream may be null to indicate + * that the data entry should not be written. + */ + public OutputStream getOutputStream(DataEntry dataEntry, + Finisher finisher) throws IOException; + + + /** + * Finishes writing all data entries. + */ + public void close() throws IOException; +} diff --git a/src/proguard/io/DirectoryFilter.java b/src/proguard/io/DirectoryFilter.java new file mode 100644 index 0000000..a45d1aa --- /dev/null +++ b/src/proguard/io/DirectoryFilter.java @@ -0,0 +1,58 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; +import proguard.util.ExtensionMatcher; + +import java.io.IOException; + + +/** + * This DataEntryReader delegates to one of two other DataEntryReader instances, + * depending on whether the data entry represents a directory or not. + * + * @author Eric Lafortune + */ +public class DirectoryFilter extends FilteredDataEntryReader +{ + /** + * Creates a new ClassFilter that delegates reading directories to the + * given reader. + */ + public DirectoryFilter(DataEntryReader directoryReader) + { + this (directoryReader, null); + } + + + /** + * Creates a new ClassFilter that delegates to either of the two given + * readers. + */ + public DirectoryFilter(DataEntryReader directoryReader, + DataEntryReader otherReader) + { + super(new DataEntryDirectoryFilter(), + directoryReader, + otherReader); + } +} \ No newline at end of file diff --git a/src/proguard/io/DirectoryPump.java b/src/proguard/io/DirectoryPump.java new file mode 100644 index 0000000..cab2ff3 --- /dev/null +++ b/src/proguard/io/DirectoryPump.java @@ -0,0 +1,78 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + + +/** + * This class can read a given file or directory, recursively, applying a given + * DataEntryReader to all files it comes across. + * + * @author Eric Lafortune + */ +public class DirectoryPump implements DataEntryPump +{ + private final File directory; + + + public DirectoryPump(File directory) + { + this.directory = directory; + } + + + // Implementations for DataEntryPump. + + public void pumpDataEntries(DataEntryReader dataEntryReader) + throws IOException + { + if (!directory.exists()) + { + throw new IOException("No such file or directory"); + } + + readFiles(directory, dataEntryReader); + } + + + /** + * Reads the given subdirectory recursively, applying the given DataEntryReader + * to all files that are encountered. + */ + private void readFiles(File file, DataEntryReader dataEntryReader) + throws IOException + { + // Pass the file data entry to the reader. + dataEntryReader.read(new FileDataEntry(directory, file)); + + if (file.isDirectory()) + { + // Recurse into the subdirectory. + File[] files = file.listFiles(); + + for (int index = 0; index < files.length; index++) + { + readFiles(files[index], dataEntryReader); + } + } + } +} diff --git a/src/proguard/io/DirectoryWriter.java b/src/proguard/io/DirectoryWriter.java new file mode 100644 index 0000000..c6605df --- /dev/null +++ b/src/proguard/io/DirectoryWriter.java @@ -0,0 +1,165 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; + +import java.io.*; + + +/** + * This DataEntryWriter writes data entries to individual files in a given + * directory. + * + * @author Eric Lafortune + */ +public class DirectoryWriter implements DataEntryWriter +{ + private final File baseFile; + private final boolean isFile; + + private File currentFile; + private OutputStream currentOutputStream; + private Finisher currentFinisher; + + + /** + * Creates a new DirectoryWriter. + * @param baseFile the base directory to which all files will be written. + */ + public DirectoryWriter(File baseFile, + boolean isFile) + { + this.baseFile = baseFile; + this.isFile = isFile; + } + + + // Implementations for DataEntryWriter. + + public boolean createDirectory(DataEntry dataEntry) throws IOException + { + // Should we close the current file? + if (!isFile && + currentFile != null) + { + closeEntry(); + } + + File directory = getFile(dataEntry); + if (!directory.exists() && + !directory.mkdirs()) + { + throw new IOException("Can't create directory [" + directory.getPath() + "]"); + } + + return true; + } + + + public OutputStream getOutputStream(DataEntry dataEntry) throws IOException + { + return getOutputStream(dataEntry, null); + } + + + public OutputStream getOutputStream(DataEntry dataEntry, + Finisher finisher) throws IOException + { + File file = getFile(dataEntry); + + // Should we close the current file? + if (!isFile && + currentFile != null && + !currentFile.equals(file)) + { + closeEntry(); + } + + // Do we need a new stream? + if (currentOutputStream == null) + { + // Make sure the parent directories exist. + File parentDirectory = file.getParentFile(); + if (parentDirectory != null && + !parentDirectory.exists() && + !parentDirectory.mkdirs()) + { + throw new IOException("Can't create directory [" + parentDirectory.getPath() + "]"); + } + + // Open a new output stream for writing to the file. + currentOutputStream = + new BufferedOutputStream( + new FileOutputStream(file)); + + currentFinisher = finisher; + currentFile = file; + } + + return currentOutputStream; + } + + + public void close() throws IOException + { + // Close the file stream, if any. + closeEntry(); + } + + + // Small utility methods. + + /** + * Returns the file for the given data entry. + */ + private File getFile(DataEntry dataEntry) + { + // Use the specified file, or construct a new file. + return isFile ? + baseFile : + new File(baseFile, + dataEntry.getName().replace(ClassConstants.INTERNAL_PACKAGE_SEPARATOR, + File.separatorChar)); + } + + + /** + * Closes the previous file, if any. + */ + private void closeEntry() throws IOException + { + // Close the file stream, if any. + if (currentOutputStream != null) + { + // Let any finisher finish up first. + if (currentFinisher != null) + { + currentFinisher.finish(); + currentFinisher = null; + } + + currentOutputStream.close(); + currentOutputStream = null; + currentFile = null; + } + } +} diff --git a/src/proguard/io/FileDataEntry.java b/src/proguard/io/FileDataEntry.java new file mode 100644 index 0000000..d0449ee --- /dev/null +++ b/src/proguard/io/FileDataEntry.java @@ -0,0 +1,96 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; + +import java.io.*; + +/** + * This DataEntry represents a file. + * + * @author Eric Lafortune + */ +public class FileDataEntry implements DataEntry +{ + private final File directory; + private final File file; + private InputStream inputStream; + + + public FileDataEntry(File directory, + File file) + { + this.directory = directory; + this.file = file; + } + + + // Implementations for DataEntry. + + public String getName() + { + // Chop the directory name from the file name and get the right separators. + return file.equals(directory) ? + file.getName() : + file.getPath() + .substring(directory.getPath().length() + File.separator.length()) + .replace(File.separatorChar, ClassConstants.INTERNAL_PACKAGE_SEPARATOR); + } + + + public boolean isDirectory() + { + return file.isDirectory(); + } + + + public InputStream getInputStream() throws IOException + { + if (inputStream == null) + { + inputStream = new BufferedInputStream(new FileInputStream(file)); + } + + return inputStream; + } + + + public void closeInputStream() throws IOException + { + inputStream.close(); + inputStream = null; + } + + + public DataEntry getParent() + { + return null; + } + + + // Implementations for Object. + + public String toString() + { + return getName(); + } +} diff --git a/src/proguard/io/FilteredDataEntryReader.java b/src/proguard/io/FilteredDataEntryReader.java new file mode 100644 index 0000000..11da0d4 --- /dev/null +++ b/src/proguard/io/FilteredDataEntryReader.java @@ -0,0 +1,90 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.IOException; + + +/** + * This DataEntryReader delegates to one of two other DataEntryReader instances, + * depending on whether the data entry passes through a given data entry filter + * or not. + * + * @author Eric Lafortune + */ +public class FilteredDataEntryReader implements DataEntryReader +{ + private final DataEntryFilter dataEntryFilter; + private final DataEntryReader acceptedDataEntryReader; + private final DataEntryReader rejectedDataEntryReader; + + + /** + * Creates a new FilteredDataEntryReader with only a reader for accepted + * data entries. + * @param dataEntryFilter the data entry filter. + * @param acceptedDataEntryReader the DataEntryReader to which the reading + * will be delegated if the filter accepts + * the data entry. May be null. + */ + public FilteredDataEntryReader(DataEntryFilter dataEntryFilter, + DataEntryReader acceptedDataEntryReader) + { + this(dataEntryFilter, acceptedDataEntryReader, null); + } + + + /** + * Creates a new FilteredDataEntryReader. + * @param dataEntryFilter the data entry filter. + * @param acceptedDataEntryReader the DataEntryReader to which the reading + * will be delegated if the filter accepts + * the data entry. May be null. + * @param rejectedDataEntryReader the DataEntryReader to which the reading + * will be delegated if the filter does not + * accept the data entry. May be + * null. + */ + public FilteredDataEntryReader(DataEntryFilter dataEntryFilter, + DataEntryReader acceptedDataEntryReader, + DataEntryReader rejectedDataEntryReader) + { + this.dataEntryFilter = dataEntryFilter; + this.acceptedDataEntryReader = acceptedDataEntryReader; + this.rejectedDataEntryReader = rejectedDataEntryReader; + } + + + // Implementations for DataEntryReader. + + public void read(DataEntry dataEntry) + throws IOException + { + DataEntryReader dataEntryReader = dataEntryFilter.accepts(dataEntry) ? + acceptedDataEntryReader : + rejectedDataEntryReader; + + if (dataEntryReader != null) + { + dataEntryReader.read(dataEntry); + } + } +} diff --git a/src/proguard/io/FilteredDataEntryWriter.java b/src/proguard/io/FilteredDataEntryWriter.java new file mode 100644 index 0000000..40a8c64 --- /dev/null +++ b/src/proguard/io/FilteredDataEntryWriter.java @@ -0,0 +1,125 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + +/** + * This DataEntryWriter delegates to one of two other DataEntryWriter instances, + * depending on whether the data entry passes through a given data entry filter + * or not. + * + * @author Eric Lafortune + */ +public class FilteredDataEntryWriter implements DataEntryWriter +{ + private final DataEntryFilter dataEntryFilter; + private DataEntryWriter acceptedDataEntryWriter; + private DataEntryWriter rejectedDataEntryWriter; + + + /** + * Creates a new FilteredDataEntryWriter with only a writer for accepted + * data entries. + * @param dataEntryFilter the data entry filter. + * @param acceptedDataEntryWriter the DataEntryWriter to which the writing + * will be delegated if the filter accepts + * the data entry. May be null. + */ + public FilteredDataEntryWriter(DataEntryFilter dataEntryFilter, + DataEntryWriter acceptedDataEntryWriter) + { + this(dataEntryFilter, acceptedDataEntryWriter, null); + } + + + /** + * Creates a new FilteredDataEntryWriter. + * @param dataEntryFilter the data entry filter. + * @param acceptedDataEntryWriter the DataEntryWriter to which the writing + * will be delegated if the filter accepts + * the data entry. May be null. + * @param rejectedDataEntryWriter the DataEntryWriter to which the writing + * will be delegated if the filter does not + * accept the data entry. May be + * null. + */ + public FilteredDataEntryWriter(DataEntryFilter dataEntryFilter, + DataEntryWriter acceptedDataEntryWriter, + DataEntryWriter rejectedDataEntryWriter) + { + this.dataEntryFilter = dataEntryFilter; + this.acceptedDataEntryWriter = acceptedDataEntryWriter; + this.rejectedDataEntryWriter = rejectedDataEntryWriter; + } + + + // Implementations for DataEntryWriter. + + public boolean createDirectory(DataEntry dataEntry) throws IOException + { + // Get the right data entry writer. + DataEntryWriter dataEntryWriter = dataEntryFilter.accepts(dataEntry) ? + acceptedDataEntryWriter : + rejectedDataEntryWriter; + + // Delegate to it, if it's not null. + return dataEntryWriter != null && + dataEntryWriter.createDirectory(dataEntry); + } + + + public OutputStream getOutputStream(DataEntry dataEntry) throws IOException + { + return getOutputStream(dataEntry, null); + } + + + public OutputStream getOutputStream(DataEntry dataEntry, + Finisher finisher) throws IOException + { + // Get the right data entry writer. + DataEntryWriter dataEntryWriter = dataEntryFilter.accepts(dataEntry) ? + acceptedDataEntryWriter : + rejectedDataEntryWriter; + + // Delegate to it, if it's not null. + return dataEntryWriter != null ? + dataEntryWriter.getOutputStream(dataEntry, finisher) : + null; + } + + + public void close() throws IOException + { + if (acceptedDataEntryWriter != null) + { + acceptedDataEntryWriter.close(); + acceptedDataEntryWriter = null; + } + + if (rejectedDataEntryWriter != null) + { + rejectedDataEntryWriter.close(); + rejectedDataEntryWriter = null; + } + } +} diff --git a/src/proguard/io/Finisher.java b/src/proguard/io/Finisher.java new file mode 100644 index 0000000..8c4cc1e --- /dev/null +++ b/src/proguard/io/Finisher.java @@ -0,0 +1,37 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.IOException; + +/** + * This interface specifies a listener that is called to finish an output stream + * before it is closed. + * + * @author Eric Lafortune + */ +public interface Finisher +{ + /** + * Finishes an output stream right before it is closed. + */ + public void finish() throws IOException; +} diff --git a/src/proguard/io/JarReader.java b/src/proguard/io/JarReader.java new file mode 100644 index 0000000..f96b4aa --- /dev/null +++ b/src/proguard/io/JarReader.java @@ -0,0 +1,75 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.IOException; +import java.util.zip.*; + +/** + * This DataEntryReader lets a given DataEntryReader read all data entries of + * the read jar/war/zip data entries. + * + * @author Eric Lafortune + */ +public class JarReader implements DataEntryReader +{ + private final DataEntryReader dataEntryReader; + + + /** + * Creates a new JarReader. + */ + public JarReader(DataEntryReader dataEntryReader) + { + this.dataEntryReader = dataEntryReader; + } + + + // Implementation for DataEntryReader. + + public void read(DataEntry dataEntry) throws IOException + { + ZipInputStream zipInputStream = new ZipInputStream(dataEntry.getInputStream()); + + try + { + // Get all entries from the input jar. + while (true) + { + // Can we get another entry? + ZipEntry zipEntry = zipInputStream.getNextEntry(); + if (zipEntry == null) + { + break; + } + + // Delegate the actual reading to the data entry reader. + dataEntryReader.read(new ZipDataEntry(dataEntry, + zipEntry, + zipInputStream)); + } + } + finally + { + dataEntry.closeInputStream(); + } + } +} diff --git a/src/proguard/io/JarWriter.java b/src/proguard/io/JarWriter.java new file mode 100644 index 0000000..3e40cdf --- /dev/null +++ b/src/proguard/io/JarWriter.java @@ -0,0 +1,235 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; + +import java.io.*; +import java.util.*; +import java.util.jar.*; +import java.util.zip.*; + + +/** + * This DataEntryWriter sends data entries to a given jar/zip file. + * The manifest and comment properties can optionally be set. + * + * @author Eric Lafortune + */ +public class JarWriter implements DataEntryWriter, Finisher +{ + private final DataEntryWriter dataEntryWriter; + private final Manifest manifest; + private final String comment; + + private OutputStream currentParentOutputStream; + private ZipOutputStream currentJarOutputStream; + private Finisher currentFinisher; + private DataEntry currentDataEntry; + + // The names of the jar entries that are already in the jar. + private final Set jarEntryNames = new HashSet(); + + + /** + * Creates a new JarWriter without manifest or comment. + */ + public JarWriter(DataEntryWriter dataEntryWriter) + { + this(dataEntryWriter, null, null); + } + + + /** + * Creates a new JarWriter. + */ + public JarWriter(DataEntryWriter dataEntryWriter, + Manifest manifest, + String comment) + { + this.dataEntryWriter = dataEntryWriter; + this.manifest = manifest; + this.comment = comment; + } + + + // Implementations for DataEntryWriter. + + public boolean createDirectory(DataEntry dataEntry) throws IOException + { + //Make sure we can start with a new entry. + if (!prepareEntry(dataEntry)) + { + return false; + } + + // Close the previous ZIP entry, if any. + closeEntry(); + + // Get the directory entry name. + String name = dataEntry.getName() + ClassConstants.INTERNAL_PACKAGE_SEPARATOR; + + // We have to check if the name is already used, because + // ZipOutputStream doesn't handle this case properly (it throws + // an exception which can be caught, but the ZipDataEntry is + // remembered anyway). + if (jarEntryNames.add(name)) + { + // Create a new directory entry. + currentJarOutputStream.putNextEntry(new ZipEntry(name)); + currentJarOutputStream.closeEntry(); + } + + // Clear the finisher. + currentFinisher = null; + currentDataEntry = null; + + return true; + } + + + public OutputStream getOutputStream(DataEntry dataEntry) throws IOException + { + return getOutputStream(dataEntry, null); + } + + + public OutputStream getOutputStream(DataEntry dataEntry, + Finisher finisher) throws IOException + { + //Make sure we can start with a new entry. + if (!prepareEntry(dataEntry)) + { + return null; + } + + // Do we need a new entry? + if (!dataEntry.equals(currentDataEntry)) + { + // Close the previous ZIP entry, if any. + closeEntry(); + + // Get the entry name. + String name = dataEntry.getName(); + + // We have to check if the name is already used, because + // ZipOutputStream doesn't handle this case properly (it throws + // an exception which can be caught, but the ZipDataEntry is + // remembered anyway). + if (!jarEntryNames.add(name)) + { + throw new IOException("Duplicate zip entry ["+dataEntry+"]"); + } + + // Create a new entry. + currentJarOutputStream.putNextEntry(new ZipEntry(name)); + + // Set up the finisher for the entry. + currentFinisher = finisher; + currentDataEntry = dataEntry; + } + + return currentJarOutputStream; + } + + + public void finish() throws IOException + { + // Finish the entire ZIP stream, if any. + if (currentJarOutputStream != null) + { + // Close the previous ZIP entry, if any. + closeEntry(); + + // Finish the entire ZIP stream. + currentJarOutputStream.finish(); + currentJarOutputStream = null; + currentParentOutputStream = null; + jarEntryNames.clear(); + } + } + + + public void close() throws IOException + { + // Close the parent stream. + dataEntryWriter.close(); + } + + + // Small utility methods. + + /** + * Makes sure the current output stream is set up for the given entry. + */ + private boolean prepareEntry(DataEntry dataEntry) throws IOException + { + // Get the parent stream, new or exisiting. + // This may finish our own jar output stream. + OutputStream parentOutputStream = + dataEntryWriter.getOutputStream(dataEntry.getParent(), this); + + // Did we get a stream? + if (parentOutputStream == null) + { + return false; + } + + // Do we need a new stream? + if (currentParentOutputStream == null) + { + currentParentOutputStream = parentOutputStream; + + // Create a new jar stream, with a manifest, if set. + currentJarOutputStream = manifest != null ? + new JarOutputStream(parentOutputStream, manifest) : + new ZipOutputStream(parentOutputStream); + + // Add a comment, if set. + if (comment != null) + { + currentJarOutputStream.setComment(comment); + } + } + + return true; + } + + + /** + * Closes the previous ZIP entry, if any. + */ + private void closeEntry() throws IOException + { + if (currentDataEntry != null) + { + // Let any finisher finish up first. + if (currentFinisher != null) + { + currentFinisher.finish(); + currentFinisher = null; + } + + currentJarOutputStream.closeEntry(); + currentDataEntry = null; + } + } +} diff --git a/src/proguard/io/ManifestRewriter.java b/src/proguard/io/ManifestRewriter.java new file mode 100644 index 0000000..f10307e --- /dev/null +++ b/src/proguard/io/ManifestRewriter.java @@ -0,0 +1,216 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.*; + +import java.io.*; + +/** + * This DataEntryReader writes the manifest data entries that it reads to a + * given DataEntryWriter, updating their contents based on the renamed classes + * in the given ClassPool. + * + * @author Eric Lafortune + */ +public class ManifestRewriter extends DataEntryRewriter +{ + /** + * Creates a new ManifestRewriter. + */ + public ManifestRewriter(ClassPool classPool, + DataEntryWriter dataEntryWriter) + { + super(classPool, dataEntryWriter); + } + + + // Implementations for DataEntryRewriter. + + protected void copyData(Reader reader, + Writer writer) + throws IOException + { + super.copyData(new SplitLineReader(reader), + new SplitLineWriter(writer)); + } + + + /** + * This Reader reads manifest files, joining any split lines. + */ + private static class SplitLineReader extends FilterReader + { + private char[] buffer = new char[2]; + private int bufferIndex = 0; + private int bufferSize = 0; + + + public SplitLineReader(Reader reader) + { + super(reader); + } + + + // Implementations for Reader. + + public int read() throws IOException + { + while (true) + { + if (bufferIndex < bufferSize) + { + return buffer[bufferIndex++]; + } + + // Read the first character. + int c1 = super.read(); + if (c1 != '\n' && c1 != '\r') + { + return c1; + } + + bufferIndex = 0; + bufferSize = 0; + buffer[bufferSize++] = '\n'; + + // Read the second character. + int c2 = super.read(); + if (c2 == ' ') + { + bufferSize = 0; + continue; + } + + if (c1 != '\r' || c2 != '\n') + { + buffer[bufferSize++] = (char)c2; + continue; + } + + // Read the third character. + int c3 = super.read(); + if (c3 == ' ') + { + bufferSize = 0; + continue; + } + + buffer[bufferSize++] = (char)c3; + } + } + + + public int read(char[] cbuf, int off, int len) throws IOException + { + // Delegate to reading a single character at a time. + int count = 0; + while (count < len) + { + int c = read(); + if (c == -1) + { + break; + } + + cbuf[off + count++] = (char)c; + } + + return count; + } + + + public long skip(long n) throws IOException + { + // Delegate to reading a single character at a time. + int count = 0; + while (count < n) + { + int c = read(); + if (c == -1) + { + break; + } + + count++; + } + + return count; + } + } + + + /** + * This Writer writes manifest files, splitting any long lines. + */ + private static class SplitLineWriter extends FilterWriter + { + private int counter = 0; + + + public SplitLineWriter(Writer writer) + { + super(writer); + } + + + // Implementations for Reader. + + public void write(int c) throws IOException + { + // TODO: We should actually count the Utf-8 bytes, not the characters. + if (c == '\n') + { + // Reset the character count. + counter = 0; + } + else if (counter == 70) + { + // Insert are newline and space. + super.write('\n'); + super.write(' '); + + counter = 2; + } + else + { + counter++; + } + + super.write(c); + } + + + public void write(char[] cbuf, int off, int len) throws IOException + { + for (int count = 0; count < len; count++) + { + write(cbuf[off + count]); + } + } + + + public void write(String str, int off, int len) throws IOException + { + write(str.toCharArray(), off, len); + } + } +} \ No newline at end of file diff --git a/src/proguard/io/NameFilter.java b/src/proguard/io/NameFilter.java new file mode 100644 index 0000000..2a9fbc3 --- /dev/null +++ b/src/proguard/io/NameFilter.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.util.*; + +import java.util.List; + +/** + * This DataEntryReader delegates to one of two other DataEntryReader instances, + * depending on the name of the data entry. + * + * @author Eric Lafortune + */ +public class NameFilter extends FilteredDataEntryReader +{ + /** + * Creates a new NameFilter that delegates to the given reader, depending + * on the given list of filters. + */ + public NameFilter(String regularExpression, + DataEntryReader acceptedDataEntryReader) + { + this(regularExpression, acceptedDataEntryReader, null); + } + + + /** + * Creates a new NameFilter that delegates to either of the two given + * readers, depending on the given list of filters. + */ + public NameFilter(String regularExpression, + DataEntryReader acceptedDataEntryReader, + DataEntryReader rejectedDataEntryReader) + { + super(new DataEntryNameFilter(new ListParser(new FileNameParser()).parse(regularExpression)), + acceptedDataEntryReader, + rejectedDataEntryReader); + } + + + /** + * Creates a new NameFilter that delegates to the given reader, depending + * on the given list of filters. + */ + public NameFilter(List regularExpressions, + DataEntryReader acceptedDataEntryReader) + { + this(regularExpressions, acceptedDataEntryReader, null); + } + + + /** + * Creates a new NameFilter that delegates to either of the two given + * readers, depending on the given list of filters. + */ + public NameFilter(List regularExpressions, + DataEntryReader acceptedDataEntryReader, + DataEntryReader rejectedDataEntryReader) + { + super(new DataEntryNameFilter(new ListParser(new FileNameParser()).parse(regularExpressions)), + acceptedDataEntryReader, + rejectedDataEntryReader); + } +} \ No newline at end of file diff --git a/src/proguard/io/ParentDataEntryWriter.java b/src/proguard/io/ParentDataEntryWriter.java new file mode 100644 index 0000000..4f16d12 --- /dev/null +++ b/src/proguard/io/ParentDataEntryWriter.java @@ -0,0 +1,75 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + +/** + * This DataEntryWriter lets another DataEntryWriter write the parent data + * entries. + * + * @author Eric Lafortune + */ +public class ParentDataEntryWriter implements DataEntryWriter +{ + private DataEntryWriter dataEntryWriter; + + + /** + * Creates a new ParentDataEntryWriter. + * @param dataEntryWriter the DataEntryWriter to which the writing will be + * delegated, passing the data entries' parents. + */ + public ParentDataEntryWriter(DataEntryWriter dataEntryWriter) + { + this.dataEntryWriter = dataEntryWriter; + } + + + // Implementations for DataEntryWriter. + + + public boolean createDirectory(DataEntry dataEntry) throws IOException + { + return getOutputStream(dataEntry) != null; + } + + + public OutputStream getOutputStream(DataEntry dataEntry) throws IOException + { + return getOutputStream(dataEntry, null); + } + + + public OutputStream getOutputStream(DataEntry dataEntry, + Finisher finisher) throws IOException + { + return dataEntryWriter.getOutputStream(dataEntry.getParent(), + finisher); + } + + + public void close() throws IOException + { + dataEntryWriter.close(); + dataEntryWriter = null; + } +} diff --git a/src/proguard/io/RenamedDataEntry.java b/src/proguard/io/RenamedDataEntry.java new file mode 100644 index 0000000..ae2d267 --- /dev/null +++ b/src/proguard/io/RenamedDataEntry.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import java.io.*; + +/** + * This DataEntry wraps another data entry, returning a different name instead + * of the wrapped data entry's name. + * + * @author Eric Lafortune + */ +public class RenamedDataEntry implements DataEntry +{ + private final DataEntry dataEntry; + private final String name; + + + public RenamedDataEntry(DataEntry dataEntry, + String name) + { + this.dataEntry = dataEntry; + this.name = name; + } + + + // Implementations for DataEntry. + + public String getName() + { + return name; + } + + + public boolean isDirectory() + { + return dataEntry.isDirectory(); + } + + + public InputStream getInputStream() throws IOException + { + return dataEntry.getInputStream(); + } + + + public void closeInputStream() throws IOException + { + dataEntry.closeInputStream(); + } + + + public DataEntry getParent() + { + return dataEntry.getParent(); + } + + + // Implementations for Object. + + public String toString() + { + return name + " == " + dataEntry; + } +} diff --git a/src/proguard/io/ZipDataEntry.java b/src/proguard/io/ZipDataEntry.java new file mode 100644 index 0000000..5779fd8 --- /dev/null +++ b/src/proguard/io/ZipDataEntry.java @@ -0,0 +1,98 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.io; + +import proguard.classfile.ClassConstants; + +import java.io.*; +import java.util.zip.*; + +/** + * This DataEntry represents a ZIP entry. + * + * @author Eric Lafortune + */ +public class ZipDataEntry implements DataEntry +{ + private final DataEntry parent; + private final ZipEntry zipEntry; + private ZipInputStream zipInputStream; + + + public ZipDataEntry(DataEntry parent, + ZipEntry zipEntry, + ZipInputStream zipInputStream) + { + this.parent = parent; + this.zipEntry = zipEntry; + this.zipInputStream = zipInputStream; + } + + + // Implementations for DataEntry. + + public String getName() + { + // Get the right separators. + String name = zipEntry.getName() + .replace(File.separatorChar, ClassConstants.INTERNAL_PACKAGE_SEPARATOR); + + // Chop the trailing directory slash, if any. + int length = name.length(); + return length > 0 && + name.charAt(length-1) == ClassConstants.INTERNAL_PACKAGE_SEPARATOR ? + name.substring(0, length -1) : + name; + } + + + public boolean isDirectory() + { + return zipEntry.isDirectory(); + } + + + public InputStream getInputStream() throws IOException + { + return zipInputStream; + } + + + public void closeInputStream() throws IOException + { + zipInputStream.closeEntry(); + zipInputStream = null; + } + + + public DataEntry getParent() + { + return parent; + } + + + // Implementations for Object. + + public String toString() + { + return parent.toString() + ':' + getName(); + } +} diff --git a/src/proguard/io/package.html b/src/proguard/io/package.html new file mode 100644 index 0000000..4ad9f41 --- /dev/null +++ b/src/proguard/io/package.html @@ -0,0 +1,4 @@ + +This package contains classes to read and write files, optionally wrapped in +jars, wars, ears, zips, directories,... + diff --git a/src/proguard/obfuscate/AttributeShrinker.java b/src/proguard/obfuscate/AttributeShrinker.java new file mode 100644 index 0000000..a8bc36b --- /dev/null +++ b/src/proguard/obfuscate/AttributeShrinker.java @@ -0,0 +1,121 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor removes attributes that are not marked as being used or + * required. + * + * @see AttributeUsageMarker + * + * @author Eric Lafortune + */ +public class AttributeShrinker +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + AttributeVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Compact the array for class attributes. + programClass.u2attributesCount = + shrinkArray(programClass.attributes, + programClass.u2attributesCount); + + // Compact the attributes in fields, methods, and class attributes, + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Library classes are left unchanged. + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + // Compact the attributes array. + programMember.u2attributesCount = + shrinkArray(programMember.attributes, + programMember.u2attributesCount); + + // Compact any attributes of the remaining attributes. + programMember.attributesAccept(programClass, this); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Compact the attributes array. + codeAttribute.u2attributesCount = + shrinkArray(codeAttribute.attributes, + codeAttribute.u2attributesCount); + } + + + // Small utility methods. + + /** + * Removes all VisitorAccepter objects that are not marked as being used + * from the given array. + * @return the new number of VisitorAccepter objects. + */ + private static int shrinkArray(VisitorAccepter[] array, int length) + { + int counter = 0; + + // Shift the used objects together. + for (int index = 0; index < length; index++) + { + if (AttributeUsageMarker.isUsed(array[index])) + { + array[counter++] = array[index]; + } + } + + // Clear the remaining array elements. + for (int index = counter; index < length; index++) + { + array[index] = null; + } + + return counter; + } +} diff --git a/src/proguard/obfuscate/AttributeUsageMarker.java b/src/proguard/obfuscate/AttributeUsageMarker.java new file mode 100644 index 0000000..e772324 --- /dev/null +++ b/src/proguard/obfuscate/AttributeUsageMarker.java @@ -0,0 +1,71 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ClassVisitor marks all attributes that it visits. + * + * @see AttributeShrinker + * + * @author Eric Lafortune + */ +public class AttributeUsageMarker +extends SimplifiedVisitor +implements AttributeVisitor +{ + // A visitor info flag to indicate the attribute is being used. + private static final Object USED = new Object(); + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) + { + markAsUsed(attribute); + } + + + // Small utility methods. + + /** + * Marks the given VisitorAccepter as being used (or useful). + * In this context, the VisitorAccepter will be an Attribute object. + */ + private static void markAsUsed(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(USED); + } + + + /** + * Returns whether the given VisitorAccepter has been marked as being used. + * In this context, the VisitorAccepter will be an Attribute object. + */ + static boolean isUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() == USED; + } +} diff --git a/src/proguard/obfuscate/ClassObfuscator.java b/src/proguard/obfuscate/ClassObfuscator.java new file mode 100644 index 0000000..9af0c82 --- /dev/null +++ b/src/proguard/obfuscate/ClassObfuscator.java @@ -0,0 +1,521 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.ClassVisitor; +import proguard.util.*; + +import java.util.*; + +/** + * This ClassVisitor comes up with obfuscated names for the + * classes it visits, and for their class members. The actual renaming is + * done afterward. + * + * @see ClassRenamer + * + * @author Eric Lafortune + */ +public class ClassObfuscator +extends SimplifiedVisitor +implements ClassVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + ConstantVisitor +{ + private final DictionaryNameFactory classNameFactory; + private final DictionaryNameFactory packageNameFactory; + private final boolean useMixedCaseClassNames; + private final StringMatcher keepPackageNamesMatcher; + private final String flattenPackageHierarchy; + private final String repackageClasses; + private final boolean allowAccessModification; + + private final Set classNamesToAvoid = new HashSet(); + + // Map: [package prefix - new package prefix] + private final Map packagePrefixMap = new HashMap(); + + // Map: [package prefix - package name factory] + private final Map packagePrefixPackageNameFactoryMap = new HashMap(); + + // Map: [package prefix - numeric class name factory] + private final Map packagePrefixClassNameFactoryMap = new HashMap(); + + // Map: [package prefix - numeric class name factory] + private final Map packagePrefixNumericClassNameFactoryMap = new HashMap(); + + // Field acting as temporary variables and as return values for names + // of outer classes and types of inner classes. + private String newClassName; + private boolean numericClassName; + + + /** + * Creates a new ClassObfuscator. + * @param programClassPool the class pool in which class names + * have to be unique. + * @param classNameFactory the optional class obfuscation dictionary. + * @param packageNameFactory the optional package obfuscation + * dictionary. + * @param useMixedCaseClassNames specifies whether obfuscated packages and + * classes can get mixed-case names. + * @param keepPackageNames the optional filter for which matching + * package names are kept. + * @param flattenPackageHierarchy the base package if the obfuscated package + * hierarchy is to be flattened. + * @param repackageClasses the base package if the obfuscated classes + * are to be repackaged. + * @param allowAccessModification specifies whether obfuscated classes can + * be freely moved between packages. + */ + public ClassObfuscator(ClassPool programClassPool, + DictionaryNameFactory classNameFactory, + DictionaryNameFactory packageNameFactory, + boolean useMixedCaseClassNames, + List keepPackageNames, + String flattenPackageHierarchy, + String repackageClasses, + boolean allowAccessModification) + { + this.classNameFactory = classNameFactory; + this.packageNameFactory = packageNameFactory; + + // First append the package separator if necessary. + if (flattenPackageHierarchy != null && + flattenPackageHierarchy.length() > 0) + { + flattenPackageHierarchy += ClassConstants.INTERNAL_PACKAGE_SEPARATOR; + } + + // First append the package separator if necessary. + if (repackageClasses != null && + repackageClasses.length() > 0) + { + repackageClasses += ClassConstants.INTERNAL_PACKAGE_SEPARATOR; + } + + this.useMixedCaseClassNames = useMixedCaseClassNames; + this.keepPackageNamesMatcher = keepPackageNames == null ? null : + new ListParser(new FileNameParser()).parse(keepPackageNames); + this.flattenPackageHierarchy = flattenPackageHierarchy; + this.repackageClasses = repackageClasses; + this.allowAccessModification = allowAccessModification; + + // Map the root package onto the root package. + packagePrefixMap.put("", ""); + + // Collect all names that have been taken already. + programClassPool.classesAccept(new MyKeepCollector()); + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Does this class still need a new name? + newClassName = newClassName(programClass); + if (newClassName == null) + { + // Make sure the outer class has a name, if it exists. The name will + // be stored as the new class name, as a side effect, so we'll be + // able to use it as a prefix. + programClass.attributesAccept(this); + + // Figure out a package prefix. The package prefix may actually be + // the an outer class prefix, if any, or it may be the fixed base + // package, if classes are to be repackaged. + String newPackagePrefix = newClassName != null ? + newClassName + ClassConstants.INTERNAL_INNER_CLASS_SEPARATOR : + newPackagePrefix(ClassUtil.internalPackagePrefix(programClass.getName())); + + // Come up with a new class name, numeric or ordinary. + newClassName = newClassName != null && numericClassName ? + generateUniqueNumericClassName(newPackagePrefix) : + generateUniqueClassName(newPackagePrefix); + + setNewClassName(programClass, newClassName); + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Make sure the outer classes have a name, if they exist. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + // Make sure the enclosing class has a name. + enclosingMethodAttribute.referencedClassAccept(this); + + String innerClassName = clazz.getName(); + String outerClassName = clazz.getClassName(enclosingMethodAttribute.u2classIndex); + + numericClassName = isNumericClassName(innerClassName, + outerClassName); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + // Make sure the outer class has a name, if it exists. + int innerClassIndex = innerClassesInfo.u2innerClassIndex; + int outerClassIndex = innerClassesInfo.u2outerClassIndex; + if (innerClassIndex != 0 && + outerClassIndex != 0) + { + String innerClassName = clazz.getClassName(innerClassIndex); + if (innerClassName.equals(clazz.getName())) + { + clazz.constantPoolEntryAccept(outerClassIndex, this); + + String outerClassName = clazz.getClassName(outerClassIndex); + + numericClassName = isNumericClassName(innerClassName, + outerClassName); + } + } + } + + + /** + * Returns whether the given inner class name is a numeric name. + */ + private boolean isNumericClassName(String innerClassName, + String outerClassName) + { + int innerClassNameStart = outerClassName.length() + 1; + int innerClassNameLength = innerClassName.length(); + + if (innerClassNameStart >= innerClassNameLength) + { + return false; + } + + for (int index = innerClassNameStart; index < innerClassNameLength; index++) + { + if (!Character.isDigit(innerClassName.charAt(index))) + { + return false; + } + } + + return true; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Make sure the outer class has a name. + classConstant.referencedClassAccept(this); + } + + + /** + * This ClassVisitor collects package names and class names that have to + * be kept. + */ + private class MyKeepCollector implements ClassVisitor + { + public void visitProgramClass(ProgramClass programClass) + { + // Does the class already have a new name? + String newClassName = newClassName(programClass); + if (newClassName != null) + { + // Remember not to use this name. + classNamesToAvoid.add(mixedCaseClassName(newClassName)); + + // Are we not aggressively repackaging all obfuscated classes? + if (repackageClasses == null || + !allowAccessModification) + { + String className = programClass.getName(); + + // Keep the package name for all other classes in the same + // package. Do this recursively if we're not doing any + // repackaging. + mapPackageName(className, + newClassName, + repackageClasses == null && + flattenPackageHierarchy == null); + } + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + /** + * Makes sure the package name of the given class will always be mapped + * consistently with its new name. + */ + private void mapPackageName(String className, + String newClassName, + boolean recursively) + { + String packagePrefix = ClassUtil.internalPackagePrefix(className); + String newPackagePrefix = ClassUtil.internalPackagePrefix(newClassName); + + // Put the mapping of this package prefix, and possibly of its + // entire hierarchy, into the package prefix map. + do + { + packagePrefixMap.put(packagePrefix, newPackagePrefix); + + if (!recursively) + { + break; + } + + packagePrefix = ClassUtil.internalPackagePrefix(packagePrefix); + newPackagePrefix = ClassUtil.internalPackagePrefix(newPackagePrefix); + } + while (packagePrefix.length() > 0 && + newPackagePrefix.length() > 0); + } + } + + + // Small utility methods. + + /** + * Finds or creates the new package prefix for the given package. + */ + private String newPackagePrefix(String packagePrefix) + { + // Doesn't the package prefix have a new package prefix yet? + String newPackagePrefix = (String)packagePrefixMap.get(packagePrefix); + if (newPackagePrefix == null) + { + // Are we keeping the package name? + if (keepPackageNamesMatcher != null && + keepPackageNamesMatcher.matches(packagePrefix.length() > 0 ? + packagePrefix.substring(0, packagePrefix.length()-1) : + packagePrefix)) + { + return packagePrefix; + } + + // Are we forcing a new package prefix? + if (repackageClasses != null) + { + return repackageClasses; + } + + // Are we forcing a new superpackage prefix? + // Otherwise figure out the new superpackage prefix, recursively. + String newSuperPackagePrefix = flattenPackageHierarchy != null ? + flattenPackageHierarchy : + newPackagePrefix(ClassUtil.internalPackagePrefix(packagePrefix)); + + // Come up with a new package prefix. + newPackagePrefix = generateUniquePackagePrefix(newSuperPackagePrefix); + + // Remember to use this mapping in the future. + packagePrefixMap.put(packagePrefix, newPackagePrefix); + } + + return newPackagePrefix; + } + + + /** + * Creates a new package prefix in the given new superpackage. + */ + private String generateUniquePackagePrefix(String newSuperPackagePrefix) + { + // Find the right name factory for this package. + NameFactory packageNameFactory = + (NameFactory)packagePrefixPackageNameFactoryMap.get(newSuperPackagePrefix); + if (packageNameFactory == null) + { + // We haven't seen packages in this superpackage before. Create + // a new name factory for them. + packageNameFactory = new SimpleNameFactory(useMixedCaseClassNames); + if (this.packageNameFactory != null) + { + packageNameFactory = + new DictionaryNameFactory(this.packageNameFactory, + packageNameFactory); + } + + packagePrefixPackageNameFactoryMap.put(newSuperPackagePrefix, + packageNameFactory); + } + + return generateUniquePackagePrefix(newSuperPackagePrefix, packageNameFactory); + } + + + /** + * Creates a new package prefix in the given new superpackage, with the + * given package name factory. + */ + private String generateUniquePackagePrefix(String newSuperPackagePrefix, + NameFactory packageNameFactory) + { + // Come up with package names until we get an original one. + String newPackagePrefix; + do + { + // Let the factory produce a package name. + newPackagePrefix = newSuperPackagePrefix + + packageNameFactory.nextName() + + ClassConstants.INTERNAL_PACKAGE_SEPARATOR; + } + while (packagePrefixMap.containsValue(newPackagePrefix)); + + return newPackagePrefix; + } + + + /** + * Creates a new class name in the given new package. + */ + private String generateUniqueClassName(String newPackagePrefix) + { + // Find the right name factory for this package. + NameFactory classNameFactory = + (NameFactory)packagePrefixClassNameFactoryMap.get(newPackagePrefix); + if (classNameFactory == null) + { + // We haven't seen classes in this package before. + // Create a new name factory for them. + classNameFactory = new SimpleNameFactory(useMixedCaseClassNames); + if (this.classNameFactory != null) + { + classNameFactory = + new DictionaryNameFactory(this.classNameFactory, + classNameFactory); + } + + packagePrefixClassNameFactoryMap.put(newPackagePrefix, + classNameFactory); + } + + return generateUniqueClassName(newPackagePrefix, classNameFactory); + } + + + /** + * Creates a new class name in the given new package. + */ + private String generateUniqueNumericClassName(String newPackagePrefix) + { + // Find the right name factory for this package. + NameFactory classNameFactory = + (NameFactory)packagePrefixNumericClassNameFactoryMap.get(newPackagePrefix); + if (classNameFactory == null) + { + // We haven't seen classes in this package before. + // Create a new name factory for them. + classNameFactory = new NumericNameFactory(); + + packagePrefixNumericClassNameFactoryMap.put(newPackagePrefix, + classNameFactory); + } + + return generateUniqueClassName(newPackagePrefix, classNameFactory); + } + + + /** + * Creates a new class name in the given new package, with the given + * class name factory. + */ + private String generateUniqueClassName(String newPackagePrefix, + NameFactory classNameFactory) + { + // Come up with class names until we get an original one. + String newClassName; + do + { + // Let the factory produce a class name. + newClassName = newPackagePrefix + + classNameFactory.nextName(); + } + while (classNamesToAvoid.contains(mixedCaseClassName(newClassName))); + + return newClassName; + } + + + /** + * Returns the given class name, unchanged if mixed-case class names are + * allowed, or the lower-case version otherwise. + */ + private String mixedCaseClassName(String className) + { + return useMixedCaseClassNames ? + className : + className.toLowerCase(); + } + + + /** + * Assigns a new name to the given class. + * @param clazz the given class. + * @param name the new name. + */ + static void setNewClassName(Clazz clazz, String name) + { + clazz.setVisitorInfo(name); + } + + + /** + * Retrieves the new name of the given class. + * @param clazz the given class. + * @return the class's new name, or null if it doesn't + * have one yet. + */ + static String newClassName(Clazz clazz) + { + Object visitorInfo = clazz.getVisitorInfo(); + + return visitorInfo instanceof String ? + (String)visitorInfo : + null; + } +} diff --git a/src/proguard/obfuscate/ClassRenamer.java b/src/proguard/obfuscate/ClassRenamer.java new file mode 100644 index 0000000..143e3fb --- /dev/null +++ b/src/proguard/obfuscate/ClassRenamer.java @@ -0,0 +1,109 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.editor.ConstantPoolEditor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor renames the class names and class member + * names of the classes it visits, using names previously determined by the + * obfuscator. + * + * @see ClassObfuscator + * @see MemberObfuscator + * + * @author Eric Lafortune + */ +public class ClassRenamer +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Rename this class. + programClass.thisClassConstantAccept(this); + + // Rename the class members. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + libraryClass.thisClassName = ClassObfuscator.newClassName(libraryClass); + + // Rename the class members. + libraryClass.fieldsAccept(this); + libraryClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, + ProgramMember programMember) + { + // Has the class member name changed? + String name = programMember.getName(programClass); + String newName = MemberObfuscator.newMemberName(programMember); + if (newName != null && + !newName.equals(name)) + { + programMember.u2nameIndex = + new ConstantPoolEditor(programClass).addUtf8Constant(newName); + } + } + + public void visitLibraryMember(LibraryClass libraryClass, + LibraryMember libraryMember) + { + String newName = MemberObfuscator.newMemberName(libraryMember); + if (newName != null) + { + libraryMember.name = newName; + } + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Update the Class entry if required. + String newName = ClassObfuscator.newClassName(clazz); + if (newName != null) + { + // Refer to a new Utf8 entry. + classConstant.u2nameIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newName); + } + } +} diff --git a/src/proguard/obfuscate/DictionaryNameFactory.java b/src/proguard/obfuscate/DictionaryNameFactory.java new file mode 100644 index 0000000..f262664 --- /dev/null +++ b/src/proguard/obfuscate/DictionaryNameFactory.java @@ -0,0 +1,189 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import java.io.*; +import java.util.*; + +/** + * This NameFactory generates names that are read from a + * specified input file. + * Comments (everything starting with '#' on a single line) are ignored. + * + * @author Eric Lafortune + */ +public class DictionaryNameFactory implements NameFactory +{ + private static final char COMMENT_CHARACTER = '#'; + + + private final List names; + private final NameFactory nameFactory; + + private int index = 0; + + + /** + * Creates a new DictionaryNameFactory. + * @param file the file from which the names can be read. + * @param nameFactory the name factory from which names will be retrieved + * if the list of read names has been exhausted. + */ + public DictionaryNameFactory(File file, + NameFactory nameFactory) throws IOException + { + this.names = new ArrayList(); + this.nameFactory = nameFactory; + + Reader reader = new FileReader(file); + + try + { + StringBuffer buffer = new StringBuffer(); + + while (true) + { + // Read the next character. + int c = reader.read(); + + // Is it a valid identifier character? + if (c != -1 && + (buffer.length() == 0 ? + Character.isJavaIdentifierStart((char)c) : + Character.isJavaIdentifierPart((char)c))) + { + // Append it to the current identifier. + buffer.append((char)c); + } + else + { + // Did we collect a new identifier? + if (buffer.length() > 0) + { + // Add the completed name to the list of names, if it's + // not in it yet. + String name = buffer.toString(); + if (!names.contains(name)) + { + names.add(name); + } + + // Clear the buffer. + buffer.setLength(0); + } + + // Is this the beginning of a comment line? + if (c == COMMENT_CHARACTER) + { + // Skip all characters till the end of the line. + do + { + c = reader.read(); + } + while (c != -1 && + c != '\n' && + c != '\r'); + } + + // Is this the end of the file? + if (c == -1) + { + // Just return. + return; + } + } + } + } + finally + { + reader.close(); + } + } + + + /** + * Creates a new DictionaryNameFactory. + * @param dictionaryNameFactory the dictionary name factory whose dictionary + * will be used. + * @param nameFactory the name factory from which names will be + * retrieved if the list of read names has been + * exhausted. + */ + public DictionaryNameFactory(DictionaryNameFactory dictionaryNameFactory, + NameFactory nameFactory) + { + this.names = dictionaryNameFactory.names; + this.nameFactory = nameFactory; + } + + + // Implementations for NameFactory. + + public void reset() + { + index = 0; + + nameFactory.reset(); + } + + + public String nextName() + { + String name; + + // Do we still have names? + if (index < names.size()) + { + // Return the next name. + name = (String)names.get(index++); + } + else + { + // Return the next different name from the other name factory. + do + { + name = nameFactory.nextName(); + } + while (names.contains(name)); + } + + return name; + } + + + public static void main(String[] args) + { + try + { + DictionaryNameFactory factory = + new DictionaryNameFactory(new File(args[0]), new SimpleNameFactory()); + + for (int counter = 0; counter < 50; counter++) + { + System.out.println("["+factory.nextName()+"]"); + } + } + catch (IOException ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/obfuscate/MapCleaner.java b/src/proguard/obfuscate/MapCleaner.java new file mode 100644 index 0000000..fdefec5 --- /dev/null +++ b/src/proguard/obfuscate/MapCleaner.java @@ -0,0 +1,57 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +import java.util.Map; + +/** + * This ClassVisitor clears a given map whenever it visits a class. + * + * @author Eric Lafortune + */ +public class MapCleaner +extends SimplifiedVisitor +implements ClassVisitor +{ + private final Map map; + + + /** + * Creates a new MapCleaner. + * @param map the map to be cleared. + */ + public MapCleaner(Map map) + { + this.map = map; + } + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + map.clear(); + } +} diff --git a/src/proguard/obfuscate/MappingKeeper.java b/src/proguard/obfuscate/MappingKeeper.java new file mode 100644 index 0000000..c9d6aa6 --- /dev/null +++ b/src/proguard/obfuscate/MappingKeeper.java @@ -0,0 +1,177 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.util.ListUtil; + + +/** + * This MappingKeeper applies the mappings that it receives to its class pool, + * so these mappings are ensured in a subsequent obfuscation step. + * + * @author Eric Lafortune + */ +public class MappingKeeper implements MappingProcessor +{ + private final ClassPool classPool; + private final WarningPrinter warningPrinter; + + // A field acting as a parameter. + private Clazz clazz; + + + /** + * Creates a new MappingKeeper. + * @param classPool the class pool in which class names and class + * member names have to be mapped. + * @param warningPrinter the optional warning printer to which warnings + * can be printed. + */ + public MappingKeeper(ClassPool classPool, + WarningPrinter warningPrinter) + { + this.classPool = classPool; + this.warningPrinter = warningPrinter; + } + + + // Implementations for MappingProcessor. + + public boolean processClassMapping(String className, + String newClassName) + { + // Find the class. + String name = ClassUtil.internalClassName(className); + + clazz = classPool.getClass(name); + if (clazz != null) + { + String newName = ClassUtil.internalClassName(newClassName); + + // Print out a warning if the mapping conflicts with a name that + // was set before. + if (warningPrinter != null) + { + String currentNewName = ClassObfuscator.newClassName(clazz); + if (currentNewName != null && + !currentNewName.equals(newName)) + { + warningPrinter.print(name, + currentNewName, + "Warning: " + + className + + " is not being kept as '" + + ClassUtil.externalClassName(currentNewName) + + "', but remapped to '" + + newClassName + "'"); + } + } + + ClassObfuscator.setNewClassName(clazz, newName); + + // The class members have to be kept as well. + return true; + } + + return false; + } + + + public void processFieldMapping(String className, + String fieldType, + String fieldName, + String newFieldName) + { + if (clazz != null) + { + // Find the field. + String name = fieldName; + String descriptor = ClassUtil.internalType(fieldType); + + Field field = clazz.findField(name, descriptor); + if (field != null) + { + // Print out a warning if the mapping conflicts with a name that + // was set before. + if (warningPrinter != null) + { + String currentNewName = MemberObfuscator.newMemberName(field); + if (currentNewName != null && + !currentNewName.equals(newFieldName)) + { + warningPrinter.print(ClassUtil.internalClassName(className), + "Warning: " + + className + + ": field '" + fieldType + " " + fieldName + + "' is not being kept as '" + currentNewName + + "', but remapped to '" + newFieldName + "'"); + } + } + + // Make sure the mapping name will be kept. + MemberObfuscator.setFixedNewMemberName(field, newFieldName); + } + } + } + + + public void processMethodMapping(String className, + int firstLineNumber, + int lastLineNumber, + String methodReturnType, + String methodName, + String methodArguments, + String newMethodName) + { + if (clazz != null) + { + // Find the method. + String descriptor = ClassUtil.internalMethodDescriptor(methodReturnType, + ListUtil.commaSeparatedList(methodArguments)); + + Method method = clazz.findMethod(methodName, descriptor); + if (method != null) + { + // Print out a warning if the mapping conflicts with a name that + // was set before. + if (warningPrinter != null) + { + String currentNewName = MemberObfuscator.newMemberName(method); + if (currentNewName != null && + !currentNewName.equals(newMethodName)) + { + warningPrinter.print(ClassUtil.internalClassName(className), + "Warning: " + + className + + ": method '" + methodReturnType + " " + methodName + ClassConstants.EXTERNAL_METHOD_ARGUMENTS_OPEN + methodArguments + ClassConstants.EXTERNAL_METHOD_ARGUMENTS_CLOSE + + "' is not being kept as '" + currentNewName + + "', but remapped to '" + newMethodName + "'"); + } + } + + // Make sure the mapping name will be kept. + MemberObfuscator.setFixedNewMemberName(method, newMethodName); + } + } + } +} diff --git a/src/proguard/obfuscate/MappingPrinter.java b/src/proguard/obfuscate/MappingPrinter.java new file mode 100644 index 0000000..aa8b13e --- /dev/null +++ b/src/proguard/obfuscate/MappingPrinter.java @@ -0,0 +1,147 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +import java.io.PrintStream; + + +/** + * This ClassVisitor prints out the renamed classes and class members with + * their old names and new names. + * + * @see ClassRenamer + * + * @author Eric Lafortune + */ +public class MappingPrinter +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor +{ + private final PrintStream ps; + + + /** + * Creates a new MappingPrinter that prints to System.out. + */ + public MappingPrinter() + { + this(System.out); + } + + + /** + * Creates a new MappingPrinter that prints to the given stream. + * @param printStream the stream to which to print + */ + public MappingPrinter(PrintStream printStream) + { + this.ps = printStream; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + String name = programClass.getName(); + String newName = ClassObfuscator.newClassName(programClass); + + ps.println(ClassUtil.externalClassName(name) + + " -> " + + ClassUtil.externalClassName(newName) + + ":"); + + // Print out the class members. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + String newName = MemberObfuscator.newMemberName(programField); + if (newName != null) + { + ps.println(" " + + //lineNumberRange(programClass, programField) + + ClassUtil.externalFullFieldDescription( + 0, + programField.getName(programClass), + programField.getDescriptor(programClass)) + + " -> " + + newName); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Special cases: and are always kept unchanged. + // We can ignore them here. + String name = programMethod.getName(programClass); + if (name.equals(ClassConstants.INTERNAL_METHOD_NAME_CLINIT) || + name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + return; + } + + String newName = MemberObfuscator.newMemberName(programMethod); + if (newName != null) + { + ps.println(" " + + lineNumberRange(programClass, programMethod) + + ClassUtil.externalFullMethodDescription( + programClass.getName(), + 0, + programMethod.getName(programClass), + programMethod.getDescriptor(programClass)) + + " -> " + + newName); + } + } + + + // Small utility methods. + + /** + * Returns the line number range of the given class member, followed by a + * colon, or just an empty String if no range is available. + */ + private static String lineNumberRange(ProgramClass programClass, ProgramMember programMember) + { + String range = programMember.getLineNumberRange(programClass); + return range != null ? + (range + ":") : + ""; + } +} diff --git a/src/proguard/obfuscate/MappingProcessor.java b/src/proguard/obfuscate/MappingProcessor.java new file mode 100644 index 0000000..01c1809 --- /dev/null +++ b/src/proguard/obfuscate/MappingProcessor.java @@ -0,0 +1,79 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + + +/** + * This interface specifies methods to process name mappings between original + * classes and their obfuscated versions. The mappings are typically read + * from a mapping file. + * + * @see MappingReader + * + * @author Eric Lafortune + */ +public interface MappingProcessor +{ + /** + * Processes the given class name mapping. + * + * @param className the original class name. + * @param newClassName the new class name. + * @return whether the processor is interested in receiving mappings of the + * class members of this class. + */ + public boolean processClassMapping(String className, + String newClassName); + + /** + * Processes the given field name mapping. + * + * @param className the original class name. + * @param fieldType the original external field type. + * @param fieldName the original field name. + * @param newFieldName the new field name. + */ + public void processFieldMapping(String className, + String fieldType, + String fieldName, + String newFieldName); + + /** + * Processes the given method name mapping. + * + * @param className the original class name. + * @param firstLineNumber the first line number of the method, or 0 if it + * is not known. + * @param lastLineNumber the last line number of the method, or 0 if it + * is not known. + * @param methodReturnType the original external method return type. + * @param methodName the original external method name. + * @param methodArguments the original external method arguments. + * @param newMethodName the new method name. + */ + public void processMethodMapping(String className, + int firstLineNumber, + int lastLineNumber, + String methodReturnType, + String methodName, + String methodArguments, + String newMethodName); +} diff --git a/src/proguard/obfuscate/MappingReader.java b/src/proguard/obfuscate/MappingReader.java new file mode 100644 index 0000000..24fd26c --- /dev/null +++ b/src/proguard/obfuscate/MappingReader.java @@ -0,0 +1,199 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import java.io.*; + + +/** + * This class can parse mapping files and invoke a processor for each of the + * mapping entries. + * + * @author Eric Lafortune + */ +public class MappingReader +{ + private final File mappingFile; + + + public MappingReader(File mappingFile) + { + this.mappingFile = mappingFile; + } + + + /** + * Reads the mapping file, presenting all of the encountered mapping entries + * to the given processor. + */ + public void pump(MappingProcessor mappingProcessor) throws IOException + { + LineNumberReader reader = new LineNumberReader( + new BufferedReader( + new FileReader(mappingFile))); + try + { + String className = null; + + // Read the subsequent class mappings and class member mappings. + while (true) + { + String line = reader.readLine(); + + if (line == null) + { + break; + } + + line = line.trim(); + + // The distinction between a class mapping and a class + // member mapping is the initial whitespace. + if (line.endsWith(":")) + { + // Process the class mapping and remember the class's + // old name. + className = processClassMapping(line, mappingProcessor); + } + else if (className != null) + { + // Process the class member mapping, in the context of the + // current old class name. + processClassMemberMapping(className, line, mappingProcessor); + } + } + } + catch (IOException ex) + { + throw new IOException("Can't process mapping file (" + ex.getMessage() + ")"); + } + finally + { + try + { + reader.close(); + } + catch (IOException ex) + { + // This shouldn't happen. + } + } + } + + + /** + * Parses the given line with a class mapping and processes the + * results with the given mapping processor. Returns the old class name, + * or null if any subsequent class member lines can be ignored. + */ + private String processClassMapping(String line, + MappingProcessor mappingProcessor) + { + // See if we can parse "___ -> ___:", containing the original + // class name and the new class name. + + int arrowIndex = line.indexOf("->"); + if (arrowIndex < 0) + { + return null; + } + + int colonIndex = line.indexOf(':', arrowIndex + 2); + if (colonIndex < 0) + { + return null; + } + + // Extract the elements. + String className = line.substring(0, arrowIndex).trim(); + String newClassName = line.substring(arrowIndex + 2, colonIndex).trim(); + + // Process this class name mapping. + boolean interested = mappingProcessor.processClassMapping(className, newClassName); + + return interested ? className : null; + } + + + /** + * Parses the given line with a class member mapping and processes the + * results with the given mapping processor. + */ + private void processClassMemberMapping(String className, + String line, + MappingProcessor mappingProcessor) + { + // See if we can parse "___:___:___ ___(___) -> ___", + // containing the optional line numbers, the return type, the original + // field/method name, optional arguments, and the new field/method name. + + int colonIndex1 = line.indexOf(':'); + int colonIndex2 = colonIndex1 < 0 ? -1 : line.indexOf(':', colonIndex1 + 1); + int spaceIndex = line.indexOf(' ', colonIndex2 + 2); + int argumentIndex1 = line.indexOf('(', spaceIndex + 1); + int argumentIndex2 = argumentIndex1 < 0 ? -1 : line.indexOf(')', argumentIndex1 + 1); + int arrowIndex = line.indexOf("->", Math.max(spaceIndex, argumentIndex2) + 1); + + if (spaceIndex < 0 || + arrowIndex < 0) + { + return; + } + + // Extract the elements. + String type = line.substring(colonIndex2 + 1, spaceIndex).trim(); + String name = line.substring(spaceIndex + 1, argumentIndex1 >= 0 ? argumentIndex1 : arrowIndex).trim(); + String newName = line.substring(arrowIndex + 2).trim(); + + // Process this class member mapping. + if (type.length() > 0 && + name.length() > 0 && + newName.length() > 0) + { + // Is it a field or a method? + if (argumentIndex2 < 0) + { + mappingProcessor.processFieldMapping(className, type, name, newName); + } + else + { + int firstLineNumber = 0; + int lastLineNumber = 0; + + if (colonIndex2 > 0) + { + firstLineNumber = Integer.parseInt(line.substring(0, colonIndex1).trim()); + lastLineNumber = Integer.parseInt(line.substring(colonIndex1 + 1, colonIndex2).trim()); + } + + String arguments = line.substring(argumentIndex1 + 1, argumentIndex2).trim(); + + mappingProcessor.processMethodMapping(className, + firstLineNumber, + lastLineNumber, + type, + name, + arguments, + newName); + } + } + } +} diff --git a/src/proguard/obfuscate/MemberNameCleaner.java b/src/proguard/obfuscate/MemberNameCleaner.java new file mode 100644 index 0000000..c41c59d --- /dev/null +++ b/src/proguard/obfuscate/MemberNameCleaner.java @@ -0,0 +1,60 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This MemberVisitor clears the new names of the class members + * that it visits. + * + * @see MemberObfuscator + * + * @author Eric Lafortune + */ +public class MemberNameCleaner implements MemberVisitor +{ + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + MemberObfuscator.setNewMemberName(programField, null); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + MemberObfuscator.setNewMemberName(programMethod, null); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + MemberObfuscator.setNewMemberName(libraryField, null); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + MemberObfuscator.setNewMemberName(libraryMethod, null); + } +} diff --git a/src/proguard/obfuscate/MemberNameCollector.java b/src/proguard/obfuscate/MemberNameCollector.java new file mode 100644 index 0000000..c248820 --- /dev/null +++ b/src/proguard/obfuscate/MemberNameCollector.java @@ -0,0 +1,106 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +import java.util.Map; + +/** + * This MemberVisitor collects all new (obfuscation) names of the members + * that it visits. + * + * @see MemberObfuscator + * + * @author Eric Lafortune + */ +public class MemberNameCollector +extends SimplifiedVisitor +implements MemberVisitor +{ + private final boolean allowAggressiveOverloading; + private final Map descriptorMap; + + + /** + * Creates a new MemberNameCollector. + * @param allowAggressiveOverloading a flag that specifies whether class + * members can be overloaded aggressively. + * @param descriptorMap the map of descriptors to + * [new name - old name] maps. + */ + public MemberNameCollector(boolean allowAggressiveOverloading, + Map descriptorMap) + { + this.allowAggressiveOverloading = allowAggressiveOverloading; + this.descriptorMap = descriptorMap; + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + // Special cases: and are always kept unchanged. + // We can ignore them here. + String name = member.getName(clazz); + if (name.equals(ClassConstants.INTERNAL_METHOD_NAME_CLINIT) || + name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + return; + } + + // Get the member's new name. + String newName = MemberObfuscator.newMemberName(member); + + // Remember it, if it has already been set. + if (newName != null) + { + // Get the member's descriptor. + String descriptor = member.getDescriptor(clazz); + + // Check whether we're allowed to do aggressive overloading + if (!allowAggressiveOverloading) + { + // Trim the return argument from the descriptor if not. + // Works for fields and methods alike. + descriptor = descriptor.substring(0, descriptor.indexOf(')')+1); + } + + // Put the [descriptor - new name] in the map, + // creating a new [new name - old name] map if necessary. + Map nameMap = MemberObfuscator.retrieveNameMap(descriptorMap, descriptor); + + // Isn't there another original name for this new name, or should + // this original name get priority? + String otherName = (String)nameMap.get(newName); + if (otherName == null || + MemberObfuscator.hasFixedNewMemberName(member) || + name.compareTo(otherName) < 0) + { + // Remember not to use the new name again in this name space. + nameMap.put(newName, name); + } + } + } +} diff --git a/src/proguard/obfuscate/MemberNameConflictFixer.java b/src/proguard/obfuscate/MemberNameConflictFixer.java new file mode 100644 index 0000000..b9093a6 --- /dev/null +++ b/src/proguard/obfuscate/MemberNameConflictFixer.java @@ -0,0 +1,159 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; + +import java.util.Map; + +/** + * This MemberInfoVisitor solves obfuscation naming conflicts in all class + * members that it visits. It avoids names from the given descriptor map, + * delegating to the given obfuscator in order to get a new name if necessary. + * + * @author Eric Lafortune + */ +public class MemberNameConflictFixer implements MemberVisitor +{ + private final boolean allowAggressiveOverloading; + private final Map descriptorMap; + private final WarningPrinter warningPrinter; + private final MemberObfuscator memberObfuscator; + + + /** + * Creates a new MemberNameConflictFixer. + * @param allowAggressiveOverloading a flag that specifies whether class + * members can be overloaded aggressively. + * @param descriptorMap the map of descriptors to + * [new name - old name] maps. + * @param warningPrinter an optional warning printer to which + * warnings about conflicting name + * mappings can be printed. + * @param memberObfuscator the obfuscator that can assign new + * names to members with conflicting + * names. + */ + public MemberNameConflictFixer(boolean allowAggressiveOverloading, + Map descriptorMap, + WarningPrinter warningPrinter, + MemberObfuscator memberObfuscator) + { + this.allowAggressiveOverloading = allowAggressiveOverloading; + this.descriptorMap = descriptorMap; + this.warningPrinter = warningPrinter; + this.memberObfuscator = memberObfuscator; + } + + + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + visitMember(programClass, programField, true); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Special cases: and are always kept unchanged. + // We can ignore them here. + String name = programMethod.getName(programClass); + if (name.equals(ClassConstants.INTERNAL_METHOD_NAME_CLINIT) || + name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + return; + } + + visitMember(programClass, programMethod, false); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) {} + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) {} + + + /** + * Obfuscates the given class member. + * @param clazz the class of the given member. + * @param member the class member to be obfuscated. + * @param isField specifies whether the class member is a field. + */ + private void visitMember(Clazz clazz, + Member member, + boolean isField) + { + // Get the member's name and descriptor. + String name = member.getName(clazz); + String descriptor = member.getDescriptor(clazz); + + // Check whether we're allowed to overload aggressively. + if (!allowAggressiveOverloading) + { + // Trim the return argument from the descriptor if not. + // Works for fields and methods alike. + descriptor = descriptor.substring(0, descriptor.indexOf(')')+1); + } + + // Get the name map. + Map nameMap = MemberObfuscator.retrieveNameMap(descriptorMap, descriptor); + + // Get the member's new name. + String newName = MemberObfuscator.newMemberName(member); + + // Get the expected old name for this new name. + String previousName = (String)nameMap.get(newName); + if (previousName != null && + !name.equals(previousName)) + { + // There's a conflict! A member (with a given old name) in a + // first namespace has received the same new name as this + // member (with a different old name) in a second name space, + // and now these two have to live together in this name space. + if (MemberObfuscator.hasFixedNewMemberName(member) && + warningPrinter != null) + { + descriptor = member.getDescriptor(clazz); + warningPrinter.print(clazz.getName(), + "Warning: " + ClassUtil.externalClassName(clazz.getName()) + + (isField ? + ": field '" + ClassUtil.externalFullFieldDescription(0, name, descriptor) : + ": method '" + ClassUtil.externalFullMethodDescription(clazz.getName(), 0, name, descriptor)) + + "' can't be mapped to '" + newName + + "' because it would conflict with " + + (isField ? + "field '" : + "method '" ) + previousName + + "', which is already being mapped to '" + newName + "'"); + } + + // Clear the conflicting name. + MemberObfuscator.setNewMemberName(member, null); + + // Assign a new name. + member.accept(clazz, memberObfuscator); + } + } +} diff --git a/src/proguard/obfuscate/MemberObfuscator.java b/src/proguard/obfuscate/MemberObfuscator.java new file mode 100644 index 0000000..332b849 --- /dev/null +++ b/src/proguard/obfuscate/MemberObfuscator.java @@ -0,0 +1,230 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; + +import java.util.*; + +/** + * This MemberVisitor obfuscates all class members that it visits. + * It uses names from the given name factory. At the same time, it avoids names + * from the given descriptor map. + *

    + * The class members must have been linked before applying this visitor. + * + * @see MethodLinker + * + * @author Eric Lafortune + */ +public class MemberObfuscator +extends SimplifiedVisitor +implements MemberVisitor +{ + private final boolean allowAggressiveOverloading; + private final NameFactory nameFactory; + private final Map descriptorMap; + + + /** + * Creates a new MemberObfuscator. + * @param allowAggressiveOverloading a flag that specifies whether class + * members can be overloaded aggressively. + * @param nameFactory the factory that can produce + * obfuscated member names. + * @param descriptorMap the map of descriptors to + * [new name - old name] maps. + */ + public MemberObfuscator(boolean allowAggressiveOverloading, + NameFactory nameFactory, + Map descriptorMap) + { + this.allowAggressiveOverloading = allowAggressiveOverloading; + this.nameFactory = nameFactory; + this.descriptorMap = descriptorMap; + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + // Special cases: and are always kept unchanged. + // We can ignore them here. + String name = member.getName(clazz); + if (name.equals(ClassConstants.INTERNAL_METHOD_NAME_CLINIT) || + name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + return; + } + + // Get the member's descriptor. + String descriptor = member.getDescriptor(clazz); + + // Check whether we're allowed to do aggressive overloading + if (!allowAggressiveOverloading) + { + // Trim the return argument from the descriptor if not. + // Works for fields and methods alike. + descriptor = descriptor.substring(0, descriptor.indexOf(')')+1); + } + + // Get the name map, creating a new one if necessary. + Map nameMap = retrieveNameMap(descriptorMap, descriptor); + + // Get the member's new name. + String newName = newMemberName(member); + + // Assign a new one, if necessary. + if (newName == null) + { + // Find an acceptable new name. + nameFactory.reset(); + + do + { + newName = nameFactory.nextName(); + } + while (nameMap.containsKey(newName)); + + // Remember not to use the new name again in this name space. + nameMap.put(newName, name); + + // Assign the new name. + setNewMemberName(member, newName); + } + } + + + // Small utility methods. + + /** + * Gets the name map, based on the given map and a given descriptor. + * A new empty map is created if necessary. + * @param descriptorMap the map of descriptors to [new name - old name] maps. + * @param descriptor the class member descriptor. + * @return the corresponding name map. + */ + static Map retrieveNameMap(Map descriptorMap, String descriptor) + { + // See if we can find the nested map with this descriptor key. + Map nameMap = (Map)descriptorMap.get(descriptor); + + // Create a new one if not. + if (nameMap == null) + { + nameMap = new HashMap(); + descriptorMap.put(descriptor, nameMap); + } + + return nameMap; + } + + + /** + * Assigns a fixed new name to the given class member. + * @param member the class member. + * @param name the new name. + */ + static void setFixedNewMemberName(Member member, String name) + { + VisitorAccepter lastVisitorAccepter = MethodLinker.lastVisitorAccepter(member); + + if (!(lastVisitorAccepter instanceof LibraryMember) && + !(lastVisitorAccepter instanceof MyFixedName)) + { + lastVisitorAccepter.setVisitorInfo(new MyFixedName(name)); + } + else + { + lastVisitorAccepter.setVisitorInfo(name); + } + } + + + /** + * Assigns a new name to the given class member. + * @param member the class member. + * @param name the new name. + */ + static void setNewMemberName(Member member, String name) + { + MethodLinker.lastVisitorAccepter(member).setVisitorInfo(name); + } + + + /** + * Returns whether the new name of the given class member is fixed. + * @param member the class member. + * @return whether its new name is fixed. + */ + static boolean hasFixedNewMemberName(Member member) + { + VisitorAccepter lastVisitorAccepter = MethodLinker.lastVisitorAccepter(member); + + return lastVisitorAccepter instanceof LibraryMember || + lastVisitorAccepter instanceof MyFixedName; + } + + + /** + * Retrieves the new name of the given class member. + * @param member the class member. + * @return the class member's new name, or null if it doesn't + * have one yet. + */ + static String newMemberName(Member member) + { + return (String)MethodLinker.lastVisitorAccepter(member).getVisitorInfo(); + } + + + /** + * This VisitorAccepter can be used to wrap a name string, to indicate that + * the name is fixed. + */ + private static class MyFixedName implements VisitorAccepter + { + private String newName; + + + public MyFixedName(String newName) + { + this.newName = newName; + } + + + // Implementations for VisitorAccepter. + + public Object getVisitorInfo() + { + return newName; + } + + + public void setVisitorInfo(Object visitorInfo) + { + newName = (String)visitorInfo; + } + } +} diff --git a/src/proguard/obfuscate/MemberSpecialNameFilter.java b/src/proguard/obfuscate/MemberSpecialNameFilter.java new file mode 100644 index 0000000..f83374b --- /dev/null +++ b/src/proguard/obfuscate/MemberSpecialNameFilter.java @@ -0,0 +1,101 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when the visited member has a + * special new name. A special name is a name that might have been produced by + * a SpecialNameFactory. + * + * @see MemberObfuscator + * @see SpecialNameFactory + * + * @author Eric Lafortune + */ +public class MemberSpecialNameFilter implements MemberVisitor +{ + private final MemberVisitor memberVisitor; + + + /** + * Creates a new MemberSpecialNameFilter. + * @param memberVisitor the MemberVisitor to which + * visits will be delegated. + */ + public MemberSpecialNameFilter(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (isSpecialName(programField)) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (isSpecialName(programMethod)) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (isSpecialName(libraryField)) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (isSpecialName(libraryMethod)) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } + + + // Small utility methods. + + /** + * Returns whether the given class member has a special new name. + * @param member the class member. + */ + private static boolean isSpecialName(Member member) + { + return SpecialNameFactory.isSpecialName(MemberObfuscator.newMemberName(member)); + } +} diff --git a/src/proguard/obfuscate/MultiMappingProcessor.java b/src/proguard/obfuscate/MultiMappingProcessor.java new file mode 100644 index 0000000..4074ff8 --- /dev/null +++ b/src/proguard/obfuscate/MultiMappingProcessor.java @@ -0,0 +1,96 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +/** + * This MappingKeeper delegates all method calls to each MappingProcessor + * in a given list. + * + * @author Eric Lafortune + */ +public class MultiMappingProcessor implements MappingProcessor +{ + private final MappingProcessor[] mappingProcessors; + + + /** + * Creates a new MultiMappingProcessor. + * @param mappingProcessors the mapping processors to which method calls + * will be delegated. + */ + public MultiMappingProcessor(MappingProcessor[] mappingProcessors) + { + this.mappingProcessors = mappingProcessors; + } + + + // Implementations for MappingProcessor. + + public boolean processClassMapping(String className, + String newClassName) + { + boolean result = false; + + for (int index = 0; index < mappingProcessors.length; index++) + { + result |= mappingProcessors[index].processClassMapping(className, + newClassName); + } + + return result; + } + + + public void processFieldMapping(String className, + String fieldType, + String fieldName, + String newFieldName) + { + for (int index = 0; index < mappingProcessors.length; index++) + { + mappingProcessors[index].processFieldMapping(className, + fieldType, + fieldName, + newFieldName); + } + } + + + public void processMethodMapping(String className, + int firstLineNumber, + int lastLineNumber, + String methodReturnType, + String methodName, + String methodArguments, + String newMethodName) + { + for (int index = 0; index < mappingProcessors.length; index++) + { + mappingProcessors[index].processMethodMapping(className, + firstLineNumber, + lastLineNumber, + methodReturnType, + methodName, + methodArguments, + newMethodName); + } + } +} diff --git a/src/proguard/obfuscate/NameAndTypeShrinker.java b/src/proguard/obfuscate/NameAndTypeShrinker.java new file mode 100644 index 0000000..1284c82 --- /dev/null +++ b/src/proguard/obfuscate/NameAndTypeShrinker.java @@ -0,0 +1,112 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.constant.Constant; +import proguard.classfile.editor.ConstantPoolRemapper; +import proguard.classfile.visitor.ClassVisitor; + + +/** + * This ClassVisitor removes NameAndType constant pool entries + * that are not marked as being used. + * + * @see NameAndTypeUsageMarker + * + * @author Eric Lafortune + */ +public class NameAndTypeShrinker implements ClassVisitor +{ + private int[] constantIndexMap; + private final ConstantPoolRemapper constantPoolRemapper = new ConstantPoolRemapper(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Shift the used constant pool entries together, filling out the + // index map. + programClass.u2constantPoolCount = + shrinkConstantPool(programClass.constantPool, + programClass.u2constantPoolCount); + + + // Remap all constant pool references. + constantPoolRemapper.setConstantIndexMap(constantIndexMap); + constantPoolRemapper.visitProgramClass(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Small utility methods. + + /** + * Removes all NameAndType entries that are not marked as being used + * from the given constant pool. + * @return the new number of entries. + */ + private int shrinkConstantPool(Constant[] constantPool, int length) + { + // Create a new index map, if necessary. + if (constantIndexMap == null || + constantIndexMap.length < length) + { + constantIndexMap = new int[length]; + } + + int counter = 1; + boolean isUsed = false; + + // Shift the used constant pool entries together. + for (int index = 1; index < length; index++) + { + constantIndexMap[index] = counter; + + Constant constant = constantPool[index]; + + // Don't update the flag if this is the second half of a long entry. + if (constant != null) + { + isUsed = constant.getTag() != ClassConstants.CONSTANT_NameAndType || + NameAndTypeUsageMarker.isUsed(constant); + } + + if (isUsed) + { + constantPool[counter++] = constant; + } + } + + // Clear the remaining constant pool elements. + for (int index = counter; index < length; index++) + { + constantPool[index] = null; + } + + return counter; + } +} diff --git a/src/proguard/obfuscate/NameAndTypeUsageMarker.java b/src/proguard/obfuscate/NameAndTypeUsageMarker.java new file mode 100644 index 0000000..cc779f0 --- /dev/null +++ b/src/proguard/obfuscate/NameAndTypeUsageMarker.java @@ -0,0 +1,135 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor marks all NameAndType constant pool entries that are + * being used in the program classes it visits. + * + * @see NameAndTypeShrinker + * + * @author Eric Lafortune + */ +public class NameAndTypeUsageMarker +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + AttributeVisitor +{ + // A visitor info flag to indicate the NameAndType constant pool entry is being used. + private static final Object USED = new Object(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Mark the NameAndType entries referenced by all other constant pool + // entries. + programClass.constantPoolEntriesAccept(this); + + // Mark the NameAndType entries referenced by all EnclosingMethod + // attributes. + programClass.attributesAccept(this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + visitRefConstant(clazz, fieldrefConstant); + } + + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) + { + visitRefConstant(clazz, interfaceMethodrefConstant); + } + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + visitRefConstant(clazz, methodrefConstant); + } + + + private void visitRefConstant(Clazz clazz, RefConstant refConstant) + { + markNameAndTypeConstant(clazz, refConstant.u2nameAndTypeIndex); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + if (enclosingMethodAttribute.u2nameAndTypeIndex != 0) + { + markNameAndTypeConstant(clazz, enclosingMethodAttribute.u2nameAndTypeIndex); + } + } + + + // Small utility methods. + + /** + * Marks the given UTF-8 constant pool entry of the given class. + */ + private void markNameAndTypeConstant(Clazz clazz, int index) + { + markAsUsed((NameAndTypeConstant)((ProgramClass)clazz).getConstant(index)); + } + + + /** + * Marks the given VisitorAccepter as being used. + * In this context, the VisitorAccepter will be a NameAndTypeConstant object. + */ + private static void markAsUsed(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(USED); + } + + + /** + * Returns whether the given VisitorAccepter has been marked as being used. + * In this context, the VisitorAccepter will be a NameAndTypeConstant object. + */ + static boolean isUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() == USED; + } +} diff --git a/src/proguard/obfuscate/NameFactory.java b/src/proguard/obfuscate/NameFactory.java new file mode 100644 index 0000000..c64d1ad --- /dev/null +++ b/src/proguard/obfuscate/NameFactory.java @@ -0,0 +1,34 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +/** + * This interfaces provides methods to generate unique sequences of names. + * The names must be valid Java identifiers. + * + * @author Eric Lafortune + */ +public interface NameFactory +{ + public void reset(); + + public String nextName(); +} diff --git a/src/proguard/obfuscate/NameFactoryResetter.java b/src/proguard/obfuscate/NameFactoryResetter.java new file mode 100644 index 0000000..b6ba6ad --- /dev/null +++ b/src/proguard/obfuscate/NameFactoryResetter.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor resets a given name factory whenever it visits a class + * file. + * + * @author Eric Lafortune + */ +public class NameFactoryResetter implements ClassVisitor +{ + private final NameFactory nameFactory; + + + /** + * Creates a new NameFactoryResetter. + * @param nameFactory the name factory to be reset. + */ + public NameFactoryResetter(NameFactory nameFactory) + { + this.nameFactory = nameFactory; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + nameFactory.reset(); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + nameFactory.reset(); + } +} diff --git a/src/proguard/obfuscate/NameMarker.java b/src/proguard/obfuscate/NameMarker.java new file mode 100644 index 0000000..2ce0ee9 --- /dev/null +++ b/src/proguard/obfuscate/NameMarker.java @@ -0,0 +1,166 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.visitor.*; + + +/** + * This ClassVisitor and MemberVisitor + * marks names of the classes and class members it visits. The marked names + * will remain unchanged in the obfuscation step. + * + * @see ClassObfuscator + * @see MemberObfuscator + * + * @author Eric Lafortune + */ +class NameMarker +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + ConstantVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + keepClassName(programClass); + + // Make sure any outer class names are kept as well. + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + keepClassName(libraryClass); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + keepFieldName(programClass, programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + keepMethodName(programClass, programMethod); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + keepFieldName(libraryClass, libraryField); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + keepMethodName(libraryClass, libraryMethod); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Make sure the outer class names are kept as well. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + // Make sure the outer class name is kept as well. + int innerClassIndex = innerClassesInfo.u2innerClassIndex; + int outerClassIndex = innerClassesInfo.u2outerClassIndex; + if (innerClassIndex != 0 && + outerClassIndex != 0 && + clazz.getClassName(innerClassIndex).equals(clazz.getName())) + { + clazz.constantPoolEntryAccept(outerClassIndex, this); + } + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Make sure the outer class name is kept as well. + classConstant.referencedClassAccept(this); + } + + + // Small utility method. + + /** + * Ensures the name of the given class name will be kept. + */ + public void keepClassName(Clazz clazz) + { + ClassObfuscator.setNewClassName(clazz, + clazz.getName()); + } + + + /** + * Ensures the name of the given field name will be kept. + */ + private void keepFieldName(Clazz clazz, Field field) + { + MemberObfuscator.setFixedNewMemberName(field, + field.getName(clazz)); + } + + + /** + * Ensures the name of the given method name will be kept. + */ + private void keepMethodName(Clazz clazz, Method method) + { + String name = method.getName(clazz); + + if (!name.equals(ClassConstants.INTERNAL_METHOD_NAME_CLINIT) && + !name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + MemberObfuscator.setFixedNewMemberName(method, + method.getName(clazz)); + } + } +} diff --git a/src/proguard/obfuscate/NumericNameFactory.java b/src/proguard/obfuscate/NumericNameFactory.java new file mode 100644 index 0000000..cc21c4b --- /dev/null +++ b/src/proguard/obfuscate/NumericNameFactory.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import java.util.*; + + +/** + * This NameFactory generates unique numeric names, starting at + * "1". + * + * @author Eric Lafortune + */ +public class NumericNameFactory implements NameFactory +{ + private int index; + + + // Implementations for NameFactory. + + public void reset() + { + index = 0; + } + + + public String nextName() + { + return Integer.toString(++index); + } +} \ No newline at end of file diff --git a/src/proguard/obfuscate/Obfuscator.java b/src/proguard/obfuscate/Obfuscator.java new file mode 100644 index 0000000..dce563a --- /dev/null +++ b/src/proguard/obfuscate/Obfuscator.java @@ -0,0 +1,429 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.*; +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.visitor.AllConstantVisitor; +import proguard.classfile.editor.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.util.*; + +import java.io.*; +import java.util.*; + +/** + * This class can perform obfuscation of class pools according to a given + * specification. + * + * @author Eric Lafortune + */ +public class Obfuscator +{ + private final Configuration configuration; + + + /** + * Creates a new Obfuscator. + */ + public Obfuscator(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Performs obfuscation of the given program class pool. + */ + public void execute(ClassPool programClassPool, + ClassPool libraryClassPool) throws IOException + { + // Check if we have at least some keep commands. + if (configuration.keep == null && + configuration.applyMapping == null && + configuration.printMapping == null) + { + throw new IOException("You have to specify '-keep' options for the obfuscation step."); + } + + // Clean up any old visitor info. + programClassPool.classesAccept(new ClassCleaner()); + libraryClassPool.classesAccept(new ClassCleaner()); + + // If the class member names have to correspond globally, + // link all class members in all classes, otherwise + // link all non-private methods in all class hierarchies. + ClassVisitor memberInfoLinker = + configuration.useUniqueClassMemberNames ? + (ClassVisitor)new AllMemberVisitor(new MethodLinker()) : + (ClassVisitor)new BottomClassFilter(new MethodLinker()); + + programClassPool.classesAccept(memberInfoLinker); + libraryClassPool.classesAccept(memberInfoLinker); + + // Create a visitor for marking the seeds. + NameMarker nameMarker = new NameMarker(); + ClassPoolVisitor classPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(configuration.keep, + nameMarker, + nameMarker, + false, + false, + true); + // Mark the seeds. + programClassPool.accept(classPoolvisitor); + libraryClassPool.accept(classPoolvisitor); + + // All library classes and library class members keep their names. + libraryClassPool.classesAccept(nameMarker); + libraryClassPool.classesAccept(new AllMemberVisitor(nameMarker)); + + // Mark attributes that have to be kept. + AttributeUsageMarker requiredAttributeUsageMarker = + new AttributeUsageMarker(); + + AttributeVisitor optionalAttributeUsageMarker = + configuration.keepAttributes == null ? null : + new AttributeNameFilter(new ListParser(new NameParser()).parse(configuration.keepAttributes), + requiredAttributeUsageMarker); + + programClassPool.classesAccept( + new AllAttributeVisitor(true, + new RequiredAttributeFilter(requiredAttributeUsageMarker, + optionalAttributeUsageMarker))); + + // Remove the attributes that can be discarded. Note that the attributes + // may only be discarded after the seeds have been marked, since the + // configuration may rely on annotations. + programClassPool.classesAccept(new AttributeShrinker()); + + // Apply the mapping, if one has been specified. The mapping can + // override the names of library classes and of library class members. + if (configuration.applyMapping != null) + { + WarningPrinter warningPrinter = new WarningPrinter(System.err, configuration.warn); + + MappingReader reader = new MappingReader(configuration.applyMapping); + + MappingProcessor keeper = + new MultiMappingProcessor(new MappingProcessor[] + { + new MappingKeeper(programClassPool, warningPrinter), + new MappingKeeper(libraryClassPool, null), + }); + + reader.pump(keeper); + + // Print out a summary of the warnings if necessary. + int mappingWarningCount = warningPrinter.getWarningCount(); + if (mappingWarningCount > 0) + { + System.err.println("Warning: there were " + mappingWarningCount + + " kept classes and class members that were remapped anyway."); + System.err.println(" You should adapt your configuration or edit the mapping file."); + + if (!configuration.ignoreWarnings) + { + System.err.println(" If you are sure this remapping won't hurt,"); + System.err.println(" you could try your luck using the '-ignorewarnings' option."); + throw new IOException("Please correct the above warnings first."); + } + } + } + + // Come up with new names for all classes. + DictionaryNameFactory classNameFactory = configuration.classObfuscationDictionary != null ? + new DictionaryNameFactory(configuration.classObfuscationDictionary, null) : + null; + + DictionaryNameFactory packageNameFactory = configuration.packageObfuscationDictionary != null ? + new DictionaryNameFactory(configuration.packageObfuscationDictionary, null) : + null; + + programClassPool.classesAccept( + new ClassObfuscator(programClassPool, + classNameFactory, + packageNameFactory, + configuration.useMixedCaseClassNames, + configuration.keepPackageNames, + configuration.flattenPackageHierarchy, + configuration.repackageClasses, + configuration.allowAccessModification)); + + // Come up with new names for all class members. + NameFactory nameFactory = new SimpleNameFactory(); + + if (configuration.obfuscationDictionary != null) + { + nameFactory = new DictionaryNameFactory(configuration.obfuscationDictionary, + nameFactory); + } + + WarningPrinter warningPrinter = new WarningPrinter(System.err, configuration.warn); + + // Maintain a map of names to avoid [descriptor - new name - old name]. + Map descriptorMap = new HashMap(); + + // Do the class member names have to be globally unique? + if (configuration.useUniqueClassMemberNames) + { + // Collect all member names in all classes. + programClassPool.classesAccept( + new AllMemberVisitor( + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap))); + + // Assign new names to all members in all classes. + programClassPool.classesAccept( + new AllMemberVisitor( + new MemberObfuscator(configuration.overloadAggressively, + nameFactory, + descriptorMap))); + } + else + { + // Come up with new names for all non-private class members. + programClassPool.classesAccept( + new MultiClassVisitor(new ClassVisitor[] + { + // Collect all private member names in this class and down + // the hierarchy. + new ClassHierarchyTraveler(true, false, false, true, + new AllMemberVisitor( + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_PRIVATE, 0, + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)))), + + // Collect all non-private member names anywhere in the hierarchy. + new ClassHierarchyTraveler(true, true, true, true, + new AllMemberVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)))), + + // Assign new names to all non-private members in this class. + new AllMemberVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberObfuscator(configuration.overloadAggressively, + nameFactory, + descriptorMap))), + + // Clear the collected names. + new MapCleaner(descriptorMap) + })); + + // Come up with new names for all private class members. + programClassPool.classesAccept( + new MultiClassVisitor(new ClassVisitor[] + { + // Collect all member names in this class. + new AllMemberVisitor( + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)), + + // Collect all non-private member names higher up the hierarchy. + new ClassHierarchyTraveler(false, true, true, false, + new AllMemberVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)))), + + // Assign new names to all private members in this class. + new AllMemberVisitor( + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_PRIVATE, 0, + new MemberObfuscator(configuration.overloadAggressively, + nameFactory, + descriptorMap))), + + // Clear the collected names. + new MapCleaner(descriptorMap) + })); + } + + // Some class members may have ended up with conflicting names. + // Come up with new, globally unique names for them. + NameFactory specialNameFactory = + new SpecialNameFactory(new SimpleNameFactory()); + + // Collect a map of special names to avoid + // [descriptor - new name - old name]. + Map specialDescriptorMap = new HashMap(); + + programClassPool.classesAccept( + new AllMemberVisitor( + new MemberSpecialNameFilter( + new MemberNameCollector(configuration.overloadAggressively, + specialDescriptorMap)))); + + libraryClassPool.classesAccept( + new AllMemberVisitor( + new MemberSpecialNameFilter( + new MemberNameCollector(configuration.overloadAggressively, + specialDescriptorMap)))); + + // Replace conflicting non-private member names with special names. + programClassPool.classesAccept( + new MultiClassVisitor(new ClassVisitor[] + { + // Collect all private member names in this class and down + // the hierarchy. + new ClassHierarchyTraveler(true, false, false, true, + new AllMemberVisitor( + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_PRIVATE, 0, + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)))), + + // Collect all non-private member names in this class and + // higher up the hierarchy. + new ClassHierarchyTraveler(true, true, true, false, + new AllMemberVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)))), + + // Assign new names to all conflicting non-private members + // in this class and higher up the hierarchy. + new ClassHierarchyTraveler(true, true, true, false, + new AllMemberVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberNameConflictFixer(configuration.overloadAggressively, + descriptorMap, + warningPrinter, + new MemberObfuscator(configuration.overloadAggressively, + specialNameFactory, + specialDescriptorMap))))), + + // Clear the collected names. + new MapCleaner(descriptorMap) + })); + + // Replace conflicting private member names with special names. + // This is only possible if those names were kept or mapped. + programClassPool.classesAccept( + new MultiClassVisitor(new ClassVisitor[] + { + // Collect all member names in this class. + new AllMemberVisitor( + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)), + + // Collect all non-private member names higher up the hierarchy. + new ClassHierarchyTraveler(false, true, true, false, + new AllMemberVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberNameCollector(configuration.overloadAggressively, + descriptorMap)))), + + // Assign new names to all conflicting private members in this + // class. + new AllMemberVisitor( + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_PRIVATE, 0, + new MemberNameConflictFixer(configuration.overloadAggressively, + descriptorMap, + warningPrinter, + new MemberObfuscator(configuration.overloadAggressively, + specialNameFactory, + specialDescriptorMap)))), + + // Clear the collected names. + new MapCleaner(descriptorMap) + })); + + // Print out any warnings about member name conflicts. + int warningCount = warningPrinter.getWarningCount(); + if (warningCount > 0) + { + System.err.println("Warning: there were " + warningCount + + " conflicting class member name mappings."); + System.err.println(" Your configuration may be inconsistent."); + + if (!configuration.ignoreWarnings) + { + System.err.println(" If you are sure the conflicts are harmless,"); + System.err.println(" you could try your luck using the '-ignorewarnings' option."); + throw new IOException("Please correct the above warnings first."); + } + } + + // Print out the mapping, if requested. + if (configuration.printMapping != null) + { + PrintStream ps = isFile(configuration.printMapping) ? + new PrintStream(new BufferedOutputStream(new FileOutputStream(configuration.printMapping))) : + System.out; + + // Print out items that will be removed. + programClassPool.classesAcceptAlphabetically(new MappingPrinter(ps)); + + if (ps != System.out) + { + ps.close(); + } + } + + // Actually apply the new names. + programClassPool.classesAccept(new ClassRenamer()); + libraryClassPool.classesAccept(new ClassRenamer()); + + // Update all references to these new names. + programClassPool.classesAccept(new ClassReferenceFixer(false)); + libraryClassPool.classesAccept(new ClassReferenceFixer(false)); + programClassPool.classesAccept(new MemberReferenceFixer()); + + // Make package visible elements public or protected, if obfuscated + // classes are being repackaged aggressively. + if (configuration.repackageClasses != null && + configuration.allowAccessModification) + { + programClassPool.classesAccept( + new AllConstantVisitor( + new AccessFixer())); + } + + // Rename the source file attributes, if requested. + if (configuration.newSourceFileAttribute != null) + { + programClassPool.classesAccept(new SourceFileRenamer(configuration.newSourceFileAttribute)); + } + + // Mark NameAndType constant pool entries that have to be kept + // and remove the other ones. + programClassPool.classesAccept(new NameAndTypeUsageMarker()); + programClassPool.classesAccept(new NameAndTypeShrinker()); + + // Mark Utf8 constant pool entries that have to be kept + // and remove the other ones. + programClassPool.classesAccept(new Utf8UsageMarker()); + programClassPool.classesAccept(new Utf8Shrinker()); + } + + + /** + * Returns whether the given file is actually a file, or just a placeholder + * for the standard output. + */ + private boolean isFile(File file) + { + return file.getPath().length() > 0; + } +} diff --git a/src/proguard/obfuscate/SimpleNameFactory.java b/src/proguard/obfuscate/SimpleNameFactory.java new file mode 100644 index 0000000..bce22de --- /dev/null +++ b/src/proguard/obfuscate/SimpleNameFactory.java @@ -0,0 +1,156 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import java.util.*; + + +/** + * This NameFactory generates unique short names, using mixed-case + * characters or lower-case characters only. + * + * @author Eric Lafortune + */ +public class SimpleNameFactory implements NameFactory +{ + private static final int CHARACTER_COUNT = 26; + + private static final List cachedMixedCaseNames = new ArrayList(); + private static final List cachedLowerCaseNames = new ArrayList(); + + private final boolean generateMixedCaseNames; + private int index = 0; + + + /** + * Creates a new SimpleNameFactory that generates mixed-case names. + */ + public SimpleNameFactory() + { + this(true); + } + + + /** + * Creates a new SimpleNameFactory. + * @param generateMixedCaseNames a flag to indicate whether the generated + * names will be mixed-case, or lower-case only. + */ + public SimpleNameFactory(boolean generateMixedCaseNames) + { + this.generateMixedCaseNames = generateMixedCaseNames; + } + + + // Implementations for NameFactory. + + public void reset() + { + index = 0; + } + + + public String nextName() + { + return name(index++); + } + + + /** + * Returns the name at the given index. + */ + private String name(int index) + { + // Which cache do we need? + List cachedNames = generateMixedCaseNames ? + cachedMixedCaseNames : + cachedLowerCaseNames; + + // Do we have the name in the cache? + if (index < cachedNames.size()) + { + return (String)cachedNames.get(index); + } + + // Create a new name and cache it. + String name = newName(index); + cachedNames.add(index, name); + + return name; + } + + + /** + * Creates and returns the name at the given index. + */ + private String newName(int index) + { + // If we're allowed to generate mixed-case names, we can use twice as + // many characters. + int totalCharacterCount = generateMixedCaseNames ? + 2 * CHARACTER_COUNT : + CHARACTER_COUNT; + + int baseIndex = index / totalCharacterCount; + int offset = index % totalCharacterCount; + + char newChar = charAt(offset); + + String newName = baseIndex == 0 ? + new String(new char[] { newChar }) : + (name(baseIndex-1) + newChar); + + return newName; + } + + + /** + * Returns the character with the given index, between 0 and the number of + * acceptable characters. + */ + private char charAt(int index) + { + return (char)((index < CHARACTER_COUNT ? 'a' - 0 : + 'A' - CHARACTER_COUNT) + index); + } + + + public static void main(String[] args) + { + System.out.println("Some mixed-case names:"); + printNameSamples(new SimpleNameFactory(true), 60); + System.out.println("Some lower-case names:"); + printNameSamples(new SimpleNameFactory(false), 60); + System.out.println("Some more mixed-case names:"); + printNameSamples(new SimpleNameFactory(true), 80); + System.out.println("Some more lower-case names:"); + printNameSamples(new SimpleNameFactory(false), 80); + } + + + private static void printNameSamples(SimpleNameFactory factory, int count) + { + for (int counter = 0; counter < count; counter++) + { + System.out.println(" ["+factory.nextName()+"]"); + } + } +} diff --git a/src/proguard/obfuscate/SourceFileRenamer.java b/src/proguard/obfuscate/SourceFileRenamer.java new file mode 100644 index 0000000..cbf1b63 --- /dev/null +++ b/src/proguard/obfuscate/SourceFileRenamer.java @@ -0,0 +1,84 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.ConstantPoolEditor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor changes the name stored in the source file attributes + * and source dir attributes of the classes that it visits, if the + * attributes are present. + * + * @author Eric Lafortune + */ +public class SourceFileRenamer +extends SimplifiedVisitor +implements ClassVisitor, + AttributeVisitor +{ + private final String newSourceFileAttribute; + + + /** + * Creates a new SourceFileRenamer. + * @param newSourceFileAttribute the new string to be put in the source file + * attributes. + */ + public SourceFileRenamer(String newSourceFileAttribute) + { + this.newSourceFileAttribute = newSourceFileAttribute; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Only visit the class attributes. + programClass.attributesAccept(this); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + // Fix the source file attribute. + sourceFileAttribute.u2sourceFileIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newSourceFileAttribute); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + // Fix the source file attribute. + sourceDirAttribute.u2sourceDirIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newSourceFileAttribute); + } +} diff --git a/src/proguard/obfuscate/SpecialNameFactory.java b/src/proguard/obfuscate/SpecialNameFactory.java new file mode 100644 index 0000000..a5431ca --- /dev/null +++ b/src/proguard/obfuscate/SpecialNameFactory.java @@ -0,0 +1,83 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +/** + * This NameFactory generates names that are special, by appending + * a suffix. + * + * @author Eric Lafortune + */ +public class SpecialNameFactory implements NameFactory +{ + private static final char SPECIAL_SUFFIX = '_'; + + + private final NameFactory nameFactory; + + + /** + * Creates a new SpecialNameFactory. + * @param nameFactory the name factory from which original names will be + * retrieved. + */ + public SpecialNameFactory(NameFactory nameFactory) + { + this.nameFactory = nameFactory; + } + + + // Implementations for NameFactory. + + public void reset() + { + nameFactory.reset(); + } + + + public String nextName() + { + return nameFactory.nextName() + SPECIAL_SUFFIX; + } + + + // Small utility methods. + + /** + * Returns whether the given name is special. + */ + static boolean isSpecialName(String name) + { + return name != null && + name.charAt(name.length()-1) == SPECIAL_SUFFIX; + } + + + public static void main(String[] args) + { + SpecialNameFactory factory = new SpecialNameFactory(new SimpleNameFactory()); + + for (int counter = 0; counter < 50; counter++) + { + System.out.println("["+factory.nextName()+"]"); + } + } +} diff --git a/src/proguard/obfuscate/Utf8Shrinker.java b/src/proguard/obfuscate/Utf8Shrinker.java new file mode 100644 index 0000000..87ada80 --- /dev/null +++ b/src/proguard/obfuscate/Utf8Shrinker.java @@ -0,0 +1,110 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.constant.Constant; +import proguard.classfile.editor.ConstantPoolRemapper; +import proguard.classfile.visitor.ClassVisitor; + + +/** + * This ClassVisitor removes UTF-8 constant pool entries that are not marked + * as being used. + * + * @see Utf8UsageMarker + * + * @author Eric Lafortune + */ +public class Utf8Shrinker implements ClassVisitor +{ + private int[] constantIndexMap = new int[ClassConstants.TYPICAL_CONSTANT_POOL_SIZE]; + private final ConstantPoolRemapper constantPoolRemapper = new ConstantPoolRemapper(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Shift the used constant pool entries together, filling out the + // index map. + programClass.u2constantPoolCount = + shrinkConstantPool(programClass.constantPool, + programClass.u2constantPoolCount); + + // Remap all constant pool references. + constantPoolRemapper.setConstantIndexMap(constantIndexMap); + constantPoolRemapper.visitProgramClass(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + } + + + // Small utility methods. + + /** + * Removes all UTF-8 entries that are not marked as being used + * from the given constant pool. + * @return the new number of entries. + */ + private int shrinkConstantPool(Constant[] constantPool, int length) + { + // Create a new index map, if necessary. + if (constantIndexMap.length < length) + { + constantIndexMap = new int[length]; + } + + int counter = 1; + boolean isUsed = false; + + // Shift the used constant pool entries together. + for (int index = 1; index < length; index++) + { + constantIndexMap[index] = counter; + + Constant constant = constantPool[index]; + + // Don't update the flag if this is the second half of a long entry. + if (constant != null) + { + isUsed = constant.getTag() != ClassConstants.CONSTANT_Utf8 || + Utf8UsageMarker.isUsed(constant); + } + + if (isUsed) + { + constantPool[counter++] = constant; + } + } + + // Clear the remaining constant pool elements. + for (int index = counter; index < length; index++) + { + constantPool[index] = null; + } + + return counter; + } +} diff --git a/src/proguard/obfuscate/Utf8UsageMarker.java b/src/proguard/obfuscate/Utf8UsageMarker.java new file mode 100644 index 0000000..c59ebb8 --- /dev/null +++ b/src/proguard/obfuscate/Utf8UsageMarker.java @@ -0,0 +1,392 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.obfuscate; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor marks all UTF-8 constant pool entries that are + * being used in the program classes it visits. + * + * @see Utf8Shrinker + * + * @author Eric Lafortune + */ +public class Utf8UsageMarker +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + // A visitor info flag to indicate the UTF-8 constant pool entry is being used. + private static final Object USED = new Object(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Mark the UTF-8 entries referenced by the other constant pool entries. + programClass.constantPoolEntriesAccept(this); + + // Mark the UTF-8 entries referenced by the fields and methods. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + // Mark the UTF-8 entries referenced by the attributes. + programClass.attributesAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + // Mark the name and descriptor UTF-8 entries. + markCpUtf8Entry(programClass, programMember.u2nameIndex); + markCpUtf8Entry(programClass, programMember.u2descriptorIndex); + + // Mark the UTF-8 entries referenced by the attributes. + programMember.attributesAccept(programClass, this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + markCpUtf8Entry(clazz, stringConstant.u2stringIndex); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + markCpUtf8Entry(clazz, classConstant.u2nameIndex); + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + markCpUtf8Entry(clazz, nameAndTypeConstant.u2nameIndex); + markCpUtf8Entry(clazz, nameAndTypeConstant.u2descriptorIndex); + } + + + // Implementations for AttributeVisitor. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + // This is the best we can do for unknown attributes. + markCpUtf8Entry(clazz, unknownAttribute.u2attributeNameIndex); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + markCpUtf8Entry(clazz, sourceFileAttribute.u2attributeNameIndex); + + markCpUtf8Entry(clazz, sourceFileAttribute.u2sourceFileIndex); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + markCpUtf8Entry(clazz, sourceDirAttribute.u2attributeNameIndex); + + markCpUtf8Entry(clazz, sourceDirAttribute.u2sourceDirIndex); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + markCpUtf8Entry(clazz, innerClassesAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the inner classes. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + markCpUtf8Entry(clazz, enclosingMethodAttribute.u2attributeNameIndex); + + // These entries have already been marked in the constant pool. + //clazz.constantPoolEntryAccept(this, enclosingMethodAttribute.u2classIndex); + //clazz.constantPoolEntryAccept(this, enclosingMethodAttribute.u2nameAndTypeIndex); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + markCpUtf8Entry(clazz, deprecatedAttribute.u2attributeNameIndex); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + markCpUtf8Entry(clazz, syntheticAttribute.u2attributeNameIndex); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + markCpUtf8Entry(clazz, signatureAttribute.u2attributeNameIndex); + + markCpUtf8Entry(clazz, signatureAttribute.u2signatureIndex); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + markCpUtf8Entry(clazz, constantValueAttribute.u2attributeNameIndex); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + markCpUtf8Entry(clazz, exceptionsAttribute.u2attributeNameIndex); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + markCpUtf8Entry(clazz, codeAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + markCpUtf8Entry(clazz, stackMapAttribute.u2attributeNameIndex); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + markCpUtf8Entry(clazz, stackMapTableAttribute.u2attributeNameIndex); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + markCpUtf8Entry(clazz, lineNumberTableAttribute.u2attributeNameIndex); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + markCpUtf8Entry(clazz, localVariableTableAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + markCpUtf8Entry(clazz, localVariableTypeTableAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the local variable types. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + markCpUtf8Entry(clazz, annotationsAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + markCpUtf8Entry(clazz, parameterAnnotationsAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + markCpUtf8Entry(clazz, annotationDefaultAttribute.u2attributeNameIndex); + + // Mark the UTF-8 entries referenced by the element value. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + if (innerClassesInfo.u2innerNameIndex != 0) + { + markCpUtf8Entry(clazz, innerClassesInfo.u2innerNameIndex); + } + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + markCpUtf8Entry(clazz, localVariableInfo.u2nameIndex); + markCpUtf8Entry(clazz, localVariableInfo.u2descriptorIndex); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + markCpUtf8Entry(clazz, localVariableTypeInfo.u2nameIndex); + markCpUtf8Entry(clazz, localVariableTypeInfo.u2signatureIndex); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + markCpUtf8Entry(clazz, annotation.u2typeIndex); + + // Mark the UTF-8 entries referenced by the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + if (constantElementValue.u2elementNameIndex != 0) + { + markCpUtf8Entry(clazz, constantElementValue.u2elementNameIndex); + } + + // Only the string constant element value refers to a UTF-8 entry. + if (constantElementValue.u1tag == ClassConstants.ELEMENT_VALUE_STRING_CONSTANT) + { + markCpUtf8Entry(clazz, constantElementValue.u2constantValueIndex); + } + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + if (enumConstantElementValue.u2elementNameIndex != 0) + { + markCpUtf8Entry(clazz, enumConstantElementValue.u2elementNameIndex); + } + + markCpUtf8Entry(clazz, enumConstantElementValue.u2typeNameIndex); + markCpUtf8Entry(clazz, enumConstantElementValue.u2constantNameIndex); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + if (classElementValue.u2elementNameIndex != 0) + { + markCpUtf8Entry(clazz, classElementValue.u2elementNameIndex); + } + + markCpUtf8Entry(clazz, classElementValue.u2classInfoIndex); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + if (annotationElementValue.u2elementNameIndex != 0) + { + markCpUtf8Entry(clazz, annotationElementValue.u2elementNameIndex); + } + + // Mark the UTF-8 entries referenced by the annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + if (arrayElementValue.u2elementNameIndex != 0) + { + markCpUtf8Entry(clazz, arrayElementValue.u2elementNameIndex); + } + + // Mark the UTF-8 entries referenced by the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + // Small utility methods. + + /** + * Marks the given UTF-8 constant pool entry of the given class. + */ + private void markCpUtf8Entry(Clazz clazz, int index) + { + markAsUsed((Utf8Constant)((ProgramClass)clazz).getConstant(index)); + } + + + /** + * Marks the given VisitorAccepter as being used. + * In this context, the VisitorAccepter will be a Utf8Constant object. + */ + private static void markAsUsed(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(USED); + } + + + /** + * Returns whether the given VisitorAccepter has been marked as being used. + * In this context, the VisitorAccepter will be a Utf8Constant object. + */ + static boolean isUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() == USED; + } +} diff --git a/src/proguard/obfuscate/package.html b/src/proguard/obfuscate/package.html new file mode 100644 index 0000000..a82d266 --- /dev/null +++ b/src/proguard/obfuscate/package.html @@ -0,0 +1,3 @@ + +This package contains classes to perform obfuscation of class files. + diff --git a/src/proguard/optimize/ChangedCodePrinter.java b/src/proguard/optimize/ChangedCodePrinter.java new file mode 100644 index 0000000..67a79ab --- /dev/null +++ b/src/proguard/optimize/ChangedCodePrinter.java @@ -0,0 +1,291 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.ClassUtil; + +/** + * This AttributeVisitor delegates its call to another AttributeVisitor, and + * prints out the code if the other visitor has changed it. + * + * @author Eric Lafortune + */ +public class ChangedCodePrinter +implements AttributeVisitor +{ + private final AttributeVisitor attributeVisitor; + + + public ChangedCodePrinter(AttributeVisitor attributeVisitor) + { + this.attributeVisitor = attributeVisitor; + } + + + // Implementations for AttributeVisitor. + + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + attributeVisitor.visitUnknownAttribute(clazz, unknownAttribute); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + attributeVisitor.visitSourceFileAttribute(clazz, sourceFileAttribute); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + attributeVisitor.visitSourceDirAttribute(clazz, sourceDirAttribute); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + attributeVisitor.visitInnerClassesAttribute(clazz, innerClassesAttribute); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + attributeVisitor.visitEnclosingMethodAttribute(clazz, enclosingMethodAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + attributeVisitor.visitDeprecatedAttribute(clazz, deprecatedAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + attributeVisitor.visitSyntheticAttribute(clazz, syntheticAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute syntheticAttribute) + { + attributeVisitor.visitSignatureAttribute(clazz, syntheticAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, Field field, DeprecatedAttribute deprecatedAttribute) + { + attributeVisitor.visitDeprecatedAttribute(clazz, field, deprecatedAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, Field field, SyntheticAttribute syntheticAttribute) + { + attributeVisitor.visitSyntheticAttribute(clazz, field, syntheticAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, Field field, SignatureAttribute syntheticAttribute) + { + attributeVisitor.visitSignatureAttribute(clazz, field, syntheticAttribute); + } + + + public void visitDeprecatedAttribute(Clazz clazz, Method method, DeprecatedAttribute deprecatedAttribute) + { + attributeVisitor.visitDeprecatedAttribute(clazz, method, deprecatedAttribute); + } + + + public void visitSyntheticAttribute(Clazz clazz, Method method, SyntheticAttribute syntheticAttribute) + { + attributeVisitor.visitSyntheticAttribute(clazz, method, syntheticAttribute); + } + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute syntheticAttribute) + { + attributeVisitor.visitSignatureAttribute(clazz, method, syntheticAttribute); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + attributeVisitor.visitConstantValueAttribute(clazz, field, constantValueAttribute); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + attributeVisitor.visitExceptionsAttribute(clazz, method, exceptionsAttribute); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + attributeVisitor.visitStackMapAttribute(clazz, method, codeAttribute, stackMapAttribute); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + attributeVisitor.visitStackMapTableAttribute(clazz, method, codeAttribute, stackMapTableAttribute); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + attributeVisitor.visitLineNumberTableAttribute(clazz, method, codeAttribute, lineNumberTableAttribute); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + attributeVisitor.visitLocalVariableTableAttribute(clazz, method, codeAttribute, localVariableTableAttribute); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + attributeVisitor.visitLocalVariableTypeTableAttribute(clazz, method, codeAttribute, localVariableTypeTableAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + attributeVisitor.visitRuntimeVisibleAnnotationsAttribute(clazz, runtimeVisibleAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + attributeVisitor.visitRuntimeInvisibleAnnotationsAttribute(clazz, runtimeInvisibleAnnotationsAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + attributeVisitor.visitRuntimeVisibleAnnotationsAttribute(clazz, field, runtimeVisibleAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Field field, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + attributeVisitor.visitRuntimeInvisibleAnnotationsAttribute(clazz, field, runtimeInvisibleAnnotationsAttribute); + } + + + public void visitRuntimeVisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleAnnotationsAttribute runtimeVisibleAnnotationsAttribute) + { + attributeVisitor.visitRuntimeVisibleAnnotationsAttribute(clazz, method, runtimeVisibleAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleAnnotationsAttribute runtimeInvisibleAnnotationsAttribute) + { + attributeVisitor.visitRuntimeInvisibleAnnotationsAttribute(clazz, method, runtimeInvisibleAnnotationsAttribute); + } + + + public void visitRuntimeVisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeVisibleParameterAnnotationsAttribute runtimeVisibleParameterAnnotationsAttribute) + { + attributeVisitor.visitRuntimeVisibleParameterAnnotationsAttribute(clazz, method, runtimeVisibleParameterAnnotationsAttribute); + } + + + public void visitRuntimeInvisibleParameterAnnotationsAttribute(Clazz clazz, Method method, RuntimeInvisibleParameterAnnotationsAttribute runtimeInvisibleParameterAnnotationsAttribute) + { + attributeVisitor.visitRuntimeInvisibleParameterAnnotationsAttribute(clazz, method, runtimeInvisibleParameterAnnotationsAttribute); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + attributeVisitor.visitAnnotationDefaultAttribute(clazz, method, annotationDefaultAttribute); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + byte[] code = codeAttribute.code; + byte[] oldCode = new byte[code.length]; + + // Copy the current code. + System.arraycopy(code, 0, oldCode, 0, codeAttribute.u4codeLength); + + // Delegate to the real visitor. + attributeVisitor.visitCodeAttribute(clazz, method, codeAttribute); + + // Check if the code has changed. + if (codeHasChanged(codeAttribute, oldCode)) + { + printChangedCode(clazz, method, codeAttribute, oldCode); + } + } + + + // Small utility methods. + + private boolean codeHasChanged(CodeAttribute codeAttribute, byte[] oldCode) + { + if (oldCode.length != codeAttribute.u4codeLength) + { + return true; + } + + for (int index = 0; index < codeAttribute.u4codeLength; index++) + { + if (oldCode[index] != codeAttribute.code[index]) + { + return true; + } + } + + return false; + } + + + private void printChangedCode(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + byte[] oldCode) + { + System.out.println("Class "+ClassUtil.externalClassName(clazz.getName())); + System.out.println("Method "+ClassUtil.externalFullMethodDescription(clazz.getName(), + 0, + method.getName(clazz), + method.getDescriptor(clazz))); + + for (int index = 0; index < codeAttribute.u4codeLength; index++) + { + System.out.println( + (oldCode[index] == codeAttribute.code[index]? " -- ":" => ")+ + index+": "+ + Integer.toHexString(0x100|oldCode[index] &0xff).substring(1)+" "+ + Integer.toHexString(0x100|codeAttribute.code[index]&0xff).substring(1)); + } + } +} diff --git a/src/proguard/optimize/ConstantMemberFilter.java b/src/proguard/optimize/ConstantMemberFilter.java new file mode 100644 index 0000000..56437c3 --- /dev/null +++ b/src/proguard/optimize/ConstantMemberFilter.java @@ -0,0 +1,77 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; +import proguard.evaluation.value.Value; +import proguard.optimize.evaluation.StoringInvocationUnit; + +/** + * This MemberVisitor delegates its visits to program class members + * to another given MemberVisitor, but only when the visited + * class member has been marked as a constant. + * + * @see StoringInvocationUnit + * @author Eric Lafortune + */ +public class ConstantMemberFilter +extends SimplifiedVisitor +implements MemberVisitor +{ + private final MemberVisitor constantMemberVisitor; + + + /** + * Creates a new ConstantMemberFilter. + * @param constantMemberVisitor the MemberVisitor to which + * visits to constant members will be delegated. + */ + public ConstantMemberFilter(MemberVisitor constantMemberVisitor) + { + this.constantMemberVisitor = constantMemberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + Value value = StoringInvocationUnit.getFieldValue(programField); + if (value != null && + value.isParticular()) + { + constantMemberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + Value value = StoringInvocationUnit.getMethodReturnValue(programMethod); + if (value != null && + value.isParticular()) + { + constantMemberVisitor.visitProgramMethod(programClass, programMethod); + } + } +} diff --git a/src/proguard/optimize/ConstantParameterFilter.java b/src/proguard/optimize/ConstantParameterFilter.java new file mode 100644 index 0000000..24a7040 --- /dev/null +++ b/src/proguard/optimize/ConstantParameterFilter.java @@ -0,0 +1,79 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.evaluation.value.Value; +import proguard.optimize.evaluation.StoringInvocationUnit; +import proguard.optimize.info.ParameterUsageMarker; + +/** + * This MemberVisitor delegates its visits to program methods + * to another given MemberVisitor, for each method parameter + * that has been marked as constant. + * + * @see StoringInvocationUnit + * @author Eric Lafortune + */ +public class ConstantParameterFilter +extends SimplifiedVisitor +implements MemberVisitor +{ + private final MemberVisitor constantParameterVisitor; + + + /** + * Creates a new ConstantParameterFilter. + * @param constantParameterVisitor the MemberVisitor to which + * visits will be delegated. + */ + public ConstantParameterFilter(MemberVisitor constantParameterVisitor) + { + this.constantParameterVisitor = constantParameterVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // All parameters of non-static methods are shifted by one in the local + // variable frame. + int firstParameterIndex = + (programMethod.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0 ? + 0 : 1; + + int parameterCount = + ClassUtil.internalMethodParameterCount(programMethod.getDescriptor(programClass)); + + for (int index = firstParameterIndex; index < parameterCount; index++) + { + Value value = StoringInvocationUnit.getMethodParameterValue(programMethod, index); + if (value != null && + value.isParticular()) + { + constantParameterVisitor.visitProgramMethod(programClass, programMethod); + } + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/DuplicateInitializerFixer.java b/src/proguard/optimize/DuplicateInitializerFixer.java new file mode 100644 index 0000000..746d182 --- /dev/null +++ b/src/proguard/optimize/DuplicateInitializerFixer.java @@ -0,0 +1,207 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.editor.ConstantPoolEditor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This MemberVisitor adds an additional parameter to the duplicate + * initialization methods that it visits. + */ +public class DuplicateInitializerFixer +extends SimplifiedVisitor +implements MemberVisitor, + AttributeVisitor +{ + private static final boolean DEBUG = false; + + private static final char[] TYPES = new char[] + { + ClassConstants.INTERNAL_TYPE_BYTE, + ClassConstants.INTERNAL_TYPE_CHAR, + ClassConstants.INTERNAL_TYPE_SHORT, + ClassConstants.INTERNAL_TYPE_INT, + ClassConstants.INTERNAL_TYPE_BOOLEAN + }; + + + private final MemberVisitor extraFixedInitializerVisitor; + + + /** + * Creates a new DuplicateInitializerFixer. + */ + public DuplicateInitializerFixer() + { + this(null); + } + + + /** + * Creates a new DuplicateInitializerFixer with an extra visitor. + * @param extraFixedInitializerVisitor an optional extra visitor for all + * initializers that have been fixed. + */ + public DuplicateInitializerFixer(MemberVisitor extraFixedInitializerVisitor) + { + this.extraFixedInitializerVisitor = extraFixedInitializerVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Is it a class instance initializer? + String name = programMethod.getName(programClass); + if (name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + // Is there already another initializer with the same descriptor? + String descriptor = programMethod.getDescriptor(programClass); + Method similarMethod = programClass.findMethod(name, descriptor); + if (!programMethod.equals(similarMethod)) + { + // Should this initializer be preserved? + if (!KeepMarker.isKept(programMethod)) + { + // Fix the other initializer. + programMethod = (ProgramMethod)similarMethod; + } + + int index = descriptor.indexOf(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + + // Try to find a new, unique descriptor. + for (int typeIndex = 0; typeIndex < TYPES.length; typeIndex++) + { + String newDescriptor = + descriptor.substring(0, index) + + TYPES[typeIndex] + + descriptor.substring(index); + + // Is the new initializer descriptor unique? + if (programClass.findMethod(name, newDescriptor) == null) + { + if (DEBUG) + { + System.out.println("DuplicateInitializerFixer:"); + System.out.println(" ["+programClass.getName()+"]: "+name+descriptor+" -> "+newDescriptor); + } + + // Update the descriptor. + programMethod.u2descriptorIndex = + new ConstantPoolEditor(programClass).addUtf8Constant(newDescriptor); + + // Fix the local variable frame size, the method + // signature, and the parameter annotations, if + // necessary. + programMethod.attributesAccept(programClass, + this); + + // Visit the initializer, if required. + if (extraFixedInitializerVisitor != null) + { + extraFixedInitializerVisitor.visitProgramMethod(programClass, programMethod); + } + + // We're done with this constructor. + return; + } + } + + throw new IllegalStateException("Can't find unique constructor descriptor for ["+ + programClass.getName()+"."+ + programMethod.getName(programClass)+ + programMethod.getDescriptor(programClass)+"]"); + } + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // The minimum variable size is determined by the arguments. + int maxLocals = + ClassUtil.internalMethodParameterSize(method.getDescriptor(clazz), + method.getAccessFlags()); + + if (codeAttribute.u2maxLocals < maxLocals) + { + codeAttribute.u2maxLocals = maxLocals; + } + } + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute signatureAttribute) + { + String descriptor = method.getDescriptor(clazz); + int descriptorIndex = descriptor.indexOf(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + String signature = clazz.getString(signatureAttribute.u2signatureIndex); + int signatureIndex = signature.indexOf(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + + String newSignature = signature.substring(0, signatureIndex) + + descriptor.charAt(descriptorIndex - 1) + + signature.substring(signatureIndex); + + // Update the signature. + signatureAttribute.u2signatureIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newSignature); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Update the number of parameters. + int oldParametersCount = parameterAnnotationsAttribute.u2parametersCount++; + + if (parameterAnnotationsAttribute.u2parameterAnnotationsCount == null || + parameterAnnotationsAttribute.u2parameterAnnotationsCount.length < parameterAnnotationsAttribute.u2parametersCount) + { + int[] annotationsCounts = new int[parameterAnnotationsAttribute.u2parametersCount]; + Annotation[][] annotations = new Annotation[parameterAnnotationsAttribute.u2parametersCount][]; + + System.arraycopy(parameterAnnotationsAttribute.u2parameterAnnotationsCount, + 0, + annotationsCounts, + 0, + oldParametersCount); + + System.arraycopy(parameterAnnotationsAttribute.parameterAnnotations, + 0, + annotations, + 0, + oldParametersCount); + + parameterAnnotationsAttribute.u2parameterAnnotationsCount = annotationsCounts; + parameterAnnotationsAttribute.parameterAnnotations = annotations; + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/DuplicateInitializerInvocationFixer.java b/src/proguard/optimize/DuplicateInitializerInvocationFixer.java new file mode 100644 index 0000000..ca24481 --- /dev/null +++ b/src/proguard/optimize/DuplicateInitializerInvocationFixer.java @@ -0,0 +1,150 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This AttributeVisitor adds an additional integer parameter to the tweaked + * initialization method invocations that it visits. + */ +public class DuplicateInitializerInvocationFixer +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ConstantVisitor, + MemberVisitor +{ + private static final boolean DEBUG = false; + + private final InstructionVisitor extraAddedInstructionVisitor; + + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + private String descriptor; + private boolean hasBeenFixed; + + + /** + * Creates a new EvaluationSimplifier. + */ + public DuplicateInitializerInvocationFixer() + { + this(null); + } + + + /** + * Creates a new EvaluationSimplifier. + * @param extraAddedInstructionVisitor an optional extra visitor for all + * added instructions. + */ + public DuplicateInitializerInvocationFixer(InstructionVisitor extraAddedInstructionVisitor) + { + this.extraAddedInstructionVisitor = extraAddedInstructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + + // Reset the code changes. + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + // Fix any duplicate constructor invocations. + codeAttribute.instructionsAccept(clazz, + method, + this); + + // Apply all accumulated changes to the code. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + if (constantInstruction.opcode == InstructionConstants.OP_INVOKESPECIAL) + { + hasBeenFixed = false; + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + + if (hasBeenFixed) + { + Instruction extraInstruction = + new SimpleInstruction(InstructionConstants.OP_ICONST_0); + + codeAttributeEditor.insertBeforeInstruction(offset, + extraInstruction); + + if (DEBUG) + { + System.out.println("DuplicateInitializerInvocationFixer:"); + System.out.println(" Inserting "+extraInstruction.toString()+" before "+constantInstruction.toString(offset)); + } + + if (extraAddedInstructionVisitor != null) + { + extraInstruction.accept(null, null, null, offset, extraAddedInstructionVisitor); + } + } + } + } + + + // Implementations for ConstantVisitor. + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + // Check the referenced constructor descriptor. + descriptor = methodrefConstant.getType(clazz); + methodrefConstant.referencedMemberAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) {} + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + hasBeenFixed = !descriptor.equals(programMethod.getDescriptor(programClass)); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/KeepMarker.java b/src/proguard/optimize/KeepMarker.java new file mode 100644 index 0000000..4297996 --- /dev/null +++ b/src/proguard/optimize/KeepMarker.java @@ -0,0 +1,95 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.util.MethodLinker; +import proguard.classfile.visitor.*; + + +/** + * This ClassVisitor and MemberVisitor + * marks classes and class members it visits. The marked elements + * will remain unchanged as necessary in the optimization step. + * + * @author Eric Lafortune + */ +public class KeepMarker +implements ClassVisitor, + MemberVisitor +{ + // A visitor info flag to indicate the visitor accepter is being kept. + private static final Object KEPT = new Object(); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + markAsKept(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + markAsKept(libraryClass); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + markAsKept(programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + markAsKept(MethodLinker.lastMember(programMethod)); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + markAsKept(libraryField); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + markAsKept(MethodLinker.lastMember(libraryMethod)); + } + + + // Small utility methods. + + private static void markAsKept(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(KEPT); + } + + + public static boolean isKept(VisitorAccepter visitorAccepter) + { + return MethodLinker.lastVisitorAccepter(visitorAccepter).getVisitorInfo() == KEPT; + } +} diff --git a/src/proguard/optimize/MemberDescriptorSpecializer.java b/src/proguard/optimize/MemberDescriptorSpecializer.java new file mode 100644 index 0000000..0d0b841 --- /dev/null +++ b/src/proguard/optimize/MemberDescriptorSpecializer.java @@ -0,0 +1,138 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.editor.ClassReferenceFixer; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.evaluation.value.Value; +import proguard.optimize.evaluation.StoringInvocationUnit; + +/** + * This MemberVisitor specializes parameters in the descriptors of the + * methods that it visits. + * + * @see StoringInvocationUnit + * @see ClassReferenceFixer + * @author Eric Lafortune + */ +public class MemberDescriptorSpecializer +extends SimplifiedVisitor +implements MemberVisitor +{ + private static final boolean DEBUG = true; + + + private final MemberVisitor extraParameterMemberVisitor; + + + /** + * Creates a new MethodDescriptorShrinker. + */ + public MemberDescriptorSpecializer() + { + this(null); + } + + + /** + * Creates a new MethodDescriptorShrinker with an extra visitor. + * @param extraParameterMemberVisitor an optional extra visitor for all + * class members whose parameters have + * been specialized. + */ + public MemberDescriptorSpecializer(MemberVisitor extraParameterMemberVisitor) + { + this.extraParameterMemberVisitor = extraParameterMemberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + Value parameterValue = StoringInvocationUnit.getFieldValue(programField); + if (parameterValue.computationalType() == Value.TYPE_REFERENCE) + { + Clazz referencedClass = parameterValue.referenceValue().getReferencedClass(); + if (programField.referencedClass != referencedClass) + { + if (DEBUG) + { + System.out.println("MemberDescriptorSpecializer: "+programClass.getName()+"."+programField.getName(programClass)+" "+programField.getDescriptor(programClass)); + System.out.println(" "+programField.referencedClass.getName()+" -> "+referencedClass.getName()); + } + + programField.referencedClass = referencedClass; + + // Visit the field, if required. + if (extraParameterMemberVisitor != null) + { + extraParameterMemberVisitor.visitProgramField(programClass, programField); + } + } + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // All parameters of non-static methods are shifted by one in the local + // variable frame. + int firstParameterIndex = + (programMethod.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0 ? + 0 : 1; + + int parameterCount = + ClassUtil.internalMethodParameterCount(programMethod.getDescriptor(programClass)); + + int classIndex = 0; + + // Go over the parameters. + for (int parameterIndex = firstParameterIndex; parameterIndex < parameterCount; parameterIndex++) + { + Value parameterValue = StoringInvocationUnit.getMethodParameterValue(programMethod, parameterIndex); + if (parameterValue.computationalType() == Value.TYPE_REFERENCE) + { + Clazz referencedClass = parameterValue.referenceValue().getReferencedClass(); + if (programMethod.referencedClasses[classIndex] != referencedClass) + { + if (DEBUG) + { + System.out.println("MemberDescriptorSpecializer: "+programClass.getName()+"."+programMethod.getName(programClass)+programMethod.getDescriptor(programClass)); + System.out.println(" "+programMethod.referencedClasses[classIndex].getName()+" -> "+referencedClass.getName()); + } + + programMethod.referencedClasses[classIndex] = referencedClass; + + // Visit the method, if required. + if (extraParameterMemberVisitor != null) + { + extraParameterMemberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + classIndex++; + } + } + } +} diff --git a/src/proguard/optimize/MethodDescriptorShrinker.java b/src/proguard/optimize/MethodDescriptorShrinker.java new file mode 100644 index 0000000..48374e7 --- /dev/null +++ b/src/proguard/optimize/MethodDescriptorShrinker.java @@ -0,0 +1,319 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.ConstantPoolEditor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.*; +import proguard.optimize.peephole.VariableShrinker; + +/** + * This MemberVisitor removes unused parameters in the descriptors of the + * methods that it visits. + * + * @see ParameterUsageMarker + * @see VariableUsageMarker + * @see VariableShrinker + * @author Eric Lafortune + */ +public class MethodDescriptorShrinker +extends SimplifiedVisitor +implements MemberVisitor, + AttributeVisitor +{ + private static final boolean DEBUG = false; + + + private final MemberVisitor extraMemberVisitor; + + + /** + * Creates a new MethodDescriptorShrinker. + */ + public MethodDescriptorShrinker() + { + this(null); + } + + + /** + * Creates a new MethodDescriptorShrinker with an extra visitor. + * @param extraMemberVisitor an optional extra visitor for all methods whose + * parameters have been simplified. + */ + public MethodDescriptorShrinker(MemberVisitor extraMemberVisitor) + { + this.extraMemberVisitor = extraMemberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Update the descriptor if it has any unused parameters. + String descriptor = programMethod.getDescriptor(programClass); + String newDescriptor = shrinkDescriptor(programMethod, descriptor); + + if (!descriptor.equals(newDescriptor)) + { + // Shrink the signature and parameter annotations. + programMethod.attributesAccept(programClass, this); + + String name = programMethod.getName(programClass); + String newName = name; + + // Append a code, if the method isn't a class instance initializer. + if (!name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + newName += ClassConstants.SPECIAL_MEMBER_SEPARATOR + Long.toHexString(Math.abs((descriptor).hashCode())); + } + + if (DEBUG) + { + System.out.println("MethodDescriptorShrinker:"); + System.out.println(" Class file = "+programClass.getName()); + System.out.println(" Method name = "+name); + System.out.println(" -> "+newName); + System.out.println(" Method descriptor = "+descriptor); + System.out.println(" -> "+newDescriptor); + } + + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor(programClass); + + // Update the name, if necessary. + if (!newName.equals(name)) + { + programMethod.u2nameIndex = + constantPoolEditor.addUtf8Constant(newName); + } + + // Update the referenced classes. + programMethod.referencedClasses = + shrinkReferencedClasses(programMethod, + descriptor, + programMethod.referencedClasses); + + // Finally, update the descriptor itself. + programMethod.u2descriptorIndex = + constantPoolEditor.addUtf8Constant(newDescriptor); + + // Visit the method, if required. + if (extraMemberVisitor != null) + { + extraMemberVisitor.visitProgramMethod(programClass, programMethod); + } + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitSignatureAttribute(Clazz clazz, Method method, SignatureAttribute signatureAttribute) + { + // Compute the new signature. + String signature = clazz.getString(signatureAttribute.u2signatureIndex); + String newSignature = shrinkDescriptor(method, signature); + + // Update the signature. + signatureAttribute.u2signatureIndex = + new ConstantPoolEditor((ProgramClass)clazz).addUtf8Constant(newSignature); + + // Update the referenced classes. + signatureAttribute.referencedClasses = + shrinkReferencedClasses(method, + signature, + signatureAttribute.referencedClasses); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + int[] annotationsCounts = parameterAnnotationsAttribute.u2parameterAnnotationsCount; + Annotation[][] annotations = parameterAnnotationsAttribute.parameterAnnotations; + + // All parameters of non-static methods are shifted by one in the local + // variable frame. + int parameterIndex = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0 ? + 0 : 1; + + int annotationIndex = 0; + int newAnnotationIndex = 0; + + // Go over the parameters. + String descriptor = method.getDescriptor(clazz); + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + while (internalTypeEnumeration.hasMoreTypes()) + { + String type = internalTypeEnumeration.nextType(); + if (ParameterUsageMarker.isParameterUsed(method, parameterIndex)) + { + annotationsCounts[newAnnotationIndex] = annotationsCounts[annotationIndex]; + annotations[newAnnotationIndex++] = annotations[annotationIndex]; + } + + annotationIndex++; + + parameterIndex += ClassUtil.isInternalCategory2Type(type) ? 2 : 1; + } + + // Update the number of parameters. + parameterAnnotationsAttribute.u2parametersCount = newAnnotationIndex; + + // Clear the unused entries. + while (newAnnotationIndex < annotationIndex) + { + annotationsCounts[newAnnotationIndex] = 0; + annotations[newAnnotationIndex++] = null; + } + } + + + // Small utility methods. + + /** + * Returns a shrunk descriptor or signature of the given method. + */ + private String shrinkDescriptor(Method method, String descriptor) + { + // All parameters of non-static methods are shifted by one in the local + // variable frame. + int parameterIndex = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0 ? + 0 : 1; + + // Go over the parameters. + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + StringBuffer newDescriptorBuffer = new StringBuffer(); + + newDescriptorBuffer.append(internalTypeEnumeration.formalTypeParameters()); + newDescriptorBuffer.append(ClassConstants.INTERNAL_METHOD_ARGUMENTS_OPEN); + + while (internalTypeEnumeration.hasMoreTypes()) + { + String type = internalTypeEnumeration.nextType(); + if (ParameterUsageMarker.isParameterUsed(method, parameterIndex)) + { + newDescriptorBuffer.append(type); + } + else if (DEBUG) + { + System.out.println(" Deleting parameter #"+parameterIndex+" ["+type+"]"); + } + + parameterIndex += ClassUtil.isInternalCategory2Type(type) ? 2 : 1; + } + + newDescriptorBuffer.append(ClassConstants.INTERNAL_METHOD_ARGUMENTS_CLOSE); + newDescriptorBuffer.append(internalTypeEnumeration.returnType()); + + return newDescriptorBuffer.toString(); + } + + + /** + * Shrinks the array of referenced classes of the given method. + */ + private Clazz[] shrinkReferencedClasses(Method method, + String descriptor, + Clazz[] referencedClasses) + { + if (referencedClasses != null) + { + // All parameters of non-static methods are shifted by one in the local + // variable frame. + int parameterIndex = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0 ? + 0 : 1; + + int referencedClassIndex = 0; + int newReferencedClassIndex = 0; + + // Go over the parameters. + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + // Also look at the formal type parameters. + String type = internalTypeEnumeration.formalTypeParameters(); + int count = new DescriptorClassEnumeration(type).classCount(); + for (int counter = 0; counter < count; counter++) + { + referencedClasses[newReferencedClassIndex++] = + referencedClasses[referencedClassIndex++]; + } + + while (internalTypeEnumeration.hasMoreTypes()) + { + // Consider the classes referenced by this parameter type. + type = internalTypeEnumeration.nextType(); + count = new DescriptorClassEnumeration(type).classCount(); + + if (ParameterUsageMarker.isParameterUsed(method, parameterIndex)) + { + // Copy the referenced classes. + for (int counter = 0; counter < count; counter++) + { + referencedClasses[newReferencedClassIndex++] = + referencedClasses[referencedClassIndex++]; + } + } + else + { + // Skip the referenced classes. + referencedClassIndex += count; + } + + parameterIndex += ClassUtil.isInternalCategory2Type(type) ? 2 : 1; + } + + // Also look at the return value. + type = internalTypeEnumeration.returnType(); + count = new DescriptorClassEnumeration(type).classCount(); + for (int counter = 0; counter < count; counter++) + { + referencedClasses[newReferencedClassIndex++] = + referencedClasses[referencedClassIndex++]; + } + + // Clear the unused entries. + while (newReferencedClassIndex < referencedClassIndex) + { + referencedClasses[newReferencedClassIndex++] = null; + } + } + + return referencedClasses; + } +} diff --git a/src/proguard/optimize/MethodStaticizer.java b/src/proguard/optimize/MethodStaticizer.java new file mode 100644 index 0000000..8dd11e1 --- /dev/null +++ b/src/proguard/optimize/MethodStaticizer.java @@ -0,0 +1,87 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.MethodInvocationFixer; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.ParameterUsageMarker; +import proguard.optimize.peephole.VariableShrinker; + +/** + * This MemberVisitor makes all methods that it visits static, if their 'this' + * parameters are unused. + * + * @see ParameterUsageMarker + * @see MethodInvocationFixer + * @see VariableShrinker + * @author Eric Lafortune + */ +public class MethodStaticizer +extends SimplifiedVisitor +implements MemberVisitor, + AttributeVisitor +{ + private final MemberVisitor extraStaticMemberVisitor; + + + /** + * Creates a new MethodStaticizer. + */ + public MethodStaticizer() + { + this(null); + } + + + /** + * Creates a new MethodStaticizer with an extra visitor. + * @param extraStaticMemberVisitor an optional extra visitor for all + * methods that have been made static. + */ + public MethodStaticizer(MemberVisitor extraStaticMemberVisitor) + { + this.extraStaticMemberVisitor = extraStaticMemberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Is the 'this' parameter being used? + if (!ParameterUsageMarker.isParameterUsed(programMethod, 0)) + { + // Make the method static. + programMethod.u2accessFlags = + (programMethod.getAccessFlags() & ~ClassConstants.INTERNAL_ACC_FINAL) | + ClassConstants.INTERNAL_ACC_STATIC; + + // Visit the method, if required. + if (extraStaticMemberVisitor != null) + { + extraStaticMemberVisitor.visitProgramMethod(programClass, programMethod); + } + } + } +} diff --git a/src/proguard/optimize/OptimizationInfoMemberFilter.java b/src/proguard/optimize/OptimizationInfoMemberFilter.java new file mode 100644 index 0000000..8760aee --- /dev/null +++ b/src/proguard/optimize/OptimizationInfoMemberFilter.java @@ -0,0 +1,94 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.*; + +/** + * This MemberVisitor delegates its visits to another given + * MemberVisitor, but only when the visited member has optimization + * info. + * + * @see FieldOptimizationInfo + * @see MethodOptimizationInfo + * @author Eric Lafortune + */ +public class OptimizationInfoMemberFilter +implements MemberVisitor +{ + private final MemberVisitor memberVisitor; + + + /** + * Creates a new OptimizationInfoMemberFilter. + * @param memberVisitor the MemberVisitor to which visits will + * be delegated. + */ + public OptimizationInfoMemberFilter(MemberVisitor memberVisitor) + { + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Does the field have optimization info? + if (FieldOptimizationInfo.getFieldOptimizationInfo(programField) != null) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + // Does the field have optimization info? + if (FieldOptimizationInfo.getFieldOptimizationInfo(libraryField) != null) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Does the method have optimization info? + if (MethodOptimizationInfo.getMethodOptimizationInfo(programMethod) != null) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Does the method have optimization info? + if (MethodOptimizationInfo.getMethodOptimizationInfo(libraryMethod) != null) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } +} diff --git a/src/proguard/optimize/Optimizer.java b/src/proguard/optimize/Optimizer.java new file mode 100644 index 0000000..a3e8a6e --- /dev/null +++ b/src/proguard/optimize/Optimizer.java @@ -0,0 +1,876 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.*; +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.visitor.AllConstantVisitor; +import proguard.classfile.editor.*; +import proguard.classfile.instruction.visitor.*; +import proguard.classfile.util.MethodLinker; +import proguard.classfile.visitor.*; +import proguard.evaluation.*; +import proguard.evaluation.value.*; +import proguard.optimize.evaluation.*; +import proguard.optimize.info.*; +import proguard.optimize.peephole.*; +import proguard.util.*; + +import java.io.IOException; +import java.util.*; + +/** + * This class optimizes class pools according to a given configuration. + * + * @author Eric Lafortune + */ +public class Optimizer +{ + private static final String CLASS_MARKING_FINAL = "class/marking/final"; + private static final String CLASS_MERGING_VERTICAL = "class/merging/vertical"; + private static final String CLASS_MERGING_HORIZONTAL = "class/merging/horizontal"; + private static final String FIELD_REMOVAL_WRITEONLY = "field/removal/writeonly"; + private static final String FIELD_MARKING_PRIVATE = "field/marking/private"; + private static final String FIELD_PROPAGATION_VALUE = "field/propagation/value"; + private static final String METHOD_MARKING_PRIVATE = "method/marking/private"; + private static final String METHOD_MARKING_STATIC = "method/marking/static"; + private static final String METHOD_MARKING_FINAL = "method/marking/final"; + private static final String METHOD_REMOVAL_PARAMETER = "method/removal/parameter"; + private static final String METHOD_PROPAGATION_PARAMETER = "method/propagation/parameter"; + private static final String METHOD_PROPAGATION_RETURNVALUE = "method/propagation/returnvalue"; + private static final String METHOD_INLINING_SHORT = "method/inlining/short"; + private static final String METHOD_INLINING_UNIQUE = "method/inlining/unique"; + private static final String METHOD_INLINING_TAILRECURSION = "method/inlining/tailrecursion"; + private static final String CODE_MERGING = "code/merging"; + private static final String CODE_SIMPLIFICATION_VARIABLE = "code/simplification/variable"; + private static final String CODE_SIMPLIFICATION_ARITHMETIC = "code/simplification/arithmetic"; + private static final String CODE_SIMPLIFICATION_CAST = "code/simplification/cast"; + private static final String CODE_SIMPLIFICATION_FIELD = "code/simplification/field"; + private static final String CODE_SIMPLIFICATION_BRANCH = "code/simplification/branch"; + private static final String CODE_SIMPLIFICATION_ADVANCED = "code/simplification/advanced"; + private static final String CODE_REMOVAL_ADVANCED = "code/removal/advanced"; + private static final String CODE_REMOVAL_SIMPLE = "code/removal/simple"; + private static final String CODE_REMOVAL_VARIABLE = "code/removal/variable"; + private static final String CODE_REMOVAL_EXCEPTION = "code/removal/exception"; + private static final String CODE_ALLOCATION_VARIABLE = "code/allocation/variable"; + + + public static final String[] OPTIMIZATION_NAMES = new String[] + { + CLASS_MARKING_FINAL, + CLASS_MERGING_VERTICAL, + CLASS_MERGING_HORIZONTAL, + FIELD_REMOVAL_WRITEONLY, + FIELD_PROPAGATION_VALUE, + METHOD_MARKING_PRIVATE, + METHOD_MARKING_STATIC, + METHOD_MARKING_FINAL, + METHOD_REMOVAL_PARAMETER, + METHOD_PROPAGATION_PARAMETER, + METHOD_PROPAGATION_RETURNVALUE, + METHOD_INLINING_SHORT, + METHOD_INLINING_UNIQUE, + METHOD_INLINING_TAILRECURSION, + CODE_MERGING, + CODE_SIMPLIFICATION_VARIABLE, + CODE_SIMPLIFICATION_ARITHMETIC, + CODE_SIMPLIFICATION_CAST, + CODE_SIMPLIFICATION_FIELD, + CODE_SIMPLIFICATION_BRANCH, + CODE_SIMPLIFICATION_ADVANCED, + CODE_REMOVAL_ADVANCED, + CODE_REMOVAL_SIMPLE, + CODE_REMOVAL_VARIABLE, + CODE_REMOVAL_EXCEPTION, + CODE_ALLOCATION_VARIABLE, + }; + + + private final Configuration configuration; + + + /** + * Creates a new Optimizer. + */ + public Optimizer(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Performs optimization of the given program class pool. + */ + public boolean execute(ClassPool programClassPool, + ClassPool libraryClassPool) throws IOException + { + // Check if we have at least some keep commands. + if (configuration.keep == null && + configuration.applyMapping == null && + configuration.printMapping == null) + { + throw new IOException("You have to specify '-keep' options for the optimization step."); + } + + // Create a matcher for filtering optimizations. + StringMatcher filter = configuration.optimizations != null ? + new ListParser(new NameParser()).parse(configuration.optimizations) : + new ConstantMatcher(true); + + boolean classMarkingFinal = filter.matches(CLASS_MARKING_FINAL); + boolean classMergingVertical = filter.matches(CLASS_MERGING_VERTICAL); + boolean classMergingHorizontal = filter.matches(CLASS_MERGING_HORIZONTAL); + boolean fieldRemovalWriteonly = filter.matches(FIELD_REMOVAL_WRITEONLY); + boolean fieldMarkingPrivate = filter.matches(FIELD_MARKING_PRIVATE); + boolean fieldPropagationValue = filter.matches(FIELD_PROPAGATION_VALUE); + boolean methodMarkingPrivate = filter.matches(METHOD_MARKING_PRIVATE); + boolean methodMarkingStatic = filter.matches(METHOD_MARKING_STATIC); + boolean methodMarkingFinal = filter.matches(METHOD_MARKING_FINAL); + boolean methodRemovalParameter = filter.matches(METHOD_REMOVAL_PARAMETER); + boolean methodPropagationParameter = filter.matches(METHOD_PROPAGATION_PARAMETER); + boolean methodPropagationReturnvalue = filter.matches(METHOD_PROPAGATION_RETURNVALUE); + boolean methodInliningShort = filter.matches(METHOD_INLINING_SHORT); + boolean methodInliningUnique = filter.matches(METHOD_INLINING_UNIQUE); + boolean methodInliningTailrecursion = filter.matches(METHOD_INLINING_TAILRECURSION); + boolean codeMerging = filter.matches(CODE_MERGING); + boolean codeSimplificationVariable = filter.matches(CODE_SIMPLIFICATION_VARIABLE); + boolean codeSimplificationArithmetic = filter.matches(CODE_SIMPLIFICATION_ARITHMETIC); + boolean codeSimplificationCast = filter.matches(CODE_SIMPLIFICATION_CAST); + boolean codeSimplificationField = filter.matches(CODE_SIMPLIFICATION_FIELD); + boolean codeSimplificationBranch = filter.matches(CODE_SIMPLIFICATION_BRANCH); + boolean codeSimplificationAdvanced = filter.matches(CODE_SIMPLIFICATION_ADVANCED); + boolean codeRemovalAdvanced = filter.matches(CODE_REMOVAL_ADVANCED); + boolean codeRemovalSimple = filter.matches(CODE_REMOVAL_SIMPLE); + boolean codeRemovalVariable = filter.matches(CODE_REMOVAL_VARIABLE); + boolean codeRemovalException = filter.matches(CODE_REMOVAL_EXCEPTION); + boolean codeAllocationVariable = filter.matches(CODE_ALLOCATION_VARIABLE); + + // Create counters to count the numbers of optimizations. + ClassCounter classMarkingFinalCounter = new ClassCounter(); + ClassCounter classMergingVerticalCounter = new ClassCounter(); + ClassCounter classMergingHorizontalCounter = new ClassCounter(); + MemberCounter fieldRemovalWriteonlyCounter = new MemberCounter(); + MemberCounter fieldMarkingPrivateCounter = new MemberCounter(); + MemberCounter fieldPropagationValueCounter = new MemberCounter(); + MemberCounter methodMarkingPrivateCounter = new MemberCounter(); + MemberCounter methodMarkingStaticCounter = new MemberCounter(); + MemberCounter methodMarkingFinalCounter = new MemberCounter(); + MemberCounter methodRemovalParameterCounter = new MemberCounter(); + MemberCounter methodPropagationParameterCounter = new MemberCounter(); + MemberCounter methodPropagationReturnvalueCounter = new MemberCounter(); + InstructionCounter methodInliningShortCounter = new InstructionCounter(); + InstructionCounter methodInliningUniqueCounter = new InstructionCounter(); + InstructionCounter methodInliningTailrecursionCounter = new InstructionCounter(); + InstructionCounter codeMergingCounter = new InstructionCounter(); + InstructionCounter codeSimplificationVariableCounter = new InstructionCounter(); + InstructionCounter codeSimplificationArithmeticCounter = new InstructionCounter(); + InstructionCounter codeSimplificationCastCounter = new InstructionCounter(); + InstructionCounter codeSimplificationFieldCounter = new InstructionCounter(); + InstructionCounter codeSimplificationBranchCounter = new InstructionCounter(); + InstructionCounter codeSimplificationAdvancedCounter = new InstructionCounter(); + InstructionCounter deletedCounter = new InstructionCounter(); + InstructionCounter addedCounter = new InstructionCounter(); + MemberCounter codeRemovalVariableCounter = new MemberCounter(); + ExceptionCounter codeRemovalExceptionCounter = new ExceptionCounter(); + MemberCounter codeAllocationVariableCounter = new MemberCounter(); + MemberCounter initializerFixCounter = new MemberCounter(); + + // Some optimizations are required by other optimizations. + codeSimplificationAdvanced = + codeSimplificationAdvanced || + fieldPropagationValue || + methodPropagationParameter || + methodPropagationReturnvalue; + + codeRemovalAdvanced = + codeRemovalAdvanced || + fieldRemovalWriteonly || + methodMarkingStatic || + methodRemovalParameter; + + codeRemovalSimple = + codeRemovalSimple || + codeSimplificationBranch; + + codeRemovalException = + codeRemovalException || + codeRemovalAdvanced || + codeRemovalSimple; + + // Clean up any old visitor info. + programClassPool.classesAccept(new ClassCleaner()); + libraryClassPool.classesAccept(new ClassCleaner()); + + // Link all methods that should get the same optimization info. + programClassPool.classesAccept(new BottomClassFilter( + new MethodLinker())); + libraryClassPool.classesAccept(new BottomClassFilter( + new MethodLinker())); + + // Create a visitor for marking the seeds. + KeepMarker keepMarker = new KeepMarker(); + ClassPoolVisitor classPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(configuration.keep, + keepMarker, + keepMarker, + false, + true, + false); + // Mark the seeds. + programClassPool.accept(classPoolvisitor); + libraryClassPool.accept(classPoolvisitor); + + // All library classes and library class members remain unchanged. + libraryClassPool.classesAccept(keepMarker); + libraryClassPool.classesAccept(new AllMemberVisitor(keepMarker)); + + // We also keep all classes that are involved in .class constructs. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new AllInstructionVisitor( + new DotClassClassVisitor(keepMarker))))); + + // We also keep all classes that are involved in Class.forName constructs. + programClassPool.classesAccept( + new AllConstantVisitor( + new ClassForNameClassVisitor(keepMarker))); + + // Attach some optimization info to all classes and class members, so + // it can be filled out later. + programClassPool.classesAccept(new ClassOptimizationInfoSetter()); + + programClassPool.classesAccept(new AllMemberVisitor( + new MemberOptimizationInfoSetter())); + + if (configuration.assumeNoSideEffects != null) + { + // Create a visitor for marking methods that don't have any side effects. + NoSideEffectMethodMarker noSideEffectMethodMarker = new NoSideEffectMethodMarker(); + ClassPoolVisitor noClassPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(configuration.assumeNoSideEffects, + null, + noSideEffectMethodMarker); + + // Mark the seeds. + programClassPool.accept(noClassPoolvisitor); + libraryClassPool.accept(noClassPoolvisitor); + } + + if (classMarkingFinal) + { + // Make classes final, whereever possible. + programClassPool.classesAccept( + new ClassFinalizer(classMarkingFinalCounter)); + } + + if (methodMarkingFinal) + { + // Make methods final, whereever possible. + programClassPool.classesAccept( + new AllMethodVisitor( + new MethodFinalizer(methodMarkingFinalCounter))); + } + + if (fieldRemovalWriteonly) + { + // Mark all fields that are write-only. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new AllInstructionVisitor( + new ReadWriteFieldMarker())))); + + // Count the write-only fields. + programClassPool.classesAccept( + new AllFieldVisitor( + new WriteOnlyFieldFilter(fieldRemovalWriteonlyCounter))); + } + else + { + // Mark all fields as read/write. + programClassPool.classesAccept( + new AllFieldVisitor( + new ReadWriteFieldMarker())); + } + + // Mark all used parameters, including the 'this' parameters. + programClassPool.classesAccept( + new AllMethodVisitor( + new OptimizationInfoMemberFilter( + new ParameterUsageMarker(!methodMarkingStatic, + !methodRemovalParameter)))); + + // Mark all methods that have side effects. + programClassPool.accept(new SideEffectMethodMarker()); + +// System.out.println("Optimizer.execute: before evaluation simplification"); +// programClassPool.classAccept("abc/Def", new NamedMethodVisitor("abc", null, new ClassPrinter())); + + // Perform partial evaluation for filling out fields, method parameters, + // and method return values. + ValueFactory valueFactory = new IdentifiedValueFactory(); + + if (fieldPropagationValue || + methodPropagationParameter || + methodPropagationReturnvalue) + { + // Fill out fields, method parameters, and return values, so they + // can be propagated. + InvocationUnit storingInvocationUnit = + new StoringInvocationUnit(valueFactory, + fieldPropagationValue, + methodPropagationParameter, + methodPropagationReturnvalue); + + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new PartialEvaluator(valueFactory, storingInvocationUnit, false)))); + + // Count the constant fields and methods. + programClassPool.classesAccept( + new MultiClassVisitor( + new ClassVisitor[] + { + new AllFieldVisitor( + new ConstantMemberFilter(fieldPropagationValueCounter)), + new AllMethodVisitor( + new ConstantParameterFilter(methodPropagationParameterCounter)), + new AllMethodVisitor( + new ConstantMemberFilter(methodPropagationReturnvalueCounter)), + })); + } + + InvocationUnit loadingInvocationUnit = + new LoadingInvocationUnit(valueFactory, + fieldPropagationValue, + methodPropagationParameter, + methodPropagationReturnvalue); + + if (codeSimplificationAdvanced) + { + // Simplify based on partial evaluation, propagating constant + // field values, method parameter values, and return values. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new EvaluationSimplifier( + new PartialEvaluator(valueFactory, loadingInvocationUnit, false), + codeSimplificationAdvancedCounter)))); + } + + if (codeRemovalAdvanced) + { + // Remove code based on partial evaluation, also removing unused + // parameters from method invocations, and making methods static + // if possible. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new EvaluationShrinker( + new PartialEvaluator(valueFactory, loadingInvocationUnit, !codeSimplificationAdvanced), + deletedCounter, addedCounter)))); + } + + if (methodRemovalParameter) + { + // Shrink the parameters in the method descriptors. + programClassPool.classesAccept( + new AllMethodVisitor( + new OptimizationInfoMemberFilter( + new MethodDescriptorShrinker()))); + } + + if (methodMarkingStatic) + { + // Make all non-static methods that don't require the 'this' + // parameter static. + programClassPool.classesAccept( + new AllMethodVisitor( + new OptimizationInfoMemberFilter( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_STATIC, + new MethodStaticizer(methodMarkingStaticCounter))))); + } + + if (methodRemovalParameter) + { + // Fix all references to class members. + // This operation also updates the stack sizes. + programClassPool.classesAccept( + new MemberReferenceFixer()); + } + + if (methodRemovalParameter || + methodMarkingPrivate || + methodMarkingStatic) + { + // Remove all unused parameters from the byte code, shifting all + // remaining variables. + // This operation also updates the local variable frame sizes. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new ParameterShrinker(methodRemovalParameterCounter)))); + } + else if (codeRemovalAdvanced) + { + // Just update the local variable frame sizes. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new StackSizeUpdater()))); + } + +// // Specializing the class member descriptors seems to increase the +// // class file size, on average. +// // Specialize all class member descriptors. +// programClassPool.classesAccept(new AllMemberVisitor( +// new OptimizationInfoMemberFilter( +// new MemberDescriptorSpecializer()))); +// +// // Fix all references to classes, for MemberDescriptorSpecializer. +// programClassPool.classesAccept(new AllMemberVisitor( +// new OptimizationInfoMemberFilter( +// new ClassReferenceFixer(true)))); + + // Mark all classes with package visible members. + // Mark all exception catches of methods. + // Count all method invocations. + // Mark super invocations and other access of methods. + programClassPool.classesAccept( + new MultiClassVisitor( + new ClassVisitor[] + { + new AllConstantVisitor( + new PackageVisibleMemberInvokingClassMarker()), + new AllMethodVisitor( + new MultiMemberVisitor( + new MemberVisitor[] + { + new PackageVisibleMemberContainingClassMarker(), + new AllAttributeVisitor( + new MultiAttributeVisitor( + new AttributeVisitor[] + { + new CatchExceptionMarker(), + new AllInstructionVisitor( + new MultiInstructionVisitor( + new InstructionVisitor[] + { + new InstantiationClassMarker(), + new InstanceofClassMarker(), + new DotClassMarker(), + new MethodInvocationMarker(), + new SuperInvocationMarker(), + new BackwardBranchMarker(), + new AccessMethodMarker(), + })), + new AllExceptionInfoVisitor( + new ExceptionHandlerConstantVisitor( + new ReferencedClassVisitor( + new CaughtClassMarker()))), + })), + })), + })); + + if (classMergingVertical) + { + // Merge classes into their superclasses or interfaces. + programClassPool.classesAccept( + new VerticalClassMerger(configuration.allowAccessModification, + configuration.mergeInterfacesAggressively, + classMergingVerticalCounter)); + } + + if (classMergingHorizontal) + { + // Merge classes into their sibling classes. + programClassPool.classesAccept( + new HorizontalClassMerger(configuration.allowAccessModification, + configuration.mergeInterfacesAggressively, + classMergingHorizontalCounter)); + } + + if (classMergingVertical || + classMergingHorizontal) + { + // Clean up inner class attributes to avoid loops. + programClassPool.classesAccept(new RetargetedInnerClassAttributeRemover()); + + // Update references to merged classes. + programClassPool.classesAccept(new TargetClassChanger()); + programClassPool.classesAccept(new ClassReferenceFixer(true)); + programClassPool.classesAccept(new MemberReferenceFixer()); + + if (configuration.allowAccessModification) + { + // Fix the access flags of referenced merged classes and their + // class members. + programClassPool.classesAccept( + new AllConstantVisitor( + new AccessFixer())); + } + } + + if (methodRemovalParameter || + classMergingVertical || + classMergingHorizontal) + { + // Tweak the descriptors of duplicate initializers. + programClassPool.classesAccept( + new AllMethodVisitor( + new DuplicateInitializerFixer(initializerFixCounter))); + + if (initializerFixCounter.getCount() > 0) + { + // Fix all invocations of tweaked initializers. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new DuplicateInitializerInvocationFixer(addedCounter)))); + + // Fix all references to tweaked initializers. + programClassPool.classesAccept(new MemberReferenceFixer()); + } + } + + if (methodInliningUnique) + { + // Inline methods that are only invoked once. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new MethodInliner(configuration.microEdition, + configuration.allowAccessModification, + true, + methodInliningUniqueCounter)))); + } + + if (methodInliningShort) + { + // Inline short methods. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new MethodInliner(configuration.microEdition, + configuration.allowAccessModification, + false, + methodInliningShortCounter)))); + } + + if (methodInliningTailrecursion) + { + // Simplify tail recursion calls. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new TailRecursionSimplifier(methodInliningTailrecursionCounter)))); + } + + if (fieldMarkingPrivate || + methodMarkingPrivate) + { + // Mark all class members that can not be made private. + programClassPool.classesAccept( + new NonPrivateMemberMarker()); + } + + if (fieldMarkingPrivate || + methodMarkingPrivate) + { + // Make all non-private fields private, whereever possible. + programClassPool.classesAccept( + new AllFieldVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberPrivatizer(fieldMarkingPrivateCounter)))); + } + + if (methodMarkingPrivate) + { + // Make all non-private methods private, whereever possible. + programClassPool.classesAccept( + new ClassAccessFilter(0, ClassConstants.INTERNAL_ACC_INTERFACE, + new AllMethodVisitor( + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + new MemberPrivatizer(methodMarkingPrivateCounter))))); + } + + if ((methodInliningUnique || + methodInliningShort || + methodInliningTailrecursion) && + configuration.allowAccessModification) + { + // Fix the access flags of referenced classes and class members, + // for MethodInliner. + programClassPool.classesAccept( + new AllConstantVisitor( + new AccessFixer())); + } + + if (methodRemovalParameter || + classMergingVertical || + classMergingHorizontal || + methodMarkingPrivate) + { + // Fix invocations of interface methods, of methods that have become + // non-abstract or private, and of methods that have moved to a + // different package. + programClassPool.classesAccept( + new AllMemberVisitor( + new AllAttributeVisitor( + new MethodInvocationFixer()))); + } + + if (codeMerging) + { + // Share common blocks of code at branches. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new GotoCommonCodeReplacer(codeMergingCounter)))); + } + + // Create a branch target marker and a code attribute editor that can + // be reused for all code attributes. + BranchTargetFinder branchTargetFinder = new BranchTargetFinder(); + CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + List peepholeOptimizations = new ArrayList(); + if (codeSimplificationVariable) + { + // Peephole optimizations involving local variables. + peepholeOptimizations.add( + new InstructionSequencesReplacer(InstructionSequenceConstants.CONSTANTS, + InstructionSequenceConstants.VARIABLE, + branchTargetFinder, codeAttributeEditor, codeSimplificationVariableCounter)); + } + + if (codeSimplificationArithmetic) + { + // Peephole optimizations involving arithmetic operations. + peepholeOptimizations.add( + new InstructionSequencesReplacer(InstructionSequenceConstants.CONSTANTS, + InstructionSequenceConstants.ARITHMETIC, + branchTargetFinder, codeAttributeEditor, codeSimplificationArithmeticCounter)); + } + + if (codeSimplificationCast) + { + // Peephole optimizations involving cast operations. + peepholeOptimizations.add( + new InstructionSequencesReplacer(InstructionSequenceConstants.CONSTANTS, + InstructionSequenceConstants.CAST, + branchTargetFinder, codeAttributeEditor, codeSimplificationCastCounter)); + } + + if (codeSimplificationField) + { + // Peephole optimizations involving fields. + peepholeOptimizations.add( + new InstructionSequencesReplacer(InstructionSequenceConstants.CONSTANTS, + InstructionSequenceConstants.FIELD, + branchTargetFinder, codeAttributeEditor, codeSimplificationFieldCounter)); + } + + if (codeSimplificationBranch) + { + // Peephole optimizations involving branches. + peepholeOptimizations.add( + new InstructionSequencesReplacer(InstructionSequenceConstants.CONSTANTS, + InstructionSequenceConstants.BRANCH, + branchTargetFinder, codeAttributeEditor, codeSimplificationBranchCounter)); + + // Include optimization of branches to branches and returns. + peepholeOptimizations.add( + new GotoGotoReplacer(codeAttributeEditor, codeSimplificationBranchCounter)); + peepholeOptimizations.add( + new GotoReturnReplacer(codeAttributeEditor, codeSimplificationBranchCounter)); + } + + if (!peepholeOptimizations.isEmpty()) + { + // Convert the list into an array. + InstructionVisitor[] peepholeOptimizationsArray = + new InstructionVisitor[peepholeOptimizations.size()]; + peepholeOptimizations.toArray(peepholeOptimizationsArray); + + // Perform the peephole optimisations. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new PeepholeOptimizer(branchTargetFinder, codeAttributeEditor, + new MultiInstructionVisitor( + peepholeOptimizationsArray))))); + } + + if (codeRemovalException) + { + // Remove unnecessary exception handlers. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new UnreachableExceptionRemover(codeRemovalExceptionCounter)))); + } + + if (codeRemovalSimple) + { + // Remove unreachable code. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new UnreachableCodeRemover(deletedCounter)))); + } + + if (codeRemovalVariable) + { + // Remove all unused local variables. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new VariableShrinker(codeRemovalVariableCounter)))); + } + else + { + // Clean up all unused local variables. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new VariableCleaner()))); + } + + if (codeAllocationVariable) + { + // Optimize the variables. + programClassPool.classesAccept( + new AllMethodVisitor( + new AllAttributeVisitor( + new VariableOptimizer(false, codeAllocationVariableCounter)))); + } + + int classMarkingFinalCount = classMarkingFinalCounter .getCount(); + int classMergingVerticalCount = classMergingVerticalCounter .getCount(); + int classMergingHorizontalCount = classMergingHorizontalCounter .getCount(); + int fieldRemovalWriteonlyCount = fieldRemovalWriteonlyCounter .getCount(); + int fieldMarkingPrivateCount = fieldMarkingPrivateCounter .getCount(); + int fieldPropagationValueCount = fieldPropagationValueCounter .getCount(); + int methodMarkingPrivateCount = methodMarkingPrivateCounter .getCount(); + int methodMarkingStaticCount = methodMarkingStaticCounter .getCount(); + int methodMarkingFinalCount = methodMarkingFinalCounter .getCount(); + int methodRemovalParameterCount = methodRemovalParameterCounter .getCount() - methodMarkingStaticCounter.getCount() - initializerFixCounter.getCount(); + int methodPropagationParameterCount = methodPropagationParameterCounter .getCount(); + int methodPropagationReturnvalueCount = methodPropagationReturnvalueCounter.getCount(); + int methodInliningShortCount = methodInliningShortCounter .getCount(); + int methodInliningUniqueCount = methodInliningUniqueCounter .getCount(); + int methodInliningTailrecursionCount = methodInliningTailrecursionCounter .getCount(); + int codeMergingCount = codeMergingCounter .getCount(); + int codeSimplificationVariableCount = codeSimplificationVariableCounter .getCount(); + int codeSimplificationArithmeticCount = codeSimplificationArithmeticCounter.getCount(); + int codeSimplificationCastCount = codeSimplificationCastCounter .getCount(); + int codeSimplificationFieldCount = codeSimplificationFieldCounter .getCount(); + int codeSimplificationBranchCount = codeSimplificationBranchCounter .getCount(); + int codeSimplificationAdvancedCount = codeSimplificationAdvancedCounter .getCount(); + int codeRemovalCount = deletedCounter .getCount() - addedCounter.getCount(); + int codeRemovalVariableCount = codeRemovalVariableCounter .getCount(); + int codeRemovalExceptionCount = codeRemovalExceptionCounter .getCount(); + int codeAllocationVariableCount = codeAllocationVariableCounter .getCount(); + + if (configuration.verbose) + { + System.out.println(" Number of finalized classes: " + classMarkingFinalCount + disabled(classMarkingFinal)); + System.out.println(" Number of vertically merged classes: " + classMergingVerticalCount + disabled(classMergingVertical)); + System.out.println(" Number of horizontally merged classes: " + classMergingHorizontalCount + disabled(classMergingHorizontal)); + System.out.println(" Number of removed write-only fields: " + fieldRemovalWriteonlyCount + disabled(fieldRemovalWriteonly)); + System.out.println(" Number of privatized fields: " + fieldMarkingPrivateCount + disabled(fieldMarkingPrivate)); + System.out.println(" Number of inlined constant fields: " + fieldPropagationValueCount + disabled(fieldPropagationValue)); + System.out.println(" Number of privatized methods: " + methodMarkingPrivateCount + disabled(methodMarkingPrivate)); + System.out.println(" Number of staticized methods: " + methodMarkingStaticCount + disabled(methodMarkingStatic)); + System.out.println(" Number of finalized methods: " + methodMarkingFinalCount + disabled(methodMarkingFinal)); + System.out.println(" Number of removed method parameters: " + methodRemovalParameterCount + disabled(methodRemovalParameter)); + System.out.println(" Number of inlined constant parameters: " + methodPropagationParameterCount + disabled(methodPropagationParameter)); + System.out.println(" Number of inlined constant return values: " + methodPropagationReturnvalueCount + disabled(methodPropagationReturnvalue)); + System.out.println(" Number of inlined short method calls: " + methodInliningShortCount + disabled(methodInliningShort)); + System.out.println(" Number of inlined unique method calls: " + methodInliningUniqueCount + disabled(methodInliningUnique)); + System.out.println(" Number of inlined tail recursion calls: " + methodInliningTailrecursionCount + disabled(methodInliningTailrecursion)); + System.out.println(" Number of merged code blocks: " + codeMergingCount + disabled(codeMerging)); + System.out.println(" Number of variable peephole optimizations: " + codeSimplificationVariableCount + disabled(codeSimplificationVariable)); + System.out.println(" Number of arithmetic peephole optimizations: " + codeSimplificationArithmeticCount + disabled(codeSimplificationArithmetic)); + System.out.println(" Number of cast peephole optimizations: " + codeSimplificationCastCount + disabled(codeSimplificationCast)); + System.out.println(" Number of field peephole optimizations: " + codeSimplificationFieldCount + disabled(codeSimplificationField)); + System.out.println(" Number of branch peephole optimizations: " + codeSimplificationBranchCount + disabled(codeSimplificationBranch)); + System.out.println(" Number of simplified instructions: " + codeSimplificationAdvancedCount + disabled(codeSimplificationAdvanced)); + System.out.println(" Number of removed instructions: " + codeRemovalCount + disabled(codeRemovalAdvanced)); + System.out.println(" Number of removed local variables: " + codeRemovalVariableCount + disabled(codeRemovalVariable)); + System.out.println(" Number of removed exception blocks: " + codeRemovalExceptionCount + disabled(codeRemovalException)); + System.out.println(" Number of optimized local variable frames: " + codeAllocationVariableCount + disabled(codeAllocationVariable)); + } + + return classMarkingFinalCount > 0 || + classMergingVerticalCount > 0 || + classMergingHorizontalCount > 0 || + fieldRemovalWriteonlyCount > 0 || + fieldMarkingPrivateCount > 0 || + methodMarkingPrivateCount > 0 || + methodMarkingStaticCount > 0 || + methodMarkingFinalCount > 0 || + fieldPropagationValueCount > 0 || + methodRemovalParameterCount > 0 || + methodPropagationParameterCount > 0 || + methodPropagationReturnvalueCount > 0 || + methodInliningShortCount > 0 || + methodInliningUniqueCount > 0 || + methodInliningTailrecursionCount > 0 || + codeMergingCount > 0 || + codeSimplificationVariableCount > 0 || + codeSimplificationArithmeticCount > 0 || + codeSimplificationCastCount > 0 || + codeSimplificationFieldCount > 0 || + codeSimplificationBranchCount > 0 || + codeSimplificationAdvancedCount > 0 || + codeRemovalCount > 0 || + codeRemovalVariableCount > 0 || + codeRemovalExceptionCount > 0 || + codeAllocationVariableCount > 0; + } + + + /** + * Returns a String indicating whether the given flag is enabled or + * disabled. + */ + private String disabled(boolean flag) + { + return flag ? "" : " (disabled)"; + } + + + /** + * Returns a String indicating whether the given flags are enabled or + * disabled. + */ + private String disabled(boolean flag1, boolean flag2) + { + return flag1 && flag2 ? "" : + flag1 || flag2 ? " (partially disabled)" : + " (disabled)"; + } +} diff --git a/src/proguard/optimize/ParameterShrinker.java b/src/proguard/optimize/ParameterShrinker.java new file mode 100644 index 0000000..a2bc6d3 --- /dev/null +++ b/src/proguard/optimize/ParameterShrinker.java @@ -0,0 +1,146 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.ParameterUsageMarker; + +/** + * This MemberVisitor removes unused parameters from the code of the methods + * that it visits. + * + * @see ParameterUsageMarker + * @see MethodStaticizer + * @see MethodDescriptorShrinker + * @author Eric Lafortune + */ +public class ParameterShrinker +extends SimplifiedVisitor +implements AttributeVisitor +{ + private static final boolean DEBUG = false; + + + private final MemberVisitor extraVariableMemberVisitor; + + private final VariableRemapper variableRemapper = new VariableRemapper(); + + + /** + * Creates a new ParameterShrinker. + */ + public ParameterShrinker() + { + this(null); + } + + + /** + * Creates a new ParameterShrinker with an extra visitor. + * @param extraVariableMemberVisitor an optional extra visitor for all + * removed parameters. + */ + public ParameterShrinker(MemberVisitor extraVariableMemberVisitor) + { + this.extraVariableMemberVisitor = extraVariableMemberVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Get the original parameter size that was saved. + int oldParameterSize = ParameterUsageMarker.getParameterSize(method); + + // Compute the new parameter size from the shrunk descriptor. + int newParameterSize = + ClassUtil.internalMethodParameterSize(method.getDescriptor(clazz), + method.getAccessFlags()); + + if (oldParameterSize > newParameterSize) + { + // Get the total size of the local variable frame. + int maxLocals = codeAttribute.u2maxLocals; + + if (DEBUG) + { + System.out.println("ParameterShrinker: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + System.out.println(" Old parameter size = " + oldParameterSize); + System.out.println(" New parameter size = " + newParameterSize); + System.out.println(" Max locals = " + maxLocals); + } + + // Create a variable map. + int[] variableMap = new int[maxLocals]; + + // Move unused parameters right after the parameter block. + int usedParameterIndex = 0; + int unusedParameterIndex = newParameterSize; + for (int parameterIndex = 0; parameterIndex < oldParameterSize; parameterIndex++) + { + // Is the variable required as a parameter? + if (ParameterUsageMarker.isParameterUsed(method, parameterIndex)) + { + // Keep the variable as a parameter. + variableMap[parameterIndex] = usedParameterIndex++; + } + else + { + if (DEBUG) + { + System.out.println(" Deleting parameter #"+parameterIndex); + } + + // Shift the variable to the unused parameter block, + // in case it is still used as a variable. + variableMap[parameterIndex] = unusedParameterIndex++; + + // Visit the method, if required. + if (extraVariableMemberVisitor != null) + { + method.accept(clazz, extraVariableMemberVisitor); + } + } + } + + // Fill out the remainder of the map. + for (int variableIndex = oldParameterSize; variableIndex < maxLocals; variableIndex++) + { + variableMap[variableIndex] = variableIndex; + } + + // Set the map. + variableRemapper.setVariableMap(variableMap); + + // Remap the variables. + variableRemapper.visitCodeAttribute(clazz, method, codeAttribute); + } + } +} diff --git a/src/proguard/optimize/TailRecursionSimplifier.java b/src/proguard/optimize/TailRecursionSimplifier.java new file mode 100644 index 0000000..0946b6a --- /dev/null +++ b/src/proguard/optimize/TailRecursionSimplifier.java @@ -0,0 +1,331 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.MethodrefConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.editor.CodeAttributeComposer; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; + +/** + * This MemberVisitor simplifies tail recursion calls in all methods that it + * visits. + * + * @author Eric Lafortune + */ +public class TailRecursionSimplifier +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ConstantVisitor, + ExceptionInfoVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private final InstructionVisitor extraTailRecursionVisitor; + + + private final CodeAttributeComposer codeAttributeComposer = new CodeAttributeComposer(); + + private Method targetMethod; + private boolean recursive; + private boolean inlinedAny; + + + + /** + * Creates a new TailRecursionSimplifier. + */ + public TailRecursionSimplifier() + { + this(null); + } + + + /** + * Creates a new TailRecursionSimplifier with an extra visitor. + * @param extraTailRecursionVisitor an optional extra visitor for all + * simplified tail recursions. + */ + public TailRecursionSimplifier(InstructionVisitor extraTailRecursionVisitor) + { + this.extraTailRecursionVisitor = extraTailRecursionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + int accessFlags = method.getAccessFlags(); + + if (// Only check the method if it is private, static, or final. + (accessFlags & (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC | + ClassConstants.INTERNAL_ACC_FINAL)) != 0 && + + // Only check the method if it is not synchronized, etc. + (accessFlags & (ClassConstants.INTERNAL_ACC_SYNCHRONIZED | + ClassConstants.INTERNAL_ACC_NATIVE | + ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) == 0) + { +// codeAttributeComposer.DEBUG = DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + targetMethod = method; + inlinedAny = false; + codeAttributeComposer.reset(); + + // Append the body of the code. + copyCode(clazz, method, codeAttribute); + + // Update the code attribute if any code has been inlined. + if (inlinedAny) + { + codeAttributeComposer.visitCodeAttribute(clazz, method, codeAttribute); + } + } + } + + + /** + * Appends the code of the given code attribute. + */ + private void copyCode(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // The code may expand, due to expanding constant and variable + // instructions. + codeAttributeComposer.beginCodeFragment(codeAttribute.u4codeLength); + + // Copy the instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Append a label just after the code. + codeAttributeComposer.appendLabel(codeAttribute.u4codeLength); + + codeAttributeComposer.endCodeFragment(); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Copy the instruction. + codeAttributeComposer.appendInstruction(offset, instruction.shrink()); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Is it a method invocation? + switch (constantInstruction.opcode) + { + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + { + // Is it a recursive call? + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + + if (recursive) + { + // Is the next instruction a return? + int nextOffset = + offset + constantInstruction.length(offset); + + Instruction nextInstruction = + InstructionFactory.create(codeAttribute.code, nextOffset); + + switch (nextInstruction.opcode) + { + case InstructionConstants.OP_IRETURN: + case InstructionConstants.OP_LRETURN: + case InstructionConstants.OP_FRETURN: + case InstructionConstants.OP_DRETURN: + case InstructionConstants.OP_ARETURN: + case InstructionConstants.OP_RETURN: + { + // Isn't the recursive call inside a try/catch block? + codeAttribute.exceptionsAccept(clazz, method, offset, this); + + if (recursive) + { + if (DEBUG) + { + System.out.println("TailRecursionSimplifier.visitConstantInstruction: ["+ + clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"], inlining "+constantInstruction.toString(offset)); + } + + // Append a label. + codeAttributeComposer.appendLabel(offset); + + storeParameters(clazz, method); + + // Branch back to the start of the method. + int gotoOffset = offset + 1; + codeAttributeComposer.appendInstruction(gotoOffset, + new BranchInstruction(InstructionConstants.OP_GOTO, -gotoOffset)); + + // The original return instruction will be + // removed elsewhere, if possible. + + // Remember that the code has changed. + inlinedAny = true; + + if (extraTailRecursionVisitor != null) + { + extraTailRecursionVisitor.visitConstantInstruction(clazz, method, codeAttribute, offset, constantInstruction); + } + + // The invocation itself is no longer necessary. + return; + } + } + } + } + + break; + } + } + + // Copy the instruction. + codeAttributeComposer.appendInstruction(offset, constantInstruction.shrink()); + } + + + // Implementations for ConstantVisitor. + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + recursive = targetMethod.equals(methodrefConstant.referencedMember); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + recursive = false; + } + + + // Small utility methods. + + /** + * Appends instructions to pop the parameters for the given method, storing + * them in new local variables. + */ + private void storeParameters(Clazz clazz, Method method) + { + String descriptor = method.getDescriptor(clazz); + + boolean isStatic = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0; + + // Count the number of parameters, taking into account their categories. + int parameterCount = ClassUtil.internalMethodParameterCount(descriptor); + int parameterSize = ClassUtil.internalMethodParameterSize(descriptor); + int parameterOffset = isStatic ? 0 : 1; + + // Store the parameter types. + String[] parameterTypes = new String[parameterSize]; + + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + for (int parameterIndex = 0; parameterIndex < parameterSize; parameterIndex++) + { + String parameterType = internalTypeEnumeration.nextType(); + parameterTypes[parameterIndex] = parameterType; + if (ClassUtil.internalTypeSize(parameterType) == 2) + { + parameterIndex++; + } + } + + codeAttributeComposer.beginCodeFragment(parameterSize + 1); + + // Go over the parameter types backward, storing the stack entries + // in their corresponding variables. + for (int parameterIndex = parameterSize-1; parameterIndex >= 0; parameterIndex--) + { + String parameterType = parameterTypes[parameterIndex]; + if (parameterType != null) + { + byte opcode; + switch (parameterType.charAt(0)) + { + case ClassConstants.INTERNAL_TYPE_BOOLEAN: + case ClassConstants.INTERNAL_TYPE_BYTE: + case ClassConstants.INTERNAL_TYPE_CHAR: + case ClassConstants.INTERNAL_TYPE_SHORT: + case ClassConstants.INTERNAL_TYPE_INT: + opcode = InstructionConstants.OP_ISTORE; + break; + + case ClassConstants.INTERNAL_TYPE_LONG: + opcode = InstructionConstants.OP_LSTORE; + break; + + case ClassConstants.INTERNAL_TYPE_FLOAT: + opcode = InstructionConstants.OP_FSTORE; + break; + + case ClassConstants.INTERNAL_TYPE_DOUBLE: + opcode = InstructionConstants.OP_DSTORE; + break; + + default: + opcode = InstructionConstants.OP_ASTORE; + break; + } + + codeAttributeComposer.appendInstruction(parameterSize-parameterIndex-1, + new VariableInstruction(opcode, parameterOffset + parameterIndex).shrink()); + } + } + + // Put the 'this' reference in variable 0. + if (!isStatic) + { + codeAttributeComposer.appendInstruction(parameterSize, + new VariableInstruction(InstructionConstants.OP_ASTORE, 0).shrink()); + } + + codeAttributeComposer.endCodeFragment(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/WriteOnlyFieldFilter.java b/src/proguard/optimize/WriteOnlyFieldFilter.java new file mode 100644 index 0000000..578beb2 --- /dev/null +++ b/src/proguard/optimize/WriteOnlyFieldFilter.java @@ -0,0 +1,65 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.ReadWriteFieldMarker; + +/** + * This MemberVisitor delegates its visits to program fields to + * other given MemberVisitor instances, but only when the visited + * field has been marked as write-only. + * + * @see ReadWriteFieldMarker + * @author Eric Lafortune + */ +public class WriteOnlyFieldFilter +extends SimplifiedVisitor +implements MemberVisitor +{ + private final MemberVisitor writeOnlyFieldVisitor; + + + /** + * Creates a new WriteOnlyFieldFilter. + * @param writeOnlyFieldVisitor the MemberVisitor to which + * visits to write-only fields will be delegated. + */ + public WriteOnlyFieldFilter(MemberVisitor writeOnlyFieldVisitor) + { + this.writeOnlyFieldVisitor = writeOnlyFieldVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + + if (ReadWriteFieldMarker.isWritten(programField) && + !ReadWriteFieldMarker.isRead(programField)) + { + writeOnlyFieldVisitor.visitProgramField(programClass, programField); + } + } +} diff --git a/src/proguard/optimize/evaluation/EvaluationShrinker.java b/src/proguard/optimize/evaluation/EvaluationShrinker.java new file mode 100644 index 0000000..1463feb --- /dev/null +++ b/src/proguard/optimize/evaluation/EvaluationShrinker.java @@ -0,0 +1,1912 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.RefConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.evaluation.*; +import proguard.evaluation.value.*; +import proguard.optimize.info.*; + +/** + * This AttributeVisitor simplifies the code attributes that it visits, based + * on partial evaluation. + * + * @author Eric Lafortune + */ +public class EvaluationShrinker +extends SimplifiedVisitor +implements AttributeVisitor +{ + //* + private static final boolean DEBUG_RESULTS = false; + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG_RESULTS = true; + private static boolean DEBUG = true; + //*/ + + private final InstructionVisitor extraDeletedInstructionVisitor; + private final InstructionVisitor extraAddedInstructionVisitor; + + private final PartialEvaluator partialEvaluator; + private final PartialEvaluator simplePartialEvaluator = new PartialEvaluator(); + private final SideEffectInstructionChecker sideEffectInstructionChecker = new SideEffectInstructionChecker(true); + private final MyUnusedParameterSimplifier unusedParameterSimplifier = new MyUnusedParameterSimplifier(); + private final MyProducerMarker producerMarker = new MyProducerMarker(); + private final MyStackConsistencyFixer stackConsistencyFixer = new MyStackConsistencyFixer(); + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(false); + + private boolean[][] variablesNecessaryAfter = new boolean[ClassConstants.TYPICAL_CODE_LENGTH][ClassConstants.TYPICAL_VARIABLES_SIZE]; + private boolean[][] stacksNecessaryAfter = new boolean[ClassConstants.TYPICAL_CODE_LENGTH][ClassConstants.TYPICAL_STACK_SIZE]; + private boolean[][] stacksSimplifiedBefore = new boolean[ClassConstants.TYPICAL_CODE_LENGTH][ClassConstants.TYPICAL_STACK_SIZE]; + private boolean[] instructionsNecessary = new boolean[ClassConstants.TYPICAL_CODE_LENGTH]; + + private int maxMarkedOffset; + + + /** + * Creates a new EvaluationShrinker. + */ + public EvaluationShrinker() + { + this(new PartialEvaluator(), null, null); + } + + + /** + * Creates a new EvaluationShrinker. + * @param partialEvaluator the partial evaluator that will + * execute the code and provide + * information about the results. + * @param extraDeletedInstructionVisitor an optional extra visitor for all + * deleted instructions. + * @param extraAddedInstructionVisitor an optional extra visitor for all + * added instructions. + */ + public EvaluationShrinker(PartialEvaluator partialEvaluator, + InstructionVisitor extraDeletedInstructionVisitor, + InstructionVisitor extraAddedInstructionVisitor) + { + this.partialEvaluator = partialEvaluator; + this.extraDeletedInstructionVisitor = extraDeletedInstructionVisitor; + this.extraAddedInstructionVisitor = extraAddedInstructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = DEBUG_RESULTS = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the evaluation shrinker has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while shrinking instructions after partial evaluation:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + System.err.println("Not optimizing this method"); + + if (DEBUG) + { + method.accept(clazz, new ClassPrinter()); + + throw ex; + } + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (DEBUG_RESULTS) + { + System.out.println(); + System.out.println("Class "+ClassUtil.externalClassName(clazz.getName())); + System.out.println("Method "+ClassUtil.externalFullMethodDescription(clazz.getName(), + 0, + method.getName(clazz), + method.getDescriptor(clazz))); + } + + // Initialize the necessary array. + initializeNecessary(codeAttribute); + + // Evaluate the method. + partialEvaluator.visitCodeAttribute(clazz, method, codeAttribute); + + int codeLength = codeAttribute.u4codeLength; + + // Reset the code changes. + codeAttributeEditor.reset(codeLength); + + // Mark any unused method parameters on the stack. + if (DEBUG) System.out.println("Invocation simplification:"); + + for (int offset = 0; offset < codeLength; offset++) + { + if (partialEvaluator.isTraced(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + + instruction.accept(clazz, method, codeAttribute, offset, unusedParameterSimplifier); + } + } + + // Mark all essential instructions that have been encountered as used. + if (DEBUG) System.out.println("Usage initialization: "); + + maxMarkedOffset = -1; + + // The invocation of the "super" or "this" method inside a + // constructor is always necessary. + int superInitializationOffset = partialEvaluator.superInitializationOffset(); + if (superInitializationOffset != PartialEvaluator.NONE) + { + if (DEBUG) System.out.print("(super.)"); + + markInstruction(superInitializationOffset); + } + + // Also mark infinite loops and instructions that cause side effects. + for (int offset = 0; offset < codeLength; offset++) + { + if (partialEvaluator.isTraced(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + + // Mark that the instruction is necessary if it is an infinite loop. + if (instruction.opcode == InstructionConstants.OP_GOTO && + ((BranchInstruction)instruction).branchOffset == 0) + { + if (DEBUG) System.out.print("(infinite loop)"); + markInstruction(offset); + } + + // Mark that the instruction is necessary if it has side effects. + else if (sideEffectInstructionChecker.hasSideEffects(clazz, + method, + codeAttribute, + offset, + instruction)) + { + markInstruction(offset); + } + } + } + if (DEBUG) System.out.println(); + + + // Globally mark instructions and their produced variables and stack + // entries on which necessary instructions depend. + // Instead of doing this recursively, we loop across all instructions, + // starting at the highest previously unmarked instruction that has + // been been marked. + if (DEBUG) System.out.println("Usage marking:"); + + while (maxMarkedOffset >= 0) + { + int offset = maxMarkedOffset; + + maxMarkedOffset = offset - 1; + + if (partialEvaluator.isTraced(offset)) + { + if (isInstructionNecessary(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + + instruction.accept(clazz, method, codeAttribute, offset, producerMarker); + } + + // Check if this instruction is a branch origin from a branch + // that straddles some marked code. + markStraddlingBranches(offset, + partialEvaluator.branchTargets(offset), + true); + + // Check if this instruction is a branch target from a branch + // that straddles some marked code. + markStraddlingBranches(offset, + partialEvaluator.branchOrigins(offset), + false); + } + + if (DEBUG) + { + if (maxMarkedOffset > offset) + { + System.out.println(" -> "+maxMarkedOffset); + } + } + } + if (DEBUG) System.out.println(); + + + // Mark variable initializations, even if they aren't strictly necessary. + // The virtual machine's verification step is not smart enough to see + // this, and may complain otherwise. + if (DEBUG) System.out.println("Initialization marking: "); + + for (int offset = 0; offset < codeLength; offset++) + { + // Is it a variable initialization that hasn't been marked yet? + if (partialEvaluator.isTraced(offset) && + !isInstructionNecessary(offset)) + { + // Is the corresponding variable necessary anywhere in the code, + // accoriding to a simple partial evaluation? + int variableIndex = partialEvaluator.initializedVariable(offset); + if (variableIndex >= 0 && + isVariableInitializationNecessary(clazz, + method, + codeAttribute, + offset, + variableIndex)) + { + markInstruction(offset); + } + } + } + if (DEBUG) System.out.println(); + + + // Locally fix instructions, in order to keep the stack consistent. + if (DEBUG) System.out.println("Stack consistency fixing:"); + + maxMarkedOffset = codeLength - 1; + + while (maxMarkedOffset >= 0) + { + int offset = maxMarkedOffset; + + maxMarkedOffset = offset - 1; + + if (partialEvaluator.isTraced(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + + instruction.accept(clazz, method, codeAttribute, offset, stackConsistencyFixer); + + // Check if this instruction is a branch origin from a branch + // that straddles some marked code. + markStraddlingBranches(offset, + partialEvaluator.branchTargets(offset), + true); + + // Check if this instruction is a branch target from a branch + // that straddles some marked code. + markStraddlingBranches(offset, + partialEvaluator.branchOrigins(offset), + false); + } + } + if (DEBUG) System.out.println(); + + + // Replace traced but unmarked backward branches by infinite loops. + // The virtual machine's verification step is not smart enough to see + // the code isn't reachable, and may complain otherwise. + // Any clearly unreachable code will still be removed elsewhere. + if (DEBUG) System.out.println("Infinite loop fixing:"); + + for (int offset = 0; offset < codeLength; offset++) + { + // Is it a traced but unmarked backward branch, without an unmarked + // straddling forward branch? Note that this is still a heuristic. + if (partialEvaluator.isTraced(offset) && + !isInstructionNecessary(offset) && + isAllSmallerThanOrEqual(partialEvaluator.branchTargets(offset), + offset) && + !isAnyUnnecessaryInstructionBranchingOver(lastNecessaryInstructionOffset(offset), + offset)) + { + replaceByInfiniteLoop(clazz, offset); + } + } + if (DEBUG) System.out.println(); + + + // Insert infinite loops after jumps to subroutines that don't return. + // The virtual machine's verification step is not smart enough to see + // the code isn't reachable, and may complain otherwise. + if (DEBUG) System.out.println("Non-returning subroutine fixing:"); + + for (int offset = 0; offset < codeLength; offset++) + { + // Is it a traced but unmarked backward branch, without an unmarked + // straddling forward branch? Note that this is still a heuristic. + if (isInstructionNecessary(offset) && + partialEvaluator.isSubroutineInvocation(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + + int nextOffset = offset + instruction.length(offset); + if (!isInstructionNecessary(nextOffset)) + { + replaceByInfiniteLoop(clazz, nextOffset); + } + } + } + if (DEBUG) System.out.println(); + + + // Delete all instructions that are not used. + int offset = 0; + do + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + if (!isInstructionNecessary(offset)) + { + codeAttributeEditor.deleteInstruction(offset); + + codeAttributeEditor.insertBeforeInstruction(offset, (Instruction)null); + codeAttributeEditor.replaceInstruction(offset, (Instruction)null); + codeAttributeEditor.insertAfterInstruction(offset, (Instruction)null); + + // Visit the instruction, if required. + if (extraDeletedInstructionVisitor != null) + { + instruction.accept(clazz, method, codeAttribute, offset, extraDeletedInstructionVisitor); + } + } + + offset += instruction.length(offset); + } + while (offset < codeLength); + + + if (DEBUG_RESULTS) + { + System.out.println("Simplification results:"); + + offset = 0; + do + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + System.out.println((isInstructionNecessary(offset) ? " + " : " - ")+instruction.toString(offset)); + + if (partialEvaluator.isTraced(offset)) + { + int initializationOffset = partialEvaluator.initializationOffset(offset); + if (initializationOffset != PartialEvaluator.NONE) + { + System.out.println(" is to be initialized at ["+initializationOffset+"]"); + } + + InstructionOffsetValue branchTargets = partialEvaluator.branchTargets(offset); + if (branchTargets != null) + { + System.out.println(" has overall been branching to "+branchTargets); + } + + boolean deleted = codeAttributeEditor.deleted[offset]; + if (isInstructionNecessary(offset) && deleted) + { + System.out.println(" is deleted"); + } + + Instruction preInsertion = codeAttributeEditor.preInsertions[offset]; + if (preInsertion != null) + { + System.out.println(" is preceded by: "+preInsertion); + } + + Instruction replacement = codeAttributeEditor.replacements[offset]; + if (replacement != null) + { + System.out.println(" is replaced by: "+replacement); + } + + Instruction postInsertion = codeAttributeEditor.postInsertions[offset]; + if (postInsertion != null) + { + System.out.println(" is followed by: "+postInsertion); + } + } + + offset += instruction.length(offset); + } + while (offset < codeLength); + } + + // Apply all accumulated changes to the code. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + + + /** + * This MemberVisitor marks stack entries that aren't necessary because + * parameters aren't used in the methods that are visited. + */ + private class MyUnusedParameterSimplifier + extends SimplifiedVisitor + implements InstructionVisitor, ConstantVisitor, MemberVisitor + { + private int invocationOffset; + private ConstantInstruction invocationInstruction; + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + switch (constantInstruction.opcode) + { + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + this.invocationOffset = offset; + this.invocationInstruction = constantInstruction; + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + break; + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + refConstant.referencedMemberAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) {} + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Get the total size of the parameters. + int parameterSize = ParameterUsageMarker.getParameterSize(programMethod); + + // Make the method invocation static, if possible. + if ((programMethod.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) == 0 && + !ParameterUsageMarker.isParameterUsed(programMethod, 0)) + { + replaceByStaticInvocation(programClass, + invocationOffset, + invocationInstruction); + } + + // Remove unused parameters. + for (int index = 0; index < parameterSize; index++) + { + if (!ParameterUsageMarker.isParameterUsed(programMethod, index)) + { + TracedStack stack = + partialEvaluator.getStackBefore(invocationOffset); + + int stackIndex = stack.size() - parameterSize + index; + + if (DEBUG) + { + System.out.println(" ["+invocationOffset+"] Ignoring parameter #"+index+" of "+programClass.getName()+"."+programMethod.getName(programClass)+programMethod.getDescriptor(programClass)+"] (stack entry #"+stackIndex+" ["+stack.getBottom(stackIndex)+"])"); + System.out.println(" Full stack: "+stack); + } + + markStackSimplificationBefore(invocationOffset, stackIndex); + } + } + } + } + + + /** + * This InstructionVisitor marks the producing instructions and produced + * variables and stack entries of the instructions that it visits. + * Simplified method arguments are ignored. + */ + private class MyProducerMarker + extends SimplifiedVisitor + implements InstructionVisitor + { + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + markStackProducers(clazz, offset, instruction); + } + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + switch (simpleInstruction.opcode) + { + case InstructionConstants.OP_DUP: + conditionallyMarkStackEntryProducers(offset, 0, 0); + conditionallyMarkStackEntryProducers(offset, 1, 0); + break; + case InstructionConstants.OP_DUP_X1: + conditionallyMarkStackEntryProducers(offset, 0, 0); + conditionallyMarkStackEntryProducers(offset, 1, 1); + conditionallyMarkStackEntryProducers(offset, 2, 0); + break; + case InstructionConstants.OP_DUP_X2: + conditionallyMarkStackEntryProducers(offset, 0, 0); + conditionallyMarkStackEntryProducers(offset, 1, 1); + conditionallyMarkStackEntryProducers(offset, 2, 2); + conditionallyMarkStackEntryProducers(offset, 3, 0); + break; + case InstructionConstants.OP_DUP2: + conditionallyMarkStackEntryProducers(offset, 0, 0); + conditionallyMarkStackEntryProducers(offset, 1, 1); + conditionallyMarkStackEntryProducers(offset, 2, 0); + conditionallyMarkStackEntryProducers(offset, 3, 1); + break; + case InstructionConstants.OP_DUP2_X1: + conditionallyMarkStackEntryProducers(offset, 0, 0); + conditionallyMarkStackEntryProducers(offset, 1, 1); + conditionallyMarkStackEntryProducers(offset, 2, 2); + conditionallyMarkStackEntryProducers(offset, 3, 0); + conditionallyMarkStackEntryProducers(offset, 4, 1); + break; + case InstructionConstants.OP_DUP2_X2: + conditionallyMarkStackEntryProducers(offset, 0, 0); + conditionallyMarkStackEntryProducers(offset, 1, 1); + conditionallyMarkStackEntryProducers(offset, 2, 2); + conditionallyMarkStackEntryProducers(offset, 3, 3); + conditionallyMarkStackEntryProducers(offset, 4, 0); + conditionallyMarkStackEntryProducers(offset, 5, 1); + break; + case InstructionConstants.OP_SWAP: + conditionallyMarkStackEntryProducers(offset, 0, 1); + conditionallyMarkStackEntryProducers(offset, 1, 0); + break; + default: + markStackProducers(clazz, offset, simpleInstruction); + break; + } + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + // Is the variable being loaded (or incremented)? + if (variableInstruction.opcode < InstructionConstants.OP_ISTORE) + { + markVariableProducers(offset, variableInstruction.variableIndex); + } + else + { + markStackProducers(clazz, offset, variableInstruction); + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Mark the initializer invocation, if this is a 'new' instruction. + if (constantInstruction.opcode == InstructionConstants.OP_NEW) + { + markInitialization(offset); + } + + markStackProducers(clazz, offset, constantInstruction); + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Explicitly mark the produced stack entry of a 'jsr' instruction, + // because the consuming 'astore' instruction of the subroutine is + // cleared every time it is traced. + if (branchInstruction.opcode == InstructionConstants.OP_JSR || + branchInstruction.opcode == InstructionConstants.OP_JSR_W) + { + markStackEntryAfter(offset, 0); + } + else + { + markStackProducers(clazz, offset, branchInstruction); + } + } + } + + + /** + * This InstructionVisitor fixes instructions locally, popping any unused + * produced stack entries after marked instructions, and popping produced + * stack entries and pushing missing stack entries instead of unmarked + * instructions. + */ + private class MyStackConsistencyFixer + extends SimplifiedVisitor + implements InstructionVisitor + { + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Has the instruction been marked? + if (isInstructionNecessary(offset)) + { + // Check all stack entries that are popped. + // Typical case: a freshly marked variable initialization that + // requires some value on the stack. + int popCount = instruction.stackPopCount(clazz); + if (popCount > 0) + { + TracedStack tracedStack = + partialEvaluator.getStackBefore(offset); + + int top = tracedStack.size() - 1; + + int requiredPushCount = 0; + for (int stackIndex = 0; stackIndex < popCount; stackIndex++) + { + // Is the stack entry required by other consumers? + if (!isStackSimplifiedBefore(offset, top - stackIndex) && + !isAnyStackEntryNecessaryAfter(tracedStack.getTopProducerValue(stackIndex).instructionOffsetValue(), top - stackIndex)) + { + // Remember to push it. + requiredPushCount++; + } + } + + // Push some necessary stack entries. + if (requiredPushCount > 0) + { + if (DEBUG) System.out.println(" Inserting before marked consumer "+instruction.toString(offset)); + + if (requiredPushCount > (instruction.isCategory2() ? 2 : 1)) + { + throw new IllegalArgumentException("Unsupported stack size increment ["+requiredPushCount+"]"); + } + + insertPushInstructions(offset, false, tracedStack.getTop(0).computationalType()); + } + } + + // Check all stack entries that are pushed. + // Typical case: a return value that wasn't really required and + // that should be popped. + int pushCount = instruction.stackPushCount(clazz); + if (pushCount > 0) + { + TracedStack tracedStack = + partialEvaluator.getStackAfter(offset); + + int top = tracedStack.size() - 1; + + int requiredPopCount = 0; + for (int stackIndex = 0; stackIndex < pushCount; stackIndex++) + { + // Is the stack entry required by consumers? + if (!isStackEntryNecessaryAfter(offset, top - stackIndex)) + { + // Remember to pop it. + requiredPopCount++; + } + } + + // Pop the unnecessary stack entries. + if (requiredPopCount > 0) + { + if (DEBUG) System.out.println(" Inserting after marked producer "+instruction.toString(offset)); + + insertPopInstructions(offset, false, requiredPopCount); + } + } + } + else + { + // Check all stack entries that would be popped. + // Typical case: a stack value that is required elsewhere and + // that still has to be popped. + int popCount = instruction.stackPopCount(clazz); + if (popCount > 0) + { + TracedStack tracedStack = + partialEvaluator.getStackBefore(offset); + + int top = tracedStack.size() - 1; + + int expectedPopCount = 0; + for (int stackIndex = 0; stackIndex < popCount; stackIndex++) + { + // Is the stack entry required by other consumers? + if (isAnyStackEntryNecessaryAfter(tracedStack.getTopProducerValue(stackIndex).instructionOffsetValue(), top - stackIndex)) + { + // Remember to pop it. + expectedPopCount++; + } + } + + // Pop the unnecessary stack entries. + if (expectedPopCount > 0) + { + if (DEBUG) System.out.println(" Replacing unmarked consumer "+instruction.toString(offset)); + + insertPopInstructions(offset, true, expectedPopCount); + } + } + + // Check all stack entries that would be pushed. + // Typical case: never. + int pushCount = instruction.stackPushCount(clazz); + if (pushCount > 0) + { + TracedStack tracedStack = + partialEvaluator.getStackAfter(offset); + + int top = tracedStack.size() - 1; + + int expectedPushCount = 0; + for (int stackIndex = 0; stackIndex < pushCount; stackIndex++) + { + // Is the stack entry required by consumers? + if (isStackEntryNecessaryAfter(offset, top - stackIndex)) + { + // Remember to push it. + expectedPushCount++; + } + } + + // Push some necessary stack entries. + if (expectedPushCount > 0) + { + if (DEBUG) System.out.println(" Replacing unmarked producer "+instruction.toString(offset)); + + insertPushInstructions(offset, true, tracedStack.getTop(0).computationalType()); + } + } + } + } + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + if (isInstructionNecessary(offset) && + isDupOrSwap(simpleInstruction)) + { + fixDupInstruction(clazz, codeAttribute, offset, simpleInstruction); + } + else + { + visitAnyInstruction(clazz, method, codeAttribute, offset, simpleInstruction); + } + } + } + + + // Small utility methods. + + /** + * Marks the variable and the corresponding producing instructions + * of the consumer at the given offset. + * @param consumerOffset the offset of the consumer. + * @param variableIndex the index of the variable to be marked. + */ + private void markVariableProducers(int consumerOffset, + int variableIndex) + { + TracedVariables tracedVariables = + partialEvaluator.getVariablesBefore(consumerOffset); + + // Mark the producer of the loaded value. + markVariableProducers(tracedVariables.getProducerValue(variableIndex).instructionOffsetValue(), + variableIndex); + } + + + /** + * Marks the variable and its producing instructions at the given offsets. + * @param producerOffsets the offsets of the producers to be marked. + * @param variableIndex the index of the variable to be marked. + */ + private void markVariableProducers(InstructionOffsetValue producerOffsets, + int variableIndex) + { + if (producerOffsets != null) + { + int offsetCount = producerOffsets.instructionOffsetCount(); + for (int offsetIndex = 0; offsetIndex < offsetCount; offsetIndex++) + { + // Make sure the variable and the instruction are marked + // at the producing offset. + int offset = producerOffsets.instructionOffset(offsetIndex); + + markVariableAfter(offset, variableIndex); + markInstruction(offset); + } + } + } + + + /** + * Marks the stack entries and their producing instructions of the + * consumer at the given offset. + * @param clazz the containing class. + * @param consumerOffset the offset of the consumer. + * @param consumer the consumer of the stack entries. + */ + private void markStackProducers(Clazz clazz, + int consumerOffset, + Instruction consumer) + { + // Mark the producers of the popped values. + int popCount = consumer.stackPopCount(clazz); + for (int stackIndex = 0; stackIndex < popCount; stackIndex++) + { + markStackEntryProducers(consumerOffset, stackIndex); + } + } + + + /** + * Marks the stack entry and the corresponding producing instructions + * of the consumer at the given offset, if the stack entry of the + * consumer is marked. + * @param consumerOffset the offset of the consumer. + * @param consumerStackIndex the index of the stack entry to be checked + * (counting from the top). + * @param producerStackIndex the index of the stack entry to be marked + * (counting from the top). + */ + private void conditionallyMarkStackEntryProducers(int consumerOffset, + int consumerStackIndex, + int producerStackIndex) + { + int top = partialEvaluator.getStackAfter(consumerOffset).size() - 1; + + if (isStackEntryNecessaryAfter(consumerOffset, top - consumerStackIndex)) + { + markStackEntryProducers(consumerOffset, producerStackIndex); + } + } + + + /** + * Marks the stack entry and the corresponding producing instructions + * of the consumer at the given offset. + * @param consumerOffset the offset of the consumer. + * @param stackIndex the index of the stack entry to be marked + * (counting from the top). + */ + private void markStackEntryProducers(int consumerOffset, + int stackIndex) + { + TracedStack tracedStack = + partialEvaluator.getStackBefore(consumerOffset); + + int stackBottomIndex = tracedStack.size() - 1 - stackIndex; + + if (!isStackSimplifiedBefore(consumerOffset, stackBottomIndex)) + { + markStackEntryProducers(tracedStack.getTopProducerValue(stackIndex).instructionOffsetValue(), + stackBottomIndex); + } + } + + + /** + * Marks the stack entry and its producing instructions at the given + * offsets. + * @param producerOffsets the offsets of the producers to be marked. + * @param stackIndex the index of the stack entry to be marked + * (counting from the bottom). + */ + private void markStackEntryProducers(InstructionOffsetValue producerOffsets, + int stackIndex) + { + if (producerOffsets != null) + { + int offsetCount = producerOffsets.instructionOffsetCount(); + for (int offsetIndex = 0; offsetIndex < offsetCount; offsetIndex++) + { + // Make sure the stack entry and the instruction are marked + // at the producing offset. + int offset = producerOffsets.instructionOffset(offsetIndex); + + markStackEntryAfter(offset, stackIndex); + markInstruction(offset); + } + } + } + + + /** + * Marks the stack entry and its initializing instruction + * ('invokespecial *.') for the given 'new' instruction offset. + * @param newInstructionOffset the offset of the 'new' instruction. + */ + private void markInitialization(int newInstructionOffset) + { + int initializationOffset = + partialEvaluator.initializationOffset(newInstructionOffset); + + TracedStack tracedStack = + partialEvaluator.getStackAfter(newInstructionOffset); + + markStackEntryAfter(initializationOffset, tracedStack.size() - 1); + markInstruction(initializationOffset); + } + + + /** + * Marks the branch instructions of straddling branches, if they straddle + * some code that has been marked. + * @param instructionOffset the offset of the branch origin or branch target. + * @param branchOffsets the offsets of the straddling branch targets + * or branch origins. + * @param isPointingToTargets true if the above offsets are + * branch targets, false if they + * are branch origins. + */ + private void markStraddlingBranches(int instructionOffset, + InstructionOffsetValue branchOffsets, + boolean isPointingToTargets) + { + if (branchOffsets != null) + { + // Loop over all branch offsets. + int branchCount = branchOffsets.instructionOffsetCount(); + for (int branchIndex = 0; branchIndex < branchCount; branchIndex++) + { + // Is the branch straddling forward any necessary instructions? + int branchOffset = branchOffsets.instructionOffset(branchIndex); + + // Is the offset pointing to a branch origin or to a branch target? + if (isPointingToTargets) + { + markStraddlingBranch(instructionOffset, + branchOffset, + instructionOffset, + branchOffset); + } + else + { + markStraddlingBranch(instructionOffset, + branchOffset, + branchOffset, + instructionOffset); + } + } + } + } + + + private void markStraddlingBranch(int instructionOffsetStart, + int instructionOffsetEnd, + int branchOrigin, + int branchTarget) + { + if (!isInstructionNecessary(branchOrigin) && + isAnyInstructionNecessary(instructionOffsetStart, instructionOffsetEnd)) + { + if (DEBUG) System.out.print("["+branchOrigin+"->"+branchTarget+"]"); + + // Mark the branch instruction. + markInstruction(branchOrigin); + } + } + + + /** + * Marks the specified instruction if it is a required dup/swap instruction, + * replacing it by an appropriate variant if necessary. + * @param clazz the class that is being checked. + * @param codeAttribute the code that is being checked. + * @param dupOffset the offset of the dup/swap instruction. + * @param instruction the dup/swap instruction. + */ + private void fixDupInstruction(Clazz clazz, + CodeAttribute codeAttribute, + int dupOffset, + Instruction instruction) + { + int top = partialEvaluator.getStackAfter(dupOffset).size() - 1; + + byte oldOpcode = instruction.opcode; + byte newOpcode = 0; + + // Simplify the popping instruction if possible. + switch (oldOpcode) + { + case InstructionConstants.OP_DUP: + { + boolean stackEntryPresent0 = isStackEntryNecessaryAfter(dupOffset, top - 0); + boolean stackEntryPresent1 = isStackEntryNecessaryAfter(dupOffset, top - 1); + + // Should either the original element or the copy be present? + if (stackEntryPresent0 || + stackEntryPresent1) + { + // Should both the original element and the copy be present? + if (stackEntryPresent0 && + stackEntryPresent1) + { + newOpcode = InstructionConstants.OP_DUP; + } + } + break; + } + case InstructionConstants.OP_DUP_X1: + { + boolean stackEntryPresent0 = isStackEntryNecessaryAfter(dupOffset, top - 0); + boolean stackEntryPresent1 = isStackEntryNecessaryAfter(dupOffset, top - 1); + boolean stackEntryPresent2 = isStackEntryNecessaryAfter(dupOffset, top - 2); + + // Should either the original element or the copy be present? + if (stackEntryPresent0 || + stackEntryPresent2) + { + // Should the copy be present? + if (stackEntryPresent2) + { + // Compute the number of elements to be skipped. + int skipCount = stackEntryPresent1 ? 1 : 0; + + // Should the original element be present? + if (stackEntryPresent0) + { + // Copy the original element. + newOpcode = (byte)(InstructionConstants.OP_DUP + skipCount); + } + else if (skipCount == 1) + { + // Move the original element. + newOpcode = InstructionConstants.OP_SWAP; + } + } + } + break; + } + case InstructionConstants.OP_DUP_X2: + { + boolean stackEntryPresent0 = isStackEntryNecessaryAfter(dupOffset, top - 0); + boolean stackEntryPresent1 = isStackEntryNecessaryAfter(dupOffset, top - 1); + boolean stackEntryPresent2 = isStackEntryNecessaryAfter(dupOffset, top - 2); + boolean stackEntryPresent3 = isStackEntryNecessaryAfter(dupOffset, top - 3); + + // Should either the original element or the copy be present? + if (stackEntryPresent0 || + stackEntryPresent3) + { + // Should the copy be present? + if (stackEntryPresent3) + { + int skipCount = (stackEntryPresent1 ? 1 : 0) + + (stackEntryPresent2 ? 1 : 0); + + // Should the original element be present? + if (stackEntryPresent0) + { + // Copy the original element. + newOpcode = (byte)(InstructionConstants.OP_DUP + skipCount); + } + else if (skipCount == 1) + { + // Move the original element. + newOpcode = InstructionConstants.OP_SWAP; + } + else if (skipCount == 2) + { + // We can't easily move the original element. + throw new UnsupportedOperationException("Can't handle dup_x2 instruction moving original element across two elements at ["+dupOffset +"]"); + } + } + } + break; + } + case InstructionConstants.OP_DUP2: + { + boolean stackEntriesPresent01 = isStackEntriesNecessaryAfter(dupOffset, top - 0, top - 1); + boolean stackEntriesPresent23 = isStackEntriesNecessaryAfter(dupOffset, top - 2, top - 3); + + // Should either the original element or the copy be present? + if (stackEntriesPresent01 || + stackEntriesPresent23) + { + // Should both the original element and the copy be present? + if (stackEntriesPresent01 && + stackEntriesPresent23) + { + newOpcode = InstructionConstants.OP_DUP2; + } + } + break; + } + case InstructionConstants.OP_DUP2_X1: + { + boolean stackEntriesPresent01 = isStackEntriesNecessaryAfter(dupOffset, top - 0, top - 1); + boolean stackEntryPresent2 = isStackEntryNecessaryAfter(dupOffset, top - 2); + boolean stackEntriesPresent34 = isStackEntriesNecessaryAfter(dupOffset, top - 3, top - 4); + + // Should either the original element or the copy be present? + if (stackEntriesPresent01 || + stackEntriesPresent34) + { + // Should the copy be present? + if (stackEntriesPresent34) + { + int skipCount = stackEntryPresent2 ? 1 : 0; + + // Should the original element be present? + if (stackEntriesPresent01) + { + // Copy the original element. + newOpcode = (byte)(InstructionConstants.OP_DUP2 + skipCount); + } + else if (skipCount > 0) + { + // We can't easily move the original element. + throw new UnsupportedOperationException("Can't handle dup2_x1 instruction moving original element across "+skipCount+" elements at ["+dupOffset +"]"); + } + } + } + break; + } + case InstructionConstants.OP_DUP2_X2: + { + boolean stackEntriesPresent01 = isStackEntriesNecessaryAfter(dupOffset, top - 0, top - 1); + boolean stackEntryPresent2 = isStackEntryNecessaryAfter(dupOffset, top - 2); + boolean stackEntryPresent3 = isStackEntryNecessaryAfter(dupOffset, top - 3); + boolean stackEntriesPresent45 = isStackEntriesNecessaryAfter(dupOffset, top - 4, top - 5); + + // Should either the original element or the copy be present? + if (stackEntriesPresent01 || + stackEntriesPresent45) + { + // Should the copy be present? + if (stackEntriesPresent45) + { + int skipCount = (stackEntryPresent2 ? 1 : 0) + + (stackEntryPresent3 ? 1 : 0); + + // Should the original element be present? + if (stackEntriesPresent01) + { + // Copy the original element. + newOpcode = (byte)(InstructionConstants.OP_DUP2 + skipCount); + } + else if (skipCount > 0) + { + // We can't easily move the original element. + throw new UnsupportedOperationException("Can't handle dup2_x2 instruction moving original element across "+skipCount+" elements at ["+dupOffset +"]"); + } + } + } + break; + } + case InstructionConstants.OP_SWAP: + { + boolean stackEntryPresent0 = isStackEntryNecessaryAfter(dupOffset, top - 0); + boolean stackEntryPresent1 = isStackEntryNecessaryAfter(dupOffset, top - 1); + + // Will either element be present? + if (stackEntryPresent0 || + stackEntryPresent1) + { + // Will both elements be present? + if (stackEntryPresent0 && + stackEntryPresent1) + { + newOpcode = InstructionConstants.OP_SWAP; + } + } + break; + } + } + + if (newOpcode == 0) + { + // Delete the instruction. + codeAttributeEditor.deleteInstruction(dupOffset); + + if (extraDeletedInstructionVisitor != null) + { + extraDeletedInstructionVisitor.visitSimpleInstruction(null, null, null, dupOffset, null); + } + + if (DEBUG) System.out.println(" Marking but deleting instruction "+instruction.toString(dupOffset)); + } + else if (newOpcode == oldOpcode) + { + // Leave the instruction unchanged. + codeAttributeEditor.undeleteInstruction(dupOffset); + + if (DEBUG) System.out.println(" Marking unchanged instruction "+instruction.toString(dupOffset)); + } + else + { + // Replace the instruction. + Instruction replacementInstruction = new SimpleInstruction(newOpcode); + codeAttributeEditor.replaceInstruction(dupOffset, + replacementInstruction); + + if (DEBUG) System.out.println(" Replacing instruction "+instruction.toString(dupOffset)+" by "+replacementInstruction.toString()); + } + } + + + /** + * Pushes a specified type of stack entry before or at the given offset. + * The instruction is marked as necessary. + */ + private void insertPushInstructions(int offset, + boolean replace, + int computationalType) + { + // Mark this instruction. + markInstruction(offset); + + // Create a simple push instrucion. + Instruction replacementInstruction = + new SimpleInstruction(pushOpcode(computationalType)); + + if (DEBUG) System.out.println(": "+replacementInstruction.toString(offset)); + + // Replace or insert the push instruction. + if (replace) + { + // Replace the push instruction. + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + } + else + { + // Insert the push instruction. + codeAttributeEditor.insertBeforeInstruction(offset, replacementInstruction); + + if (extraAddedInstructionVisitor != null) + { + replacementInstruction.accept(null, null, null, offset, extraAddedInstructionVisitor); + } + } + } + + + /** + * Returns the opcode of a push instruction corresponding to the given + * computational type. + * @param computationalType the computational type to be pushed on the stack. + */ + private byte pushOpcode(int computationalType) + { + switch (computationalType) + { + case Value.TYPE_INTEGER: return InstructionConstants.OP_ICONST_0; + case Value.TYPE_LONG: return InstructionConstants.OP_LCONST_0; + case Value.TYPE_FLOAT: return InstructionConstants.OP_FCONST_0; + case Value.TYPE_DOUBLE: return InstructionConstants.OP_DCONST_0; + case Value.TYPE_REFERENCE: + case Value.TYPE_INSTRUCTION_OFFSET: return InstructionConstants.OP_ACONST_NULL; + } + + throw new IllegalArgumentException("No push opcode for computational type ["+computationalType+"]"); + } + + + /** + * Pops the given number of stack entries at or after the given offset. + * The instructions are marked as necessary. + */ + private void insertPopInstructions(int offset, boolean replace, int popCount) + { + // Mark this instruction. + markInstruction(offset); + + switch (popCount) + { + case 1: + { + // Replace or insert a single pop instruction. + Instruction popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP); + + if (replace) + { + codeAttributeEditor.replaceInstruction(offset, popInstruction); + } + else + { + codeAttributeEditor.insertAfterInstruction(offset, popInstruction); + + if (extraAddedInstructionVisitor != null) + { + popInstruction.accept(null, null, null, offset, extraAddedInstructionVisitor); + } + } + break; + } + case 2: + { + // Replace or insert a single pop2 instruction. + Instruction popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP2); + + if (replace) + { + codeAttributeEditor.replaceInstruction(offset, popInstruction); + } + else + { + codeAttributeEditor.insertAfterInstruction(offset, popInstruction); + + if (extraAddedInstructionVisitor != null) + { + popInstruction.accept(null, null, null, offset, extraAddedInstructionVisitor); + } + } + break; + } + default: + { + // Replace or insert the specified number of pop instructions. + Instruction[] popInstructions = + new Instruction[popCount / 2 + popCount % 2]; + + Instruction popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP2); + + for (int index = 0; index < popCount / 2; index++) + { + popInstructions[index] = popInstruction; + } + + if (popCount % 2 == 1) + { + popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP); + + popInstructions[popCount / 2] = popInstruction; + } + + if (replace) + { + codeAttributeEditor.replaceInstruction(offset, popInstructions); + + for (int index = 1; index < popInstructions.length; index++) + { + if (extraAddedInstructionVisitor != null) + { + popInstructions[index].accept(null, null, null, offset, extraAddedInstructionVisitor); + } + } + } + else + { + codeAttributeEditor.insertAfterInstruction(offset, popInstructions); + + for (int index = 0; index < popInstructions.length; index++) + { + if (extraAddedInstructionVisitor != null) + { + popInstructions[index].accept(null, null, null, offset, extraAddedInstructionVisitor); + } + } + } + break; + } + } + } + + + /** + * Replaces the instruction at a given offset by a static invocation. + */ + private void replaceByStaticInvocation(Clazz clazz, + int offset, + ConstantInstruction constantInstruction) + { + // Remember the replacement instruction. + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_INVOKESTATIC, + constantInstruction.constantIndex).shrink(); + + if (DEBUG) System.out.println(" Replacing by static invocation "+constantInstruction.toString(offset)+" -> "+replacementInstruction.toString()); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + } + + + /** + * Replaces the given instruction by an infinite loop. + */ + private void replaceByInfiniteLoop(Clazz clazz, + int offset) + { + if (DEBUG) System.out.println(" Inserting infinite loop at ["+offset+"]"); + + // Mark the instruction. + markInstruction(offset); + + // Replace the instruction by an infinite loop. + Instruction replacementInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO, 0); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + } + + + // Small utility methods. + + /** + * Returns whether the given instruction is a dup or swap instruction + * (dup, dup_x1, dup_x2, dup2, dup2_x1, dup2_x2, swap). + */ + private boolean isDupOrSwap(Instruction instruction) + { + return instruction.opcode >= InstructionConstants.OP_DUP && + instruction.opcode <= InstructionConstants.OP_SWAP; + } + + + /** + * Returns whether the given instruction is a pop instruction + * (pop, pop2). + */ + private boolean isPop(Instruction instruction) + { + return instruction.opcode == InstructionConstants.OP_POP || + instruction.opcode == InstructionConstants.OP_POP2; + } + + + /** + * Returns whether any traced but unnecessary instruction between the two + * given offsets is branching over the second given offset. + */ + private boolean isAnyUnnecessaryInstructionBranchingOver(int instructionOffset1, + int instructionOffset2) + { + for (int offset = instructionOffset1; offset < instructionOffset2; offset++) + { + // Is it a traced but unmarked straddling branch? + if (partialEvaluator.isTraced(offset) && + !isInstructionNecessary(offset) && + isAnyLargerThan(partialEvaluator.branchTargets(offset), + instructionOffset2)) + { + return true; + } + } + + return false; + } + + + /** + * Returns whether all of the given instruction offsets (at least one) + * are smaller than or equal to the given offset. + */ + private boolean isAllSmallerThanOrEqual(InstructionOffsetValue instructionOffsets, + int instructionOffset) + { + if (instructionOffsets != null) + { + // Loop over all instruction offsets. + int branchCount = instructionOffsets.instructionOffsetCount(); + if (branchCount > 0) + { + for (int branchIndex = 0; branchIndex < branchCount; branchIndex++) + { + // Is the offset larger than the reference offset? + if (instructionOffsets.instructionOffset(branchIndex) > instructionOffset) + { + return false; + } + } + + return true; + } + } + + return false; + } + + + /** + * Returns whether any of the given instruction offsets (at least one) + * is larger than the given offset. + */ + private boolean isAnyLargerThan(InstructionOffsetValue instructionOffsets, + int instructionOffset) + { + if (instructionOffsets != null) + { + // Loop over all instruction offsets. + int branchCount = instructionOffsets.instructionOffsetCount(); + if (branchCount > 0) + { + for (int branchIndex = 0; branchIndex < branchCount; branchIndex++) + { + // Is the offset larger than the reference offset? + if (instructionOffsets.instructionOffset(branchIndex) > instructionOffset) + { + return true; + } + } + } + } + + return false; + } + + + /** + * Initializes the necessary data structure. + */ + private void initializeNecessary(CodeAttribute codeAttribute) + { + int codeLength = codeAttribute.u4codeLength; + int maxLocals = codeAttribute.u2maxLocals; + int maxStack = codeAttribute.u2maxStack; + + // Create new arrays for storing information at each instruction offset. + if (variablesNecessaryAfter.length < codeLength || + variablesNecessaryAfter[0].length < maxLocals) + { + variablesNecessaryAfter = new boolean[codeLength][maxLocals]; + } + else + { + for (int offset = 0; offset < codeLength; offset++) + { + for (int index = 0; index < maxLocals; index++) + { + variablesNecessaryAfter[offset][index] = false; + } + } + } + + if (stacksNecessaryAfter.length < codeLength || + stacksNecessaryAfter[0].length < maxStack) + { + stacksNecessaryAfter = new boolean[codeLength][maxStack]; + } + else + { + for (int offset = 0; offset < codeLength; offset++) + { + for (int index = 0; index < maxStack; index++) + { + stacksNecessaryAfter[offset][index] = false; + } + } + } + + if (stacksSimplifiedBefore.length < codeLength || + stacksSimplifiedBefore[0].length < maxStack) + { + stacksSimplifiedBefore = new boolean[codeLength][maxStack]; + } + else + { + for (int offset = 0; offset < codeLength; offset++) + { + for (int index = 0; index < maxStack; index++) + { + stacksSimplifiedBefore[offset][index] = false; + } + } + } + + if (instructionsNecessary.length < codeLength) + { + instructionsNecessary = new boolean[codeLength]; + } + else + { + for (int index = 0; index < codeLength; index++) + { + instructionsNecessary[index] = false; + } + } + } + + + /** + * Returns whether the given stack entry is present after execution of the + * instruction at the given offset. + */ + private boolean isStackEntriesNecessaryAfter(int instructionOffset, + int stackIndex1, + int stackIndex2) + { + boolean present1 = isStackEntryNecessaryAfter(instructionOffset, stackIndex1); + boolean present2 = isStackEntryNecessaryAfter(instructionOffset, stackIndex2); + +// if (present1 ^ present2) +// { +// throw new UnsupportedOperationException("Can't handle partial use of dup2 instructions"); +// } + + return present1 || present2; + } + + + /** + * Returns whether the specified variable must be initialized at the + * specified offset, according to the verifier of the JVM. + */ + private boolean isVariableInitializationNecessary(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int initializationOffset, + int variableIndex) + { + int codeLength = codeAttribute.u4codeLength; + + // Is the variable necessary anywhere at all? + if (isVariableNecessaryAfterAny(0, codeLength, variableIndex)) + { + if (DEBUG) System.out.println("Simple partial evaluation for initialization of variable v"+variableIndex+" at ["+initializationOffset+"]"); + + // Lazily compute perform simple partial evaluation, the way the + // JVM preverifier would do it. + simplePartialEvaluator.visitCodeAttribute(clazz, method, codeAttribute); + + if (DEBUG) System.out.println("End of simple partial evaluation for initialization of variable v"+variableIndex+" at ["+initializationOffset+"]"); + + // Check if the variable is necessary elsewhere. + for (int offset = 0; offset < codeLength; offset++) + { + if (isInstructionNecessary(offset)) + { + Value producer = partialEvaluator.getVariablesBefore(offset).getProducerValue(variableIndex); + if (producer != null) + { + Value simpleProducer = simplePartialEvaluator.getVariablesBefore(offset).getProducerValue(variableIndex); + if (simpleProducer != null) + { + InstructionOffsetValue producerOffsets = + producer.instructionOffsetValue(); + InstructionOffsetValue simpleProducerOffsets = + simpleProducer.instructionOffsetValue(); + + // Does the sophisticated partial evaluation have fewer + // producers than the simple one? + // And does the simple partial evaluation point to an + // initialization of the variable? + if (producerOffsets.instructionOffsetCount() < + simpleProducerOffsets.instructionOffsetCount() && + isVariableNecessaryAfterAny(producerOffsets, variableIndex) && + simpleProducerOffsets.contains(initializationOffset)) + { + // Then the initialization is necessary. + return true; + } + } + } + } + } + } + + return false; + } + + + private void markVariableAfter(int instructionOffset, + int variableIndex) + { + if (!isVariableNecessaryAfter(instructionOffset, variableIndex)) + { + if (DEBUG) System.out.print("["+instructionOffset+".v"+variableIndex+"],"); + + variablesNecessaryAfter[instructionOffset][variableIndex] = true; + + if (maxMarkedOffset < instructionOffset) + { + maxMarkedOffset = instructionOffset; + } + } + } + + + /** + * Returns whether the specified variable is ever necessary after any + * instruction in the specified block. + */ + private boolean isVariableNecessaryAfterAny(int startOffset, + int endOffset, + int variableIndex) + { + for (int offset = startOffset; offset < endOffset; offset++) + { + if (isVariableNecessaryAfter(offset, variableIndex)) + { + return true; + } + } + + return false; + } + + + /** + * Returns whether the specified variable is ever necessary after any + * instruction in the specified set of instructions offsets. + */ + private boolean isVariableNecessaryAfterAny(InstructionOffsetValue instructionOffsetValue, + int variableIndex) + { + int count = instructionOffsetValue.instructionOffsetCount(); + + for (int index = 0; index < count; index++) + { + if (isVariableNecessaryAfter(instructionOffsetValue.instructionOffset(index), + variableIndex)) + { + return true; + } + } + + return false; + } + + + private boolean isVariableNecessaryAfter(int instructionOffset, + int variableIndex) + { + return instructionOffset == PartialEvaluator.AT_METHOD_ENTRY || + variablesNecessaryAfter[instructionOffset][variableIndex]; + } + + + private void markStackEntryAfter(int instructionOffset, + int stackIndex) + { + if (!isStackEntryNecessaryAfter(instructionOffset, stackIndex)) + { + if (DEBUG) System.out.print("["+instructionOffset+".s"+stackIndex+"],"); + + stacksNecessaryAfter[instructionOffset][stackIndex] = true; + + if (maxMarkedOffset < instructionOffset) + { + maxMarkedOffset = instructionOffset; + } + } + } + + + private boolean isAnyStackEntryNecessaryAfter(InstructionOffsetValue instructionOffsets, + int stackIndex) + { + int offsetCount = instructionOffsets.instructionOffsetCount(); + + for (int offsetIndex = 0; offsetIndex < offsetCount; offsetIndex++) + { + if (isStackEntryNecessaryAfter(instructionOffsets.instructionOffset(offsetIndex), stackIndex)) + { + return true; + } + } + + return false; + } + + + private boolean isStackEntryNecessaryAfter(int instructionOffset, + int stackIndex) + { + return instructionOffset == PartialEvaluator.AT_CATCH_ENTRY || + stacksNecessaryAfter[instructionOffset][stackIndex]; + } + + + private void markStackSimplificationBefore(int instructionOffset, + int stackIndex) + { + stacksSimplifiedBefore[instructionOffset][stackIndex] = true; + } + + + private boolean isStackSimplifiedBefore(int instructionOffset, + int stackIndex) + { + return stacksSimplifiedBefore[instructionOffset][stackIndex]; + } + + + private void markInstruction(int instructionOffset) + { + if (!isInstructionNecessary(instructionOffset)) + { + if (DEBUG) System.out.print(instructionOffset+","); + + instructionsNecessary[instructionOffset] = true; + + if (maxMarkedOffset < instructionOffset) + { + maxMarkedOffset = instructionOffset; + } + } + } + + + private boolean isAnyInstructionNecessary(int instructionOffset1, + int instructionOffset2) + { + for (int instructionOffset = instructionOffset1; + instructionOffset < instructionOffset2; + instructionOffset++) + { + if (isInstructionNecessary(instructionOffset)) + { + return true; + } + } + + return false; + } + + + /** + * Returns the highest offset of an instruction that has been marked as + * necessary, before the given offset. + */ + private int lastNecessaryInstructionOffset(int instructionOffset) + { + for (int offset = instructionOffset-1; offset >= 0; offset--) + { + if (isInstructionNecessary(instructionOffset)) + { + return offset; + } + } + + return 0; + } + + + private boolean isInstructionNecessary(int instructionOffset) + { + return instructionOffset == PartialEvaluator.AT_METHOD_ENTRY || + instructionsNecessary[instructionOffset]; + } +} \ No newline at end of file diff --git a/src/proguard/optimize/evaluation/EvaluationSimplifier.java b/src/proguard/optimize/evaluation/EvaluationSimplifier.java new file mode 100644 index 0000000..0c3a9c7 --- /dev/null +++ b/src/proguard/optimize/evaluation/EvaluationSimplifier.java @@ -0,0 +1,968 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.evaluation.*; +import proguard.evaluation.value.*; +import proguard.optimize.info.*; + +/** + * This AttributeVisitor simplifies the code attributes that it visits, based + * on partial evaluation. + * + * @author Eric Lafortune + */ +public class EvaluationSimplifier +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + private final InstructionVisitor extraInstructionVisitor; + + private final PartialEvaluator partialEvaluator; + private final SideEffectInstructionChecker sideEffectInstructionChecker = new SideEffectInstructionChecker(true); + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(false); + + + /** + * Creates a new EvaluationSimplifier. + */ + public EvaluationSimplifier() + { + this(new PartialEvaluator(), null); + } + + + /** + * Creates a new EvaluationSimplifier. + * @param partialEvaluator the partial evaluator that will + * execute the code and provide + * information about the results. + * @param extraInstructionVisitor an optional extra visitor for all + * simplified instructions. + */ + public EvaluationSimplifier(PartialEvaluator partialEvaluator, + InstructionVisitor extraInstructionVisitor) + { + this.partialEvaluator = partialEvaluator; + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the evaluation simplifier has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while simplifying instructions after partial evaluation:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + System.err.println("Not optimizing this method"); + + if (DEBUG) + { + method.accept(clazz, new ClassPrinter()); + + throw ex; + } + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (DEBUG) + { + System.out.println(); + System.out.println("Class "+ClassUtil.externalClassName(clazz.getName())); + System.out.println("Method "+ClassUtil.externalFullMethodDescription(clazz.getName(), + 0, + method.getName(clazz), + method.getDescriptor(clazz))); + } + + // Evaluate the method. + partialEvaluator.visitCodeAttribute(clazz, method, codeAttribute); + + int codeLength = codeAttribute.u4codeLength; + + // Reset the code changes. + codeAttributeEditor.reset(codeLength); + + // Replace any instructions that can be simplified. + for (int offset = 0; offset < codeLength; offset++) + { + if (partialEvaluator.isTraced(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + + instruction.accept(clazz, method, codeAttribute, offset, this); + } + } + + // Apply all accumulated changes to the code. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + switch (simpleInstruction.opcode) + { + case InstructionConstants.OP_IALOAD: + case InstructionConstants.OP_BALOAD: + case InstructionConstants.OP_CALOAD: + case InstructionConstants.OP_SALOAD: + case InstructionConstants.OP_IADD: + case InstructionConstants.OP_ISUB: + case InstructionConstants.OP_IMUL: + case InstructionConstants.OP_IDIV: + case InstructionConstants.OP_IREM: + case InstructionConstants.OP_INEG: + case InstructionConstants.OP_ISHL: + case InstructionConstants.OP_ISHR: + case InstructionConstants.OP_IUSHR: + case InstructionConstants.OP_IAND: + case InstructionConstants.OP_IOR: + case InstructionConstants.OP_IXOR: + case InstructionConstants.OP_L2I: + case InstructionConstants.OP_F2I: + case InstructionConstants.OP_D2I: + case InstructionConstants.OP_I2B: + case InstructionConstants.OP_I2C: + case InstructionConstants.OP_I2S: + replaceIntegerPushInstruction(clazz, offset, simpleInstruction); + break; + + case InstructionConstants.OP_LALOAD: + case InstructionConstants.OP_LADD: + case InstructionConstants.OP_LSUB: + case InstructionConstants.OP_LMUL: + case InstructionConstants.OP_LDIV: + case InstructionConstants.OP_LREM: + case InstructionConstants.OP_LNEG: + case InstructionConstants.OP_LSHL: + case InstructionConstants.OP_LSHR: + case InstructionConstants.OP_LUSHR: + case InstructionConstants.OP_LAND: + case InstructionConstants.OP_LOR: + case InstructionConstants.OP_LXOR: + case InstructionConstants.OP_I2L: + case InstructionConstants.OP_F2L: + case InstructionConstants.OP_D2L: + replaceLongPushInstruction(clazz, offset, simpleInstruction); + break; + + case InstructionConstants.OP_FALOAD: + case InstructionConstants.OP_FADD: + case InstructionConstants.OP_FSUB: + case InstructionConstants.OP_FMUL: + case InstructionConstants.OP_FDIV: + case InstructionConstants.OP_FREM: + case InstructionConstants.OP_FNEG: + case InstructionConstants.OP_I2F: + case InstructionConstants.OP_L2F: + case InstructionConstants.OP_D2F: + replaceFloatPushInstruction(clazz, offset, simpleInstruction); + break; + + case InstructionConstants.OP_DALOAD: + case InstructionConstants.OP_DADD: + case InstructionConstants.OP_DSUB: + case InstructionConstants.OP_DMUL: + case InstructionConstants.OP_DDIV: + case InstructionConstants.OP_DREM: + case InstructionConstants.OP_DNEG: + case InstructionConstants.OP_I2D: + case InstructionConstants.OP_L2D: + case InstructionConstants.OP_F2D: + replaceDoublePushInstruction(clazz, offset, simpleInstruction); + break; + + case InstructionConstants.OP_AALOAD: + replaceReferencePushInstruction(clazz, offset, simpleInstruction); + break; + } + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + int variableIndex = variableInstruction.variableIndex; + + switch (variableInstruction.opcode) + { + case InstructionConstants.OP_ILOAD: + case InstructionConstants.OP_ILOAD_0: + case InstructionConstants.OP_ILOAD_1: + case InstructionConstants.OP_ILOAD_2: + case InstructionConstants.OP_ILOAD_3: + replaceIntegerPushInstruction(clazz, offset, variableInstruction, variableIndex); + break; + + case InstructionConstants.OP_LLOAD: + case InstructionConstants.OP_LLOAD_0: + case InstructionConstants.OP_LLOAD_1: + case InstructionConstants.OP_LLOAD_2: + case InstructionConstants.OP_LLOAD_3: + replaceLongPushInstruction(clazz, offset, variableInstruction, variableIndex); + break; + + case InstructionConstants.OP_FLOAD: + case InstructionConstants.OP_FLOAD_0: + case InstructionConstants.OP_FLOAD_1: + case InstructionConstants.OP_FLOAD_2: + case InstructionConstants.OP_FLOAD_3: + replaceFloatPushInstruction(clazz, offset, variableInstruction, variableIndex); + break; + + case InstructionConstants.OP_DLOAD: + case InstructionConstants.OP_DLOAD_0: + case InstructionConstants.OP_DLOAD_1: + case InstructionConstants.OP_DLOAD_2: + case InstructionConstants.OP_DLOAD_3: + replaceDoublePushInstruction(clazz, offset, variableInstruction, variableIndex); + break; + + case InstructionConstants.OP_ALOAD: + case InstructionConstants.OP_ALOAD_0: + case InstructionConstants.OP_ALOAD_1: + case InstructionConstants.OP_ALOAD_2: + case InstructionConstants.OP_ALOAD_3: + replaceReferencePushInstruction(clazz, offset, variableInstruction); + break; + + case InstructionConstants.OP_ASTORE: + case InstructionConstants.OP_ASTORE_0: + case InstructionConstants.OP_ASTORE_1: + case InstructionConstants.OP_ASTORE_2: + case InstructionConstants.OP_ASTORE_3: + deleteReferencePopInstruction(clazz, offset, variableInstruction); + break; + + case InstructionConstants.OP_RET: + replaceBranchInstruction(clazz, offset, variableInstruction); + break; + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + switch (constantInstruction.opcode) + { + case InstructionConstants.OP_GETSTATIC: + case InstructionConstants.OP_GETFIELD: + replaceAnyPushInstruction(clazz, offset, constantInstruction); + break; + + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + if (constantInstruction.stackPushCount(clazz) > 0 && + !sideEffectInstructionChecker.hasSideEffects(clazz, + method, + codeAttribute, + offset, + constantInstruction)) + { + replaceAnyPushInstruction(clazz, offset, constantInstruction); + } + + break; + + case InstructionConstants.OP_CHECKCAST: + replaceReferencePushInstruction(clazz, offset, constantInstruction); + break; + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + switch (branchInstruction.opcode) + { + case InstructionConstants.OP_GOTO: + case InstructionConstants.OP_GOTO_W: + // Don't replace unconditional branches. + break; + + case InstructionConstants.OP_JSR: + case InstructionConstants.OP_JSR_W: + replaceJsrInstruction(clazz, offset, branchInstruction); + break; + + default: + replaceBranchInstruction(clazz, offset, branchInstruction); + break; + } + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + // First try to simplify it to a simple branch. + replaceBranchInstruction(clazz, offset, switchInstruction); + + // Otherwise make sure all branch targets are valid. + if (!codeAttributeEditor.isModified(offset)) + { + replaceSwitchInstruction(clazz, offset, switchInstruction); + } + } + + + // Small utility methods. + + /** + * Replaces the push instruction at the given offset by a simpler push + * instruction, if possible. + */ + private void replaceAnyPushInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + Value pushedValue = partialEvaluator.getStackAfter(offset).getTop(0); + if (pushedValue.isParticular()) + { + switch (pushedValue.computationalType()) + { + case Value.TYPE_INTEGER: + replaceIntegerPushInstruction(clazz, offset, instruction); + break; + case Value.TYPE_LONG: + replaceLongPushInstruction(clazz, offset, instruction); + break; + case Value.TYPE_FLOAT: + replaceFloatPushInstruction(clazz, offset, instruction); + break; + case Value.TYPE_DOUBLE: + replaceDoublePushInstruction(clazz, offset, instruction); + break; + case Value.TYPE_REFERENCE: + replaceReferencePushInstruction(clazz, offset, instruction); + break; + } + } + } + + + /** + * Replaces the integer pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceIntegerPushInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + replaceIntegerPushInstruction(clazz, + offset, + instruction, + partialEvaluator.getVariablesBefore(offset).size()); + } + + + /** + * Replaces the integer pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceIntegerPushInstruction(Clazz clazz, + int offset, + Instruction instruction, + int maxVariableIndex) + { + Value pushedValue = partialEvaluator.getStackAfter(offset).getTop(0); + if (pushedValue.isParticular()) + { + int value = pushedValue.integerValue().value(); + if (value << 16 >> 16 == value) + { + replaceConstantPushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_SIPUSH, + value); + } + else + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor((ProgramClass)clazz); + + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_LDC, + constantPoolEditor.addIntegerConstant(value)).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + } + else if (pushedValue.isSpecific()) + { + TracedVariables variables = partialEvaluator.getVariablesBefore(offset); + for (int variableIndex = 0; variableIndex < maxVariableIndex; variableIndex++) + { + if (pushedValue.equals(variables.load(variableIndex))) + { + replaceVariablePushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_ILOAD, + variableIndex); + } + } + } + } + + + /** + * Replaces the long pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceLongPushInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + replaceLongPushInstruction(clazz, + offset, + instruction, + partialEvaluator.getVariablesBefore(offset).size()); + } + + + /** + * Replaces the long pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceLongPushInstruction(Clazz clazz, + int offset, + Instruction instruction, + int maxVariableIndex) + { + Value pushedValue = partialEvaluator.getStackAfter(offset).getTop(0); + if (pushedValue.isParticular()) + { + long value = pushedValue.longValue().value(); + if (value == 0L || + value == 1L) + { + replaceConstantPushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_LCONST_0, + (int)value); + } + else + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor((ProgramClass)clazz); + + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_LDC2_W, + constantPoolEditor.addLongConstant(value)).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + } + else if (pushedValue.isSpecific()) + { + TracedVariables variables = partialEvaluator.getVariablesBefore(offset); + for (int variableIndex = 0; variableIndex < maxVariableIndex; variableIndex++) + { + if (pushedValue.equals(variables.load(variableIndex))) + { + replaceVariablePushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_LLOAD, + variableIndex); + } + } + } + } + + + /** + * Replaces the float pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceFloatPushInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + replaceFloatPushInstruction(clazz, + offset, + instruction, + partialEvaluator.getVariablesBefore(offset).size()); + } + + + /** + * Replaces the float pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceFloatPushInstruction(Clazz clazz, + int offset, + Instruction instruction, + int maxVariableIndex) + { + Value pushedValue = partialEvaluator.getStackAfter(offset).getTop(0); + if (pushedValue.isParticular()) + { + float value = pushedValue.floatValue().value(); + if (value == 0f || + value == 1f || + value == 2f) + { + replaceConstantPushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_FCONST_0, + (int)value); + } + else + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor((ProgramClass)clazz); + + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_LDC, + constantPoolEditor.addFloatConstant(value)).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + } + else if (pushedValue.isSpecific()) + { + TracedVariables variables = partialEvaluator.getVariablesBefore(offset); + for (int variableIndex = 0; variableIndex < maxVariableIndex; variableIndex++) + { + if (pushedValue.equals(variables.load(variableIndex))) + { + replaceVariablePushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_FLOAD, + variableIndex); + } + } + } + } + + + /** + * Replaces the double pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceDoublePushInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + replaceDoublePushInstruction(clazz, + offset, + instruction, + partialEvaluator.getVariablesBefore(offset).size()); + } + + + /** + * Replaces the double pushing instruction at the given offset by a simpler + * push instruction, if possible. + */ + private void replaceDoublePushInstruction(Clazz clazz, + int offset, + Instruction instruction, + int maxVariableIndex) + { + Value pushedValue = partialEvaluator.getStackAfter(offset).getTop(0); + if (pushedValue.isParticular()) + { + double value = pushedValue.doubleValue().value(); + if (value == 0.0 || + value == 1.0) + { + replaceConstantPushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_DCONST_0, + (int)value); + } + else + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor((ProgramClass)clazz); + + Instruction replacementInstruction = + new ConstantInstruction(InstructionConstants.OP_LDC2_W, + constantPoolEditor.addDoubleConstant(value)).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + } + else if (pushedValue.isSpecific()) + { + TracedVariables variables = partialEvaluator.getVariablesBefore(offset); + for (int variableIndex = 0; variableIndex < maxVariableIndex; variableIndex++) + { + if (pushedValue.equals(variables.load(variableIndex))) + { + replaceVariablePushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_DLOAD, + variableIndex); + } + } + } + } + + + /** + * Replaces the reference pushing instruction at the given offset by a + * simpler push instruction, if possible. + */ + private void replaceReferencePushInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + Value pushedValue = partialEvaluator.getStackAfter(offset).getTop(0); + if (pushedValue.isParticular()) + { + // A reference value can only be specific if it is null. + replaceConstantPushInstruction(clazz, + offset, + instruction, + InstructionConstants.OP_ACONST_NULL, + 0); + } + } + + + /** + * Replaces the instruction at a given offset by a given push instruction + * of a constant. + */ + private void replaceConstantPushInstruction(Clazz clazz, + int offset, + Instruction instruction, + byte replacementOpcode, + int value) + { + Instruction replacementInstruction = + new SimpleInstruction(replacementOpcode, value).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + + + /** + * Replaces the instruction at a given offset by a given push instruction + * of a variable. + */ + private void replaceVariablePushInstruction(Clazz clazz, + int offset, + Instruction instruction, + byte replacementOpcode, + int variableIndex) + { + Instruction replacementInstruction = + new VariableInstruction(replacementOpcode, variableIndex).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + + + /** + * Replaces the given 'jsr' instruction by a simpler branch instruction, + * if it jumps to a subroutine that doesn't return or a subroutine that + * is only called from one place. + */ + private void replaceJsrInstruction(Clazz clazz, + int offset, + BranchInstruction branchInstruction) + { + // Is the subroutine ever returning? + int subroutineStart = offset + branchInstruction.branchOffset; + if (!partialEvaluator.isSubroutineReturning(subroutineStart) || + partialEvaluator.branchOrigins(subroutineStart).instructionOffsetCount() == 1) + { + // All 'jsr' instructions to this subroutine can be replaced + // by unconditional branch instructions. + replaceBranchInstruction(clazz, offset, branchInstruction); + } + else if (!partialEvaluator.isTraced(offset + branchInstruction.length(offset))) + { + // We have to make sure the instruction after this 'jsr' + // instruction is valid, even if it is never reached. + replaceByInfiniteLoop(clazz, offset + branchInstruction.length(offset), branchInstruction); + } + } + + + /** + * Deletes the reference popping instruction at the given offset, if + * it is at the start of a subroutine that doesn't return or a subroutine + * that is only called from one place. + */ + private void deleteReferencePopInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + if (partialEvaluator.isSubroutineStart(offset) && + (!partialEvaluator.isSubroutineReturning(offset) || + partialEvaluator.branchOrigins(offset).instructionOffsetCount() == 1)) + { + if (DEBUG) System.out.println(" Deleting store of subroutine return address "+instruction.toString(offset)); + + // A reference value can only be specific if it is null. + codeAttributeEditor.deleteInstruction(offset); + } + } + + + /** + * Deletes the given branch instruction, or replaces it by a simpler branch + * instruction, if possible. + */ + private void replaceBranchInstruction(Clazz clazz, + int offset, + Instruction instruction) + { + InstructionOffsetValue branchTargets = partialEvaluator.branchTargets(offset); + + // Is there exactly one branch target (not from a goto or jsr)? + if (branchTargets != null && + branchTargets.instructionOffsetCount() == 1) + { + // Is it branching to the next instruction? + int branchOffset = branchTargets.instructionOffset(0) - offset; + if (branchOffset == instruction.length(offset)) + { + if (DEBUG) System.out.println(" Ignoring zero branch instruction at ["+offset+"]"); + } + else + { + // Replace the branch instruction by a simple branch instruction. + Instruction replacementInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO_W, + branchOffset).shrink(); + + replaceInstruction(clazz, offset, instruction, replacementInstruction); + } + } + } + + + /** + * Makes sure all branch targets of the given switch instruction are valid. + */ + private void replaceSwitchInstruction(Clazz clazz, + int offset, + SwitchInstruction switchInstruction) + { + // Get the actual branch targets. + InstructionOffsetValue branchTargets = partialEvaluator.branchTargets(offset); + + // Get an offset that can serve as a valid default offset. + int defaultOffset = + branchTargets.instructionOffset(branchTargets.instructionOffsetCount()-1) - + offset; + + Instruction replacementInstruction = null; + + // Check the jump offsets. + int[] jumpOffsets = switchInstruction.jumpOffsets; + for (int index = 0; index < jumpOffsets.length; index++) + { + if (!branchTargets.contains(offset + jumpOffsets[index])) + { + // Replace the unused offset. + jumpOffsets[index] = defaultOffset; + + // Remember to replace the instruction. + replacementInstruction = switchInstruction; + } + } + + // Check the default offset. + if (!branchTargets.contains(offset + switchInstruction.defaultOffset)) + { + // Replace the unused offset. + switchInstruction.defaultOffset = defaultOffset; + + // Remember to replace the instruction. + replacementInstruction = switchInstruction; + } + + if (replacementInstruction != null) + { + replaceInstruction(clazz, offset, switchInstruction, replacementInstruction); + } + } + + + /** + * Replaces the given instruction by an infinite loop. + */ + private void replaceByInfiniteLoop(Clazz clazz, + int offset, + Instruction instruction) + { + // Replace the instruction by an infinite loop. + Instruction replacementInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO, 0); + + if (DEBUG) System.out.println(" Replacing unreachable instruction by infinite loop "+replacementInstruction.toString(offset)); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + // Note: we're not passing the right arguments for now, knowing that + // they aren't used anyway. + instruction.accept(clazz, null, null, offset, extraInstructionVisitor); + } + } + + + /** + * Replaces the instruction at a given offset by a given push instruction. + */ + private void replaceInstruction(Clazz clazz, + int offset, + Instruction instruction, + Instruction replacementInstruction) + { + // Pop unneeded stack entries if necessary. + int popCount = + instruction.stackPopCount(clazz) - + replacementInstruction.stackPopCount(clazz); + + insertPopInstructions(offset, popCount); + + if (DEBUG) System.out.println(" Replacing instruction "+instruction.toString(offset)+" -> "+replacementInstruction.toString()+(popCount == 0 ? "" : " ("+popCount+" pops)")); + + codeAttributeEditor.replaceInstruction(offset, replacementInstruction); + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + // Note: we're not passing the right arguments for now, knowing that + // they aren't used anyway. + instruction.accept(clazz, null, null, offset, extraInstructionVisitor); + } + } + + + /** + * Pops the given number of stack entries before the instruction at the + * given offset. + */ + private void insertPopInstructions(int offset, int popCount) + { + switch (popCount) + { + case 0: + { + break; + } + case 1: + { + // Insert a single pop instruction. + Instruction popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP); + + codeAttributeEditor.insertBeforeInstruction(offset, + popInstruction); + break; + } + case 2: + { + // Insert a single pop2 instruction. + Instruction popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP2); + + codeAttributeEditor.insertBeforeInstruction(offset, + popInstruction); + break; + } + default: + { + // Insert the specified number of pop instructions. + Instruction[] popInstructions = + new Instruction[popCount / 2 + popCount % 2]; + + Instruction popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP2); + + for (int index = 0; index < popCount / 2; index++) + { + popInstructions[index] = popInstruction; + } + + if (popCount % 2 == 1) + { + popInstruction = + new SimpleInstruction(InstructionConstants.OP_POP); + + popInstructions[popCount / 2] = popInstruction; + } + + codeAttributeEditor.insertBeforeInstruction(offset, + popInstructions); + break; + } + } + } +} diff --git a/src/proguard/optimize/evaluation/LivenessAnalyzer.java b/src/proguard/optimize/evaluation/LivenessAnalyzer.java new file mode 100644 index 0000000..9915027 --- /dev/null +++ b/src/proguard/optimize/evaluation/LivenessAnalyzer.java @@ -0,0 +1,516 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.evaluation.value.*; + +/** + * This AttributeVisitor analyzes the liveness of the variables in the code + * attributes that it visits, based on partial evaluation. + * + * @author Eric Lafortune + */ +public class LivenessAnalyzer +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + private static final int MAX_VARIABLES_SIZE = 64; + + private final PartialEvaluator partialEvaluator; + + private long[] isAliveBefore = new long[ClassConstants.TYPICAL_CODE_LENGTH]; + private long[] isAliveAfter = new long[ClassConstants.TYPICAL_CODE_LENGTH]; + private long[] isCategory2 = new long[ClassConstants.TYPICAL_CODE_LENGTH]; + + // Fields acting as global temporary variables. + private boolean checkAgain; + private long alive; + + + /** + * Creates a new LivenessAnalyzer. + */ + public LivenessAnalyzer() + { + this(new PartialEvaluator()); + } + + + /** + * Creates a new LivenessAnalyzer that will use the given partial evaluator. + * It will run this evaluator on every code attribute that it visits. + */ + public LivenessAnalyzer(PartialEvaluator partialEvaluator) + { + this.partialEvaluator = partialEvaluator; + } + + + /** + * Returns whether the specified variable is alive before the instruction + * at the given offset. + */ + public boolean isAliveBefore(int instructionOffset, int variableIndex) + { + return variableIndex >= MAX_VARIABLES_SIZE || + (isAliveBefore[instructionOffset] & (1L << variableIndex)) != 0; + } + + + /** + * Sets whether the specified variable is alive before the instruction + * at the given offset. + */ + public void setAliveBefore(int instructionOffset, int variableIndex, boolean alive) + { + if (variableIndex < MAX_VARIABLES_SIZE) + { + if (alive) + { + isAliveBefore[instructionOffset] |= 1L << variableIndex; + } + else + { + isAliveBefore[instructionOffset] &= ~(1L << variableIndex); + } + } + } + + + /** + * Returns whether the specified variable is alive after the instruction + * at the given offset. + */ + public boolean isAliveAfter(int instructionOffset, int variableIndex) + { + return variableIndex >= MAX_VARIABLES_SIZE || + (isAliveAfter[instructionOffset] & (1L << variableIndex)) != 0; + } + + + /** + * Sets whether the specified variable is alive after the instruction + * at the given offset. + */ + public void setAliveAfter(int instructionOffset, int variableIndex, boolean alive) + { + if (variableIndex < MAX_VARIABLES_SIZE) + { + if (alive) + { + isAliveAfter[instructionOffset] |= 1L << variableIndex; + } + else + { + isAliveAfter[instructionOffset] &= ~(1L << variableIndex); + } + } + } + + + /** + * Returns whether the specified variable takes up two entries after the + * instruction at the given offset. + */ + public boolean isCategory2(int instructionOffset, int variableIndex) + { + return variableIndex < MAX_VARIABLES_SIZE && + (isCategory2[instructionOffset] & (1L << variableIndex)) != 0; + } + + + /** + * Sets whether the specified variable takes up two entries after the + * instruction at the given offset. + */ + public void setCategory2(int instructionOffset, int variableIndex, boolean category2) + { + if (variableIndex < MAX_VARIABLES_SIZE) + { + if (category2) + { + isCategory2[instructionOffset] |= 1L << variableIndex; + } + else + { + isCategory2[instructionOffset] &= ~(1L << variableIndex); + } + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + if (DEBUG) + { + System.out.println(); + System.out.println("Liveness analysis: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + } + + // Initialize the global arrays. + initializeArrays(codeAttribute); + + // Evaluate the method. + partialEvaluator.visitCodeAttribute(clazz, method, codeAttribute); + + int codeLength = codeAttribute.u4codeLength; + int variablesSize = codeAttribute.u2maxLocals; + + // We'll only really analyze the first 64 variables. + if (variablesSize > MAX_VARIABLES_SIZE) + { + variablesSize = MAX_VARIABLES_SIZE; + } + + // Mark liveness blocks, as many times as necessary. + do + { + checkAgain = false; + alive = 0L; + + // Loop over all traced instructions, backward. + for (int offset = codeLength - 1; offset >= 0; offset--) + { + if (partialEvaluator.isTraced(offset)) + { + // Update the liveness based on the branch targets. + InstructionOffsetValue branchTargets = partialEvaluator.branchTargets(offset); + if (branchTargets != null) + { + // Update the liveness right after the branch instruction. + alive = combinedLiveness(branchTargets); + } + + // Merge the current liveness. + alive |= isAliveAfter[offset]; + + // Update the liveness after the instruction. + isAliveAfter[offset] = alive; + + // Update the current liveness based on the instruction. + codeAttribute.instructionAccept(clazz, method, offset, this); + + // Merge the current liveness. + alive |= isAliveBefore[offset]; + + // Update the liveness before the instruction. + if ((~isAliveBefore[offset] & alive) != 0L) + { + isAliveBefore[offset] = alive; + + // Do we have to check again after this loop? + checkAgain |= offset < maxOffset(partialEvaluator.branchOrigins(offset)); + } + } + } + + // Account for the liveness at the start of the exception handlers. + codeAttribute.exceptionsAccept(clazz, method, this); + } + while (checkAgain); + + // Loop over all instructions, to mark variables that take up two entries. + for (int offset = 0; offset < codeLength; offset++) + { + if (partialEvaluator.isTraced(offset)) + { + // Loop over all variables. + for (int variableIndex = 0; variableIndex < variablesSize; variableIndex++) + { + // Is the variable alive and a category 2 type? + if (isAliveBefore(offset, variableIndex)) + { + Value value = partialEvaluator.getVariablesBefore(offset).getValue(variableIndex); + if (value != null && value.isCategory2()) + { + // Mark it as such. + setCategory2(offset, variableIndex, true); + + // Mark the next variable as well. + setAliveBefore(offset, variableIndex + 1, true); + setCategory2( offset, variableIndex + 1, true); + } + } + + // Is the variable alive and a category 2 type? + if (isAliveAfter(offset, variableIndex)) + { + Value value = partialEvaluator.getVariablesAfter(offset).getValue(variableIndex); + if (value != null && value.isCategory2()) + { + // Mark it as such. + setCategory2(offset, variableIndex, true); + + // Mark the next variable as well. + setAliveAfter(offset, variableIndex + 1, true); + setCategory2( offset, variableIndex + 1, true); + } + } + } + } + } + + if (DEBUG) + { + // Loop over all instructions. + for (int offset = 0; offset < codeLength; offset++) + { + if (partialEvaluator.isTraced(offset)) + { + long aliveBefore = isAliveBefore[offset]; + long aliveAfter = isAliveAfter[offset]; + long category2 = isCategory2[offset]; + + // Print out the liveness of all variables before the instruction. + for (int variableIndex = 0; variableIndex < variablesSize; variableIndex++) + { + long variableMask = (1L << variableIndex); + System.out.print((aliveBefore & variableMask) == 0L ? '.' : + (category2 & variableMask) == 0L ? 'x' : + '*'); + } + + // Print out the instruction itself. + System.out.println(" "+ InstructionFactory.create(codeAttribute.code, offset).toString(offset)); + + // Print out the liveness of all variables after the instruction. + for (int variableIndex = 0; variableIndex < variablesSize; variableIndex++) + { + long variableMask = (1L << variableIndex); + System.out.print((aliveAfter & variableMask) == 0L ? '.' : + (category2 & variableMask) == 0L ? 'x' : + '='); + } + + System.out.println(); + } + } + } + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + int variableIndex = variableInstruction.variableIndex; + if (variableIndex < MAX_VARIABLES_SIZE) + { + long livenessMask = 1L << variableIndex; + + // Is it a load instruction or a store instruction? + if (variableInstruction.isLoad()) + { + // Start marking the variable before the load instruction. + alive |= livenessMask; + } + else + { + // Stop marking the variable before the store instruction. + alive &= ~livenessMask; + + // But do mark the variable right after the store instruction. + isAliveAfter[offset] |= livenessMask; + } + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Special case: variable 0 ('this') in an initializer has to be alive + // as long as it hasn't been initialized. + if (offset == partialEvaluator.superInitializationOffset()) + { + alive |= 1L; + } + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + // Are any variables alive at the start of the handler? + long alive = isAliveBefore[exceptionInfo.u2handlerPC]; + if (alive != 0L) + { + // Set the same liveness flags for the entire try block. + int startOffset = exceptionInfo.u2startPC; + int endOffset = exceptionInfo.u2endPC; + + for (int offset = startOffset; offset < endOffset; offset++) + { + if (partialEvaluator.isTraced(offset)) + { + if ((~(isAliveBefore[offset] & isAliveAfter[offset]) & alive) != 0L) + { + isAliveBefore[offset] |= alive; + isAliveAfter[offset] |= alive; + + // Check again after having marked this try block. + checkAgain = true; + } + } + } + } + } + + + // Small utility methods. + + /** + * Initializes the global arrays. + */ + private void initializeArrays(CodeAttribute codeAttribute) + { + int codeLength = codeAttribute.u4codeLength; + + // Create new arrays for storing information at each instruction offset. + if (isAliveBefore.length < codeLength) + { + isAliveBefore = new long[codeLength]; + isAliveAfter = new long[codeLength]; + isCategory2 = new long[codeLength]; + } + else + { + for (int index = 0; index < codeLength; index++) + { + isAliveBefore[index] = 0L; + isAliveAfter[index] = 0L; + isCategory2[index] = 0L; + } + } + } + + + /** + * Returns the combined liveness mask of the variables right before the + * specified instruction offsets. + */ + private long combinedLiveness(InstructionOffsetValue instructionOffsetValue) + { + long alive = 0L; + + int count = instructionOffsetValue.instructionOffsetCount(); + for (int index = 0; index < count; index++) + { + alive |= isAliveBefore[instructionOffsetValue.instructionOffset(index)]; + } + + return alive; + } + + + /** + * Returns the minimum offset from the given instruction offsets. + */ + private int minOffset(Value instructionOffsets) + { + return minOffset(instructionOffsets, Integer.MAX_VALUE); + } + + + /** + * Returns the minimum offset from the given instruction offsets. + */ + private int minOffset(Value instructionOffsets, int minOffset) + { + if (instructionOffsets != null) + { + InstructionOffsetValue instructionOffsetValue = + instructionOffsets.instructionOffsetValue(); + + int count = instructionOffsetValue.instructionOffsetCount(); + for (int index = 0; index < count; index++) + { + int offset = instructionOffsetValue.instructionOffset(index); + if (minOffset > offset) + { + minOffset = offset; + } + } + } + + return minOffset; + } + + + /** + * Returns the maximum offset from the given instruction offsets. + */ + private int maxOffset(Value instructionOffsets) + { + return maxOffset(instructionOffsets, Integer.MIN_VALUE); + } + + + /** + * Returns the maximum offset from the given instruction offsets. + */ + private int maxOffset(Value instructionOffsets, int maxOffset) + { + if (instructionOffsets != null) + { + InstructionOffsetValue instructionOffsetValue = + instructionOffsets.instructionOffsetValue(); + + int count = instructionOffsetValue.instructionOffsetCount(); + for (int index = 0; index < count; index++) + { + int offset = instructionOffsetValue.instructionOffset(index); + if (maxOffset < offset) + { + maxOffset = offset; + } + } + } + + return maxOffset; + } +} diff --git a/src/proguard/optimize/evaluation/LoadingInvocationUnit.java b/src/proguard/optimize/evaluation/LoadingInvocationUnit.java new file mode 100644 index 0000000..8379c57 --- /dev/null +++ b/src/proguard/optimize/evaluation/LoadingInvocationUnit.java @@ -0,0 +1,203 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.constant.RefConstant; +import proguard.evaluation.BasicInvocationUnit; +import proguard.evaluation.value.*; + +/** + * This InvocationUbit loads parameter values and return values that were + * previously stored with the methods that are invoked. + * + * @see StoringInvocationUnit + * @author Eric Lafortune + */ +public class LoadingInvocationUnit +extends BasicInvocationUnit +{ + private boolean loadFieldValues; + private boolean loadMethodParameterValues; + private boolean loadMethodReturnValues; + + + /** + * Creates a new LoadingInvocationUnit with the given value factory. + */ + public LoadingInvocationUnit(ValueFactory valueFactory) + { + this(valueFactory, false, false, false); + } + + + /** + * Creates a new LoadingInvocationUnit with the given value factory, for + * loading the specified values. + */ + public LoadingInvocationUnit(ValueFactory valueFactory, + boolean loadFieldValues, + boolean loadMethodParameterValues, + boolean loadMethodReturnValues) + { + super(valueFactory); + + this.loadFieldValues = loadFieldValues; + this.loadMethodParameterValues = loadMethodParameterValues; + this.loadMethodReturnValues = loadMethodReturnValues; + } + + + // Implementations for BasicInvocationUnit. + + protected Value getFieldClassValue(Clazz clazz, + RefConstant refConstant, + String type) + { + if (loadFieldValues) + { + // Do we know this field? + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + // Retrieve the stored field class value. + ReferenceValue value = StoringInvocationUnit.getFieldClassValue((Field)referencedMember); + if (value != null && + value.isParticular()) + { + return value; +// // Make sure the value is refreshed. +// return refresh(value); + } + } + } + + return super.getFieldClassValue(clazz, refConstant, type); + } + + + protected Value getFieldValue(Clazz clazz, + RefConstant refConstant, + String type) + { + if (loadFieldValues) + { + // Do we know this field? + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + // Retrieve the stored field value. + Value value = StoringInvocationUnit.getFieldValue((Field)referencedMember); + if (value != null && + value.isParticular()) + { + return value; +// // Make sure the value is refreshed. +// return refresh(value); + } + } + } + + return super.getFieldValue(clazz, refConstant, type); + } + + + protected Value getMethodParameterValue(Clazz clazz, + Method method, + int parameterIndex, + String type, + Clazz referencedClass) + { + if (loadMethodParameterValues) + { + // Retrieve the stored method parameter value. + Value value = StoringInvocationUnit.getMethodParameterValue(method, parameterIndex); + if (value != null && + value.isParticular()) + { + return value; +// // Make sure the value is refreshed. +// return refresh(value); + } + } + + return super.getMethodParameterValue(clazz, + method, + parameterIndex, + type, + referencedClass); + } + + + protected Value getMethodReturnValue(Clazz clazz, + RefConstant refConstant, + String type) + { + if (loadMethodReturnValues) + { + // Do we know this method? + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + // Retrieve the stored method return value. + Value value = StoringInvocationUnit.getMethodReturnValue((Method)referencedMember); + if (value != null && + value.isParticular()) + { + return value; +// // Make sure the value is refreshed. +// return refresh(value); + } + } + } + + return super.getMethodReturnValue(clazz, + refConstant, + type); + } +// +// +// // Small utility methods. +// +// private Value refresh(Value value) +// { +// if (value.isParticular()) +// { +// return value; +// } +// +// switch (value.computationalType()) +// { +// case Value.TYPE_INTEGER: return valueFactory.createIntegerValue(); +// case Value.TYPE_LONG: return valueFactory.createLongValue(); +// case Value.TYPE_FLOAT: return valueFactory.createFloatValue(); +// case Value.TYPE_DOUBLE: return valueFactory.createDoubleValue(); +// default: +// { +// ReferenceValue referenceValue = value.referenceValue(); +// +// return valueFactory.createReferenceValue(referenceValue.getType(), +// referenceValue.getReferencedClass(), +// referenceValue.isNull() != Value.NEVER); +// } +// } +// } +} diff --git a/src/proguard/optimize/evaluation/PartialEvaluator.java b/src/proguard/optimize/evaluation/PartialEvaluator.java new file mode 100644 index 0000000..5790a36 --- /dev/null +++ b/src/proguard/optimize/evaluation/PartialEvaluator.java @@ -0,0 +1,1269 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.instruction.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.evaluation.*; +import proguard.evaluation.value.*; +import proguard.optimize.peephole.BranchTargetFinder; + +/** + * This AttributeVisitor performs partial evaluation on the code attributes + * that it visits. + * + * @author Eric Lafortune + */ +public class PartialEvaluator +extends SimplifiedVisitor +implements AttributeVisitor, + ExceptionInfoVisitor +{ + //* + private static final boolean DEBUG = false; + private static final boolean DEBUG_RESULTS = false; + /*/ + private static boolean DEBUG = true; + private static boolean DEBUG_RESULTS = true; + //*/ + + private static final int MAXIMUM_EVALUATION_COUNT = 5; + + public static final int NONE = -2; + public static final int AT_METHOD_ENTRY = -1; + public static final int AT_CATCH_ENTRY = -1; + + private final ValueFactory valueFactory; + private final InvocationUnit invocationUnit; + private final boolean evaluateAllCode; + + private InstructionOffsetValue[] branchOriginValues = new InstructionOffsetValue[ClassConstants.TYPICAL_CODE_LENGTH]; + private InstructionOffsetValue[] branchTargetValues = new InstructionOffsetValue[ClassConstants.TYPICAL_CODE_LENGTH]; + private TracedVariables[] variablesBefore = new TracedVariables[ClassConstants.TYPICAL_CODE_LENGTH]; + private TracedStack[] stacksBefore = new TracedStack[ClassConstants.TYPICAL_CODE_LENGTH]; + private TracedVariables[] variablesAfter = new TracedVariables[ClassConstants.TYPICAL_CODE_LENGTH]; + private TracedStack[] stacksAfter = new TracedStack[ClassConstants.TYPICAL_CODE_LENGTH]; + private boolean[] generalizedContexts = new boolean[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] evaluationCounts = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] initializedVariables = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private boolean evaluateExceptions; + + private final BasicBranchUnit branchUnit; + private final BranchTargetFinder branchTargetFinder; + + private final java.util.Stack callingInstructionBlockStack; + private final java.util.Stack instructionBlockStack = new java.util.Stack(); + + + /** + * Creates a simple PartialEvaluator. + */ + public PartialEvaluator() + { + this(new ValueFactory(), + new BasicInvocationUnit(new ValueFactory()), + true); + } + + + /** + * Creates a new PartialEvaluator. + * @param valueFactory the value factory that will create all values + * during evaluation. + * @param invocationUnit the invocation unit that will handle all + * communication with other fields and methods. + * @param evaluateAllCode a flag that specifies whether all branch targets + * and exception handlers should be evaluated, + * even if they are unreachable. + */ + public PartialEvaluator(ValueFactory valueFactory, + InvocationUnit invocationUnit, + boolean evaluateAllCode) + { + this(valueFactory, + invocationUnit, + evaluateAllCode, + evaluateAllCode ? + new BasicBranchUnit() : + new TracedBranchUnit(), + new BranchTargetFinder(), + null); + } + + + /** + * Creates a new PartialEvaluator, based on an existing one. + * @param partialEvaluator the subroutine calling partial evaluator. + */ + private PartialEvaluator(PartialEvaluator partialEvaluator) + { + this(partialEvaluator.valueFactory, + partialEvaluator.invocationUnit, + partialEvaluator.evaluateAllCode, + partialEvaluator.branchUnit, + partialEvaluator.branchTargetFinder, + partialEvaluator.instructionBlockStack); + } + + + /** + * Creates a new PartialEvaluator. + * @param valueFactory the value factory that will create all + * values during evaluation. + * @param invocationUnit the invocation unit that will handle all + * communication with other fields and methods. + * @param evaluateAllCode a flag that specifies whether all branch + * targets and exception handlers should be + * evaluated, even if they are unreachable. + * @param branchUnit the branch unit that will handle all + * branches. + * @param branchTargetFinder the utility class that will find all + * branches. + */ + private PartialEvaluator(ValueFactory valueFactory, + InvocationUnit invocationUnit, + boolean evaluateAllCode, + BasicBranchUnit branchUnit, + BranchTargetFinder branchTargetFinder, + java.util.Stack callingInstructionBlockStack) + { + this.valueFactory = valueFactory; + this.invocationUnit = invocationUnit; + this.evaluateAllCode = evaluateAllCode; + this.branchUnit = branchUnit; + this.branchTargetFinder = branchTargetFinder; + this.callingInstructionBlockStack = callingInstructionBlockStack == null ? + this.instructionBlockStack : + callingInstructionBlockStack; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = DEBUG_RESULTS = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the partial evaluator has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while performing partial evaluation:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + if (DEBUG) + { + method.accept(clazz, new ClassPrinter()); + } + + throw ex; + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Evaluate the instructions, starting at the entry point. + if (DEBUG) + { + System.out.println(); + System.out.println("Partial evaluation: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + System.out.println(" Max locals = "+codeAttribute.u2maxLocals); + System.out.println(" Max stack = "+codeAttribute.u2maxStack); + } + + // Reuse the existing variables and stack objects, ensuring the right size. + TracedVariables variables = new TracedVariables(codeAttribute.u2maxLocals); + TracedStack stack = new TracedStack(codeAttribute.u2maxStack); + + // Initialize the reusable arrays and variables. + initializeVariables(clazz, method, codeAttribute, variables, stack); + + // Find all instruction offsets,... + codeAttribute.accept(clazz, method, branchTargetFinder); + + // Start executing the first instruction block. + evaluateInstructionBlockAndExceptionHandlers(clazz, + method, + codeAttribute, + variables, + stack, + 0, + codeAttribute.u4codeLength); + + if (DEBUG_RESULTS) + { + System.out.println("Evaluation results:"); + + int offset = 0; + do + { + if (isBranchOrExceptionTarget(offset)) + { + System.out.println("Branch target from ["+branchOriginValues[offset]+"]:"); + if (isTraced(offset)) + { + System.out.println(" Vars: "+variablesBefore[offset]); + System.out.println(" Stack: "+stacksBefore[offset]); + } + } + + Instruction instruction = InstructionFactory.create(codeAttribute.code, + offset); + System.out.println(instruction.toString(offset)); + + if (isTraced(offset)) + { + int variableIndex = initializedVariable(offset); + if (variableIndex >= 0) + { + System.out.println(" is initializing variable v"+variableIndex); + } + + int initializationOffset = branchTargetFinder.initializationOffset(offset); + if (initializationOffset != NONE) + { + System.out.println(" is to be initialized at ["+initializationOffset+"]"); + } + + InstructionOffsetValue branchTargets = branchTargets(offset); + if (branchTargets != null) + { + System.out.println(" has overall been branching to "+branchTargets); + } + + System.out.println(" Vars: "+variablesAfter[offset]); + System.out.println(" Stack: "+stacksAfter[offset]); + } + + offset += instruction.length(offset); + } + while (offset < codeAttribute.u4codeLength); + } + } + + + /** + * Returns whether a block of instructions is ever used. + */ + public boolean isTraced(int startOffset, int endOffset) + { + for (int index = startOffset; index < endOffset; index++) + { + if (isTraced(index)) + { + return true; + } + } + + return false; + } + + + /** + * Returns whether the instruction at the given offset has ever been + * executed during the partial evaluation. + */ + public boolean isTraced(int instructionOffset) + { + return evaluationCounts[instructionOffset] > 0; + } + + + /** + * Returns whether there is an instruction at the given offset. + */ + public boolean isInstruction(int instructionOffset) + { + return branchTargetFinder.isInstruction(instructionOffset); + } + + + /** + * Returns whether the instruction at the given offset is the target of a + * branch instruction or an exception. + */ + public boolean isBranchOrExceptionTarget(int instructionOffset) + { + return branchTargetFinder.isBranchTarget(instructionOffset) || + branchTargetFinder.isExceptionHandler(instructionOffset); + } + + + /** + * Returns whether the instruction at the given offset is the start of a + * subroutine. + */ + public boolean isSubroutineStart(int instructionOffset) + { + return branchTargetFinder.isSubroutineStart(instructionOffset); + } + + + /** + * Returns whether the instruction at the given offset is a subroutine + * invocation. + */ + public boolean isSubroutineInvocation(int instructionOffset) + { + return branchTargetFinder.isSubroutineInvocation(instructionOffset); + } + + + /** + * Returns whether the instruction at the given offset is part of a + * subroutine. + */ + public boolean isSubroutine(int instructionOffset) + { + return branchTargetFinder.isSubroutine(instructionOffset); + } + + + /** + * Returns whether the subroutine at the given offset is ever returning + * by means of a regular 'ret' instruction. + */ + public boolean isSubroutineReturning(int instructionOffset) + { + return branchTargetFinder.isSubroutineReturning(instructionOffset); + } + + + /** + * Returns the offset after the subroutine that starts at the given + * offset. + */ + public int subroutineEnd(int instructionOffset) + { + return branchTargetFinder.subroutineEnd(instructionOffset); + } + + + /** + * Returns the instruction offset at which the object instance that is + * created at the given 'new' instruction offset is initialized, or + * NONE if it is not being created. + */ + public int initializationOffset(int instructionOffset) + { + return branchTargetFinder.initializationOffset(instructionOffset); + } + + + /** + * Returns whether the method is an instance initializer. + */ + public boolean isInitializer() + { + return branchTargetFinder.isInitializer(); + } + + + /** + * Returns the instruction offset at which this initializer is calling + * the "super" or "this" initializer method, or NONE if it is + * not an initializer. + */ + public int superInitializationOffset() + { + return branchTargetFinder.superInitializationOffset(); + } + + + /** + * Returns the offset of the 'new' instruction that corresponds to the + * invocation of the instance initializer at the given offset, or + * AT_METHOD_ENTRY if the invocation is calling the "super" or + * "this" initializer method, , or NONE if it is not a 'new' + * instruction. + */ + public int creationOffset(int offset) + { + return branchTargetFinder.creationOffset(offset); + } + + + /** + * Returns the variables before execution of the instruction at the given + * offset. + */ + public TracedVariables getVariablesBefore(int instructionOffset) + { + return variablesBefore[instructionOffset]; + } + + + /** + * Returns the variables after execution of the instruction at the given + * offset. + */ + public TracedVariables getVariablesAfter(int instructionOffset) + { + return variablesAfter[instructionOffset]; + } + + + /** + * Returns the stack before execution of the instruction at the given + * offset. + */ + public TracedStack getStackBefore(int instructionOffset) + { + return stacksBefore[instructionOffset]; + } + + + /** + * Returns the stack after execution of the instruction at the given + * offset. + */ + public TracedStack getStackAfter(int instructionOffset) + { + return stacksAfter[instructionOffset]; + } + + + /** + * Returns the instruction offsets that branch to the given instruction + * offset. + */ + public InstructionOffsetValue branchOrigins(int instructionOffset) + { + return branchOriginValues[instructionOffset]; + } + + + /** + * Returns the instruction offsets to which the given instruction offset + * branches. + */ + public InstructionOffsetValue branchTargets(int instructionOffset) + { + return branchTargetValues[instructionOffset]; + } + + + /** + * Returns the variable that is initialized at the given instruction offset, + * or NONE if no variable was initialized. + */ + public int initializedVariable(int instructionOffset) + { + return initializedVariables[instructionOffset]; + } + + + // Utility methods to evaluate instruction blocks. + + /** + * Pushes block of instructions to be executed in the calling partial + * evaluator. + */ + private void pushCallingInstructionBlock(TracedVariables variables, + TracedStack stack, + int startOffset) + { + callingInstructionBlockStack.push(new MyInstructionBlock(variables, + stack, + startOffset)); + } + + + /** + * Pushes block of instructions to be executed in this partial evaluator. + */ + private void pushInstructionBlock(TracedVariables variables, + TracedStack stack, + int startOffset) + { + instructionBlockStack.push(new MyInstructionBlock(variables, + stack, + startOffset)); + } + + + /** + * Evaluates the instruction block and the exception handlers covering the + * given instruction range in the given code. + */ + private void evaluateInstructionBlockAndExceptionHandlers(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + TracedVariables variables, + TracedStack stack, + int startOffset, + int endOffset) + { + evaluateInstructionBlock(clazz, + method, + codeAttribute, + variables, + stack, + startOffset); + + evaluateExceptionHandlers(clazz, + method, + codeAttribute, + startOffset, + endOffset); + } + + + /** + * Evaluates a block of instructions, starting at the given offset and ending + * at a branch instruction, a return instruction, or a throw instruction. + */ + private void evaluateInstructionBlock(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + TracedVariables variables, + TracedStack stack, + int startOffset) + { + // Execute the initial instruction block. + evaluateSingleInstructionBlock(clazz, + method, + codeAttribute, + variables, + stack, + startOffset); + + // Execute all resulting instruction blocks on the execution stack. + while (!instructionBlockStack.empty()) + { + if (DEBUG) System.out.println("Popping alternative branch out of "+instructionBlockStack.size()+" blocks"); + + MyInstructionBlock instructionBlock = + (MyInstructionBlock)instructionBlockStack.pop(); + + evaluateSingleInstructionBlock(clazz, + method, + codeAttribute, + instructionBlock.variables, + instructionBlock.stack, + instructionBlock.startOffset); + } + } + + + /** + * Evaluates a block of instructions, starting at the given offset and ending + * at a branch instruction, a return instruction, or a throw instruction. + * Instruction blocks that are to be evaluated as a result are pushed on + * the given stack. + */ + private void evaluateSingleInstructionBlock(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + TracedVariables variables, + TracedStack stack, + int startOffset) + { + byte[] code = codeAttribute.code; + + if (DEBUG) + { + System.out.println("Instruction block starting at ["+startOffset+"] in "+ + ClassUtil.externalFullMethodDescription(clazz.getName(), + 0, + method.getName(clazz), + method.getDescriptor(clazz))); + System.out.println("Init vars: "+variables); + System.out.println("Init stack: "+stack); + } + + Processor processor = new Processor(variables, + stack, + valueFactory, + branchUnit, + invocationUnit); + + int instructionOffset = startOffset; + + int maxOffset = startOffset; + + // Evaluate the subsequent instructions. + while (true) + { + if (maxOffset < instructionOffset) + { + maxOffset = instructionOffset; + } + + // Maintain a generalized local variable frame and stack at this + // instruction offset, before execution. + int evaluationCount = evaluationCounts[instructionOffset]; + if (evaluationCount == 0) + { + // First time we're passing by this instruction. + if (variablesBefore[instructionOffset] == null) + { + // There's not even a context at this index yet. + variablesBefore[instructionOffset] = new TracedVariables(variables); + stacksBefore[instructionOffset] = new TracedStack(stack); + } + else + { + // Reuse the context objects at this index. + variablesBefore[instructionOffset].initialize(variables); + stacksBefore[instructionOffset].copy(stack); + } + + // We'll execute in the generalized context, because it is + // the same as the current context. + generalizedContexts[instructionOffset] = true; + } + else + { + // Merge in the current context. + boolean variablesChanged = variablesBefore[instructionOffset].generalize(variables, true); + boolean stackChanged = stacksBefore[instructionOffset].generalize(stack); + + //System.out.println("GVars: "+variablesBefore[instructionOffset]); + //System.out.println("GStack: "+stacksBefore[instructionOffset]); + + // Bail out if the current context is the same as last time. + if (!variablesChanged && + !stackChanged && + generalizedContexts[instructionOffset]) + { + if (DEBUG) System.out.println("Repeated variables, stack, and branch targets"); + + break; + } + + // See if this instruction has been evaluated an excessive number + // of times. + if (evaluationCount >= MAXIMUM_EVALUATION_COUNT) + { + if (DEBUG) System.out.println("Generalizing current context after "+evaluationCount+" evaluations"); + + // Continue, but generalize the current context. + // Note that the most recent variable values have to remain + // last in the generalizations, for the sake of the ret + // instruction. + variables.generalize(variablesBefore[instructionOffset], false); + stack.generalize(stacksBefore[instructionOffset]); + + // We'll execute in the generalized context. + generalizedContexts[instructionOffset] = true; + } + else + { + // We'll execute in the current context. + generalizedContexts[instructionOffset] = false; + } + } + + // We'll evaluate this instruction. + evaluationCounts[instructionOffset]++; + + // Remember this instruction's offset with any stored value. + Value storeValue = new InstructionOffsetValue(instructionOffset); + variables.setProducerValue(storeValue); + stack.setProducerValue(storeValue); + + // Reset the trace value. + InstructionOffsetValue traceValue = InstructionOffsetValue.EMPTY_VALUE; + + // Reset the initialization flag. + variables.resetInitialization(); + + // Note that the instruction is only volatile. + Instruction instruction = InstructionFactory.create(code, instructionOffset); + + // By default, the next instruction will be the one after this + // instruction. + int nextInstructionOffset = instructionOffset + + instruction.length(instructionOffset); + InstructionOffsetValue nextInstructionOffsetValue = new InstructionOffsetValue(nextInstructionOffset); + branchUnit.resetCalled(); + branchUnit.setTraceBranchTargets(nextInstructionOffsetValue); + + if (DEBUG) + { + System.out.println(instruction.toString(instructionOffset)); + } + + try + { + // Process the instruction. The processor may modify the + // variables and the stack, and it may call the branch unit + // and the invocation unit. + instruction.accept(clazz, + method, + codeAttribute, + instructionOffset, + processor); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while evaluating instruction:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Instruction = "+instruction.toString(instructionOffset)); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + throw ex; + } + + // Collect the offsets of the instructions whose results were used. + initializedVariables[instructionOffset] = variables.getInitializationIndex(); + + // Collect the branch targets from the branch unit. + InstructionOffsetValue branchTargets = branchUnit.getTraceBranchTargets(); + int branchTargetCount = branchTargets.instructionOffsetCount(); + + // Stop tracing. + branchUnit.setTraceBranchTargets(traceValue); + + if (DEBUG) + { + if (branchUnit.wasCalled()) + { + System.out.println(" is branching to "+branchTargets); + } + if (branchTargetValues[instructionOffset] != null) + { + System.out.println(" has up till now been branching to "+branchTargetValues[instructionOffset]); + } + + System.out.println(" Vars: "+variables); + System.out.println(" Stack: "+stack); + } + + // Maintain a generalized local variable frame and stack at this + // instruction offset, after execution. + if (evaluationCount == 0) + { + // First time we're passing by this instruction. + if (variablesAfter[instructionOffset] == null) + { + // There's not even a context at this index yet. + variablesAfter[instructionOffset] = new TracedVariables(variables); + stacksAfter[instructionOffset] = new TracedStack(stack); + } + else + { + // Reuse the context objects at this index. + variablesAfter[instructionOffset].initialize(variables); + stacksAfter[instructionOffset].copy(stack); + } + } + else + { + // Merge in the current context. + variablesAfter[instructionOffset].generalize(variables, true); + stacksAfter[instructionOffset].generalize(stack); + } + + // Did the branch unit get called? + if (branchUnit.wasCalled()) + { + // Accumulate the branch targets at this offset. + branchTargetValues[instructionOffset] = branchTargetValues[instructionOffset] == null ? + branchTargets : + branchTargetValues[instructionOffset].generalize(branchTargets).instructionOffsetValue(); + + // Are there no branch targets at all? + if (branchTargetCount == 0) + { + // Exit from this code block. + break; + } + + // Accumulate the branch origins at the branch target offsets. + InstructionOffsetValue instructionOffsetValue = new InstructionOffsetValue(instructionOffset); + for (int index = 0; index < branchTargetCount; index++) + { + int branchTarget = branchTargets.instructionOffset(index); + branchOriginValues[branchTarget] = branchOriginValues[branchTarget] == null ? + instructionOffsetValue: + branchOriginValues[branchTarget].generalize(instructionOffsetValue).instructionOffsetValue(); + } + + // Are there multiple branch targets? + if (branchTargetCount > 1) + { + // Push them on the execution stack and exit from this block. + for (int index = 0; index < branchTargetCount; index++) + { + if (DEBUG) System.out.println("Pushing alternative branch #"+index+" out of "+branchTargetCount+", from ["+instructionOffset+"] to ["+branchTargets.instructionOffset(index)+"]"); + + pushInstructionBlock(new TracedVariables(variables), + new TracedStack(stack), + branchTargets.instructionOffset(index)); + } + + break; + } + + if (DEBUG) System.out.println("Definite branch from ["+instructionOffset+"] to ["+branchTargets.instructionOffset(0)+"]"); + } + + // Just continue with the next instruction. + instructionOffset = branchTargets.instructionOffset(0); + + // Is this a subroutine invocation? + if (instruction.opcode == InstructionConstants.OP_JSR || + instruction.opcode == InstructionConstants.OP_JSR_W) + { + // Evaluate the subroutine, possibly in another partial + // evaluator. + evaluateSubroutine(clazz, + method, + codeAttribute, + variables, + stack, + instructionOffset, + instructionBlockStack); + + break; + } + else if (instruction.opcode == InstructionConstants.OP_RET) + { + // Let the partial evaluator that has called the subroutine + // handle the evaluation after the return. + pushCallingInstructionBlock(new TracedVariables(variables), + new TracedStack(stack), + instructionOffset); + break; + } + } + + if (DEBUG) System.out.println("Ending processing of instruction block starting at ["+startOffset+"]"); + } + + + /** + * Evaluates a subroutine and its exception handlers, starting at the given + * offset and ending at a subroutine return instruction. + */ + private void evaluateSubroutine(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + TracedVariables variables, + TracedStack stack, + int subroutineStart, + java.util.Stack instructionBlockStack) + { + int subroutineEnd = branchTargetFinder.subroutineEnd(subroutineStart); + + if (DEBUG) System.out.println("Evaluating subroutine from "+subroutineStart+" to "+subroutineEnd); + + PartialEvaluator subroutinePartialEvaluator = this; + + // Create a temporary partial evaluator if necessary. + if (evaluationCounts[subroutineStart] > 0) + { + if (DEBUG) System.out.println("Creating new partial evaluator for subroutine"); + + subroutinePartialEvaluator = new PartialEvaluator(this); + + subroutinePartialEvaluator.initializeVariables(clazz, + method, + codeAttribute, + variables, + stack); + } + + // Evaluate the subroutine. + subroutinePartialEvaluator.evaluateInstructionBlockAndExceptionHandlers(clazz, + method, + codeAttribute, + variables, + stack, + subroutineStart, + subroutineEnd); + + // Merge back the temporary partial evaluator if necessary. + if (subroutinePartialEvaluator != this) + { + generalize(subroutinePartialEvaluator, 0, codeAttribute.u4codeLength); + } + + if (DEBUG) System.out.println("Ending subroutine from "+subroutineStart+" to "+subroutineEnd); + } + + + /** + * Generalizes the results of this partial evaluator with those of another + * given partial evaluator, over a given range of instructions. + */ + private void generalize(PartialEvaluator other, + int codeStart, + int codeEnd) + { + if (DEBUG) System.out.println("Generalizing with temporary partial evaluation"); + + for (int offset = codeStart; offset < codeEnd; offset++) + { + if (other.branchOriginValues[offset] != null) + { + branchOriginValues[offset] = branchOriginValues[offset] == null ? + other.branchOriginValues[offset] : + branchOriginValues[offset].generalize(other.branchOriginValues[offset]).instructionOffsetValue(); + } + + if (other.isTraced(offset)) + { + if (other.branchTargetValues[offset] != null) + { + branchTargetValues[offset] = branchTargetValues[offset] == null ? + other.branchTargetValues[offset] : + branchTargetValues[offset].generalize(other.branchTargetValues[offset]).instructionOffsetValue(); + } + + if (evaluationCounts[offset] == 0) + { + variablesBefore[offset] = other.variablesBefore[offset]; + stacksBefore[offset] = other.stacksBefore[offset]; + variablesAfter[offset] = other.variablesAfter[offset]; + stacksAfter[offset] = other.stacksAfter[offset]; + generalizedContexts[offset] = other.generalizedContexts[offset]; + evaluationCounts[offset] = other.evaluationCounts[offset]; + initializedVariables[offset] = other.initializedVariables[offset]; + } + else + { + variablesBefore[offset].generalize(other.variablesBefore[offset], false); + stacksBefore[offset] .generalize(other.stacksBefore[offset]); + variablesAfter[offset] .generalize(other.variablesAfter[offset], false); + stacksAfter[offset] .generalize(other.stacksAfter[offset]); + //generalizedContexts[offset] + evaluationCounts[offset] += other.evaluationCounts[offset]; + //initializedVariables[offset] + } + } + } + } + + + /** + * Evaluates the exception handlers covering and targeting the given + * instruction range in the given code. + */ + private void evaluateExceptionHandlers(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int startOffset, + int endOffset) + { + if (DEBUG) System.out.println("Evaluating exceptions covering ["+startOffset+" -> "+endOffset+"]:"); + + ExceptionHandlerFilter exceptionEvaluator = + new ExceptionHandlerFilter(startOffset, + endOffset, + this); + + // Evaluate the exception catch blocks, until their entry variables + // have stabilized. + do + { + // Reset the flag to stop evaluating. + evaluateExceptions = false; + + // Evaluate all relevant exception catch blocks once. + codeAttribute.exceptionsAccept(clazz, + method, + startOffset, + endOffset, + exceptionEvaluator); + } + while (evaluateExceptions); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + int startPC = exceptionInfo.u2startPC; + int endPC = exceptionInfo.u2endPC; + + // Do we have to evaluate this exception catch block? + if (isTraced(startPC, endPC)) + { + int handlerPC = exceptionInfo.u2handlerPC; + int catchType = exceptionInfo.u2catchType; + + if (DEBUG) System.out.println("Evaluating exception ["+startPC +" -> "+endPC +": "+handlerPC+"]:"); + + // Reuse the existing variables and stack objects, ensuring the + // right size. + TracedVariables variables = new TracedVariables(codeAttribute.u2maxLocals); + TracedStack stack = new TracedStack(codeAttribute.u2maxStack); + + // Initialize the trace values. + Value storeValue = new InstructionOffsetValue(AT_CATCH_ENTRY); + variables.setProducerValue(storeValue); + stack.setProducerValue(storeValue); + + // Initialize the variables by generalizing the variables of the + // try block. Make sure to include the results of the last + // instruction for preverification. + generalizeVariables(startPC, + endPC, + evaluateAllCode, + variables); + + // Initialize the the stack. + //stack.push(valueFactory.createReference((ClassConstant)((ProgramClass)clazz).getConstant(exceptionInfo.u2catchType), false)); + String catchClassName = catchType != 0 ? + clazz.getClassName(catchType) : + ClassConstants.INTERNAL_NAME_JAVA_LANG_THROWABLE; + + Clazz catchClass = catchType != 0 ? + ((ClassConstant)((ProgramClass)clazz).getConstant(catchType)).referencedClass : + null; + + stack.push(valueFactory.createReferenceValue(catchClassName, + catchClass, + false)); + + int evaluationCount = evaluationCounts[handlerPC]; + + // Evaluate the instructions, starting at the entry point. + evaluateInstructionBlock(clazz, + method, + codeAttribute, + variables, + stack, + handlerPC); + + // Remember to evaluate all exception handlers once more. + if (!evaluateExceptions) + { + evaluateExceptions = evaluationCount < evaluationCounts[handlerPC]; + } + } +// else if (evaluateAllCode) +// { +// if (DEBUG) System.out.println("No information for partial evaluation of exception ["+startPC +" -> "+endPC +": "+exceptionInfo.u2handlerPC+"] yet"); +// +// // We don't have any information on the try block yet, but we do +// // have to evaluate the exception handler. +// // Remember to evaluate all exception handlers once more. +// evaluateExceptions = true; +// } + else + { + if (DEBUG) System.out.println("No information for partial evaluation of exception ["+startPC +" -> "+endPC +": "+exceptionInfo.u2handlerPC+"]"); + } + } + + + // Small utility methods. + + /** + * Initializes the data structures for the variables, stack, etc. + */ + private void initializeVariables(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + TracedVariables variables, + TracedStack stack) + { + int codeLength = codeAttribute.u4codeLength; + + // Create new arrays for storing information at each instruction offset. + if (variablesAfter.length < codeLength) + { + // Create new arrays. + branchOriginValues = new InstructionOffsetValue[codeLength]; + branchTargetValues = new InstructionOffsetValue[codeLength]; + variablesBefore = new TracedVariables[codeLength]; + stacksBefore = new TracedStack[codeLength]; + variablesAfter = new TracedVariables[codeLength]; + stacksAfter = new TracedStack[codeLength]; + generalizedContexts = new boolean[codeLength]; + evaluationCounts = new int[codeLength]; + initializedVariables = new int[codeLength]; + + // Reset the arrays. + for (int index = 0; index < codeLength; index++) + { + initializedVariables[index] = NONE; + } + } + else + { + // Reset the arrays. + for (int index = 0; index < codeLength; index++) + { + branchOriginValues[index] = null; + branchTargetValues[index] = null; + generalizedContexts[index] = false; + evaluationCounts[index] = 0; + initializedVariables[index] = NONE; + + if (variablesBefore[index] != null) + { + variablesBefore[index].reset(codeAttribute.u2maxLocals); + } + + if (stacksBefore[index] != null) + { + stacksBefore[index].reset(codeAttribute.u2maxStack); + } + + if (variablesAfter[index] != null) + { + variablesAfter[index].reset(codeAttribute.u2maxLocals); + } + + if (stacksAfter[index] != null) + { + stacksAfter[index].reset(codeAttribute.u2maxStack); + } + } + } + + // Create the method parameters. + TracedVariables parameters = new TracedVariables(codeAttribute.u2maxLocals); + + // Remember this instruction's offset with any stored value. + Value storeValue = new InstructionOffsetValue(AT_METHOD_ENTRY); + parameters.setProducerValue(storeValue); + + // Initialize the method parameters. + invocationUnit.enterMethod(clazz, method, parameters); + + if (DEBUG) + { + System.out.println(" Params: "+parameters); + } + + // Initialize the variables with the parameters. + variables.initialize(parameters); + + // Set the store value of each parameter variable. + InstructionOffsetValue atMethodEntry = new InstructionOffsetValue(AT_METHOD_ENTRY); + + for (int index = 0; index < parameters.size(); index++) + { + variables.setProducerValue(index, atMethodEntry); + } + } + + + /** + * Generalize the local variable frames of a block of instructions. + */ + private void generalizeVariables(int startOffset, + int endOffset, + boolean includeAfterLastInstruction, + TracedVariables generalizedVariables) + { + boolean first = true; + int lastIndex = -1; + + // Generalize the variables before each of the instructions in the block. + for (int index = startOffset; index < endOffset; index++) + { + if (isTraced(index)) + { + TracedVariables tracedVariables = variablesBefore[index]; + + if (first) + { + // Initialize the variables with the first traced local + // variable frame. + generalizedVariables.initialize(tracedVariables); + + first = false; + } + else + { + // Generalize the variables with the traced local variable + // frame. We can't use the return value, because local + // generalization can be different a couple of times, + // with the global generalization being the same. + generalizedVariables.generalize(tracedVariables, false); + } + + lastIndex = index; + } + } + + // Generalize the variables after the last instruction in the block, + // if required. + if (includeAfterLastInstruction && + lastIndex >= 0) + { + TracedVariables tracedVariables = variablesAfter[lastIndex]; + + if (first) + { + // Initialize the variables with the local variable frame. + generalizedVariables.initialize(tracedVariables); + } + else + { + // Generalize the variables with the local variable frame. + generalizedVariables.generalize(tracedVariables, false); + } + } + + // Just clear the variables if there aren't any traced instructions + // in the block. + if (first) + { + generalizedVariables.reset(generalizedVariables.size()); + } + } + + + private static class MyInstructionBlock + { + private TracedVariables variables; + private TracedStack stack; + private int startOffset; + + + private MyInstructionBlock(TracedVariables variables, + TracedStack stack, + int startOffset) + { + this.variables = variables; + this.stack = stack; + this.startOffset = startOffset; + } + } +} diff --git a/src/proguard/optimize/evaluation/StoringInvocationUnit.java b/src/proguard/optimize/evaluation/StoringInvocationUnit.java new file mode 100644 index 0000000..bcbb69f --- /dev/null +++ b/src/proguard/optimize/evaluation/StoringInvocationUnit.java @@ -0,0 +1,207 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.constant.RefConstant; +import proguard.evaluation.BasicInvocationUnit; +import proguard.evaluation.value.*; +import proguard.optimize.info.*; + +/** + * This InvocationUbit stores parameter values and return values with the + * methods that are invoked. + * + * @see LoadingInvocationUnit + * @author Eric Lafortune + */ +public class StoringInvocationUnit +extends BasicInvocationUnit +{ + private boolean storeFieldValues; + private boolean storeMethodParameterValues; + private boolean storeMethodReturnValues; + + + /** + * Creates a new StoringInvocationUnit with the given value factory. + */ + public StoringInvocationUnit(ValueFactory valueFactory) + { + this(valueFactory, true, true, true); + } + + + /** + * Creates a new StoringInvocationUnit with the given value factory, for + * storing the specified values. + */ + public StoringInvocationUnit(ValueFactory valueFactory, + boolean storeFieldValues, + boolean storeMethodParameterValues, + boolean storeMethodReturnValues) + { + super(valueFactory); + + this.storeFieldValues = storeFieldValues; + this.storeMethodParameterValues = storeMethodParameterValues; + this.storeMethodReturnValues = storeMethodReturnValues; + } + + + // Implementations for BasicInvocationUnit. + + protected void setFieldClassValue(Clazz clazz, + RefConstant refConstant, + ReferenceValue value) + { + if (storeFieldValues) + { + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + generalizeFieldClassValue((Field)referencedMember, value); + } + } + } + + + protected void setFieldValue(Clazz clazz, + RefConstant refConstant, + Value value) + { + if (storeFieldValues) + { + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + generalizeFieldValue((Field)referencedMember, value); + } + } + } + + + protected void setMethodParameterValue(Clazz clazz, + RefConstant refConstant, + int parameterIndex, + Value value) + { + if (storeMethodParameterValues) + { + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null) + { + generalizeMethodParameterValue((Method)referencedMember, + parameterIndex, + value); + } + } + } + + + protected void setMethodReturnValue(Clazz clazz, + Method method, + Value value) + { + if (storeMethodReturnValues) + { + generalizeMethodReturnValue(method, value); + } + } + + + // Small utility methods. + + private static void generalizeFieldClassValue(Field field, ReferenceValue value) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + if (info != null) + { + info.generalizeReferencedClass(value); + } + } + + + public static ReferenceValue getFieldClassValue(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + return info != null ? + info.getReferencedClass() : + null; + } + + + private static void generalizeFieldValue(Field field, Value value) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + if (info != null) + { + info.generalizeValue(value); + } + } + + + public static Value getFieldValue(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + return info != null ? + info.getValue() : + null; + } + + + private static void generalizeMethodParameterValue(Method method, int parameterIndex, Value value) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.generalizeParameter(parameterIndex, value); + } + } + + + public static Value getMethodParameterValue(Method method, int parameterIndex) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null ? + info.getParameter(parameterIndex) : + null; + } + + + private static void generalizeMethodReturnValue(Method method, Value value) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.generalizeReturnValue(value); + } + } + + + public static Value getMethodReturnValue(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null ? + info.getReturnValue() : + null; + } +} diff --git a/src/proguard/optimize/evaluation/TracedBranchUnit.java b/src/proguard/optimize/evaluation/TracedBranchUnit.java new file mode 100644 index 0000000..fa5bb79 --- /dev/null +++ b/src/proguard/optimize/evaluation/TracedBranchUnit.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.Clazz; +import proguard.classfile.attribute.CodeAttribute; +import proguard.evaluation.BasicBranchUnit; +import proguard.evaluation.value.Value; + +/** + * This BranchUnit remembers the branch unit commands that are invoked on it. + * + * @author Eric Lafortune + */ +class TracedBranchUnit +extends BasicBranchUnit +{ + // Implementations for BranchUnit. + + public void branchConditionally(Clazz clazz, + CodeAttribute codeAttribute, + int offset, + int branchTarget, + int conditional) + { + if (conditional == Value.ALWAYS) + { + // Always branch. + super.branch(clazz, codeAttribute, offset, branchTarget); + } + else if (conditional != Value.NEVER) + { + // Maybe branch. + super.branchConditionally(clazz, codeAttribute, offset, branchTarget, conditional); + } + else + { + super.setCalled(); + } + } +} diff --git a/src/proguard/optimize/evaluation/VariableOptimizer.java b/src/proguard/optimize/evaluation/VariableOptimizer.java new file mode 100644 index 0000000..b3ae81c --- /dev/null +++ b/src/proguard/optimize/evaluation/VariableOptimizer.java @@ -0,0 +1,244 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.evaluation; + +import proguard.classfile.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.VariableRemapper; +import proguard.classfile.util.*; + +/** + * This AttributeVisitor optimizes variable allocation based on their the liveness, + * in the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class VariableOptimizer +extends SimplifiedVisitor +implements AttributeVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + private static final int MAX_VARIABLES_SIZE = 64; + + + private final boolean reuseThis; + private final MemberVisitor extraVariableMemberVisitor; + + private final LivenessAnalyzer livenessAnalyzer = new LivenessAnalyzer(); + private final VariableRemapper variableRemapper = new VariableRemapper(); + + private int[] variableMap = new int[ClassConstants.TYPICAL_VARIABLES_SIZE]; + + + /** + * Creates a new VariableOptimizer. + * @param reuseThis specifies whether the 'this' variable can be reused. + * Many JVMs for JME and IBM's JVMs for JSE can't handle + * such reuse. + */ + public VariableOptimizer(boolean reuseThis) + { + this(reuseThis, null); + } + + + /** + * Creates a new VariableOptimizer with an extra visitor. + * @param reuseThis specifies whether the 'this' variable + * can be reused. Many JVMs for JME and + * IBM's JVMs for JSE can't handle such + * reuse. + * @param extraVariableMemberVisitor an optional extra visitor for all + * removed variables. + */ + public VariableOptimizer(boolean reuseThis, + MemberVisitor extraVariableMemberVisitor) + { + this.reuseThis = reuseThis; + this.extraVariableMemberVisitor = extraVariableMemberVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // Initialize the global arrays. + initializeArrays(codeAttribute); + + // Analyze the liveness of the variables in the code. + livenessAnalyzer.visitCodeAttribute(clazz, method, codeAttribute); + + int startIndex = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0 || + reuseThis ? 0 : 1; + + int parameterSize = + ClassUtil.internalMethodParameterSize(method.getDescriptor(clazz), + method.getAccessFlags()); + + int variableSize = codeAttribute.u2maxLocals; + int codeLength = codeAttribute.u4codeLength; + + boolean remapping = false; + + // Loop over all variables. + for (int oldIndex = 0; oldIndex < variableSize; oldIndex++) + { + // By default, the variable will be mapped onto itself. + variableMap[oldIndex] = oldIndex; + + // Only try remapping the variable if it's not a parameter. + if (oldIndex >= parameterSize && + oldIndex < MAX_VARIABLES_SIZE) + { + // Try to remap the variable to a variable with a smaller index. + for (int newIndex = startIndex; newIndex < oldIndex; newIndex++) + { + if (areNonOverlapping(oldIndex, newIndex, codeLength)) + { + variableMap[oldIndex] = newIndex; + + updateLiveness(oldIndex, newIndex, codeLength); + + remapping = true; + + // This variable has been remapped. Go to the next one. + break; + } + } + } + } + + // Remap the variables. + if (remapping) + { + if (DEBUG) + { + System.out.println("Remapping variables:"); + System.out.println(" Class "+ ClassUtil.externalClassName(clazz.getName())); + System.out.println(" Method "+ClassUtil.externalFullMethodDescription(clazz.getName(), + 0, + method.getName(clazz), + method.getDescriptor(clazz))); + for (int index = 0; index < variableSize; index++) + { + System.out.println(" ["+index+"] -> ["+variableMap[index]+"]"); + } + } + + variableRemapper.setVariableMap(variableMap); + variableRemapper.visitCodeAttribute(clazz, method, codeAttribute); + + // Visit the method, if required. + if (extraVariableMemberVisitor != null) + { + method.accept(clazz, extraVariableMemberVisitor); + } + } + } + + + // Small utility methods. + + /** + * Initializes the global arrays. + */ + private void initializeArrays(CodeAttribute codeAttribute) + { + int codeLength = codeAttribute.u4codeLength; + + // Create new arrays for storing information at each instruction offset. + if (variableMap.length < codeLength) + { + variableMap = new int[codeLength]; + } + } + + + /** + * Returns whether the given variables are never alive at the same time. + */ + private boolean areNonOverlapping(int variableIndex1, + int variableIndex2, + int codeLength) + { + // Loop over all instructions. + for (int offset = 0; offset < codeLength; offset++) + { + if ((livenessAnalyzer.isAliveBefore(offset, variableIndex1) && + livenessAnalyzer.isAliveBefore(offset, variableIndex2)) || + + (livenessAnalyzer.isAliveAfter(offset, variableIndex1) && + livenessAnalyzer.isAliveAfter(offset, variableIndex2)) || + + // For now, exclude Category 2 variables. + livenessAnalyzer.isCategory2(offset, variableIndex1)) + { + return false; + } + } + + return true; + } + + + /** + * Updates the liveness resulting from mapping the given old variable on + * the given new variable. + */ + private void updateLiveness(int oldVariableIndex, + int newVariableIndex, + int codeLength) + { + // Loop over all instructions. + for (int offset = 0; offset < codeLength; offset++) + { + // Update the liveness before the instruction. + if (livenessAnalyzer.isAliveBefore(offset, oldVariableIndex)) + { + livenessAnalyzer.setAliveBefore(offset, oldVariableIndex, false); + livenessAnalyzer.setAliveBefore(offset, newVariableIndex, true); + } + + // Update the liveness after the instruction. + if (livenessAnalyzer.isAliveAfter(offset, oldVariableIndex)) + { + livenessAnalyzer.setAliveAfter(offset, oldVariableIndex, false); + livenessAnalyzer.setAliveAfter(offset, newVariableIndex, true); + } + } + } +} diff --git a/src/proguard/optimize/evaluation/package.html b/src/proguard/optimize/evaluation/package.html new file mode 100644 index 0000000..5341f9f --- /dev/null +++ b/src/proguard/optimize/evaluation/package.html @@ -0,0 +1,4 @@ + +This package contains visitors that perform partial evaluation and subsequent +optimizations on byte code. + diff --git a/src/proguard/optimize/info/AccessMethodMarker.java b/src/proguard/optimize/info/AccessMethodMarker.java new file mode 100644 index 0000000..6965cec --- /dev/null +++ b/src/proguard/optimize/info/AccessMethodMarker.java @@ -0,0 +1,187 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This InstructionVisitor marks the types of class accesses and class member + * accesses of the methods whose instructions it visits. + * + * @author Eric Lafortune + */ +public class AccessMethodMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + ClassVisitor, + MemberVisitor +{ + private Method invokingMethod; + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + invokingMethod = method; + + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Check the referenced class or class member, if any. + stringConstant.referencedClassAccept(this); + stringConstant.referencedMemberAccept(this); + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + // Check the referenced class. + clazz.constantPoolEntryAccept(refConstant.u2classIndex, this); + + // Check the referenced class member itself. + refConstant.referencedClassAccept(this); + refConstant.referencedMemberAccept(this); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Check the referenced class. + classConstant.referencedClassAccept(this); + } + + + // Implementations for ClassVisitor. + + public void visitAnyClass(Clazz clazz) + { + int accessFlags = clazz.getAccessFlags(); + + if ((accessFlags & ClassConstants.INTERNAL_ACC_PUBLIC) == 0) + { + setAccessesPackageCode(invokingMethod); + } + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + int accessFlags = member.getAccessFlags(); + + if ((accessFlags & ClassConstants.INTERNAL_ACC_PRIVATE) != 0) + { + setAccessesPrivateCode(invokingMethod); + } + else if ((accessFlags & ClassConstants.INTERNAL_ACC_PROTECTED) != 0) + { + setAccessesProtectedCode(invokingMethod); + } + else if ((accessFlags & ClassConstants.INTERNAL_ACC_PUBLIC) == 0) + { + setAccessesPackageCode(invokingMethod); + } + } + + + // Small utility methods. + + private static void setAccessesPrivateCode(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setAccessesPrivateCode(); + } + } + + + /** + * Returns whether the given method accesses private class members. + */ + public static boolean accessesPrivateCode(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || info.accessesPrivateCode(); + } + + + private static void setAccessesPackageCode(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setAccessesPackageCode(); + } + } + + + /** + * Returns whether the given method accesses package visible classes or class + * members. + */ + public static boolean accessesPackageCode(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || info.accessesPackageCode(); + } + + + private static void setAccessesProtectedCode(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setAccessesProtectedCode(); + } + } + + + /** + * Returns whether the given method accesses protected class members. + */ + public static boolean accessesProtectedCode(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || info.accessesProtectedCode(); + } +} diff --git a/src/proguard/optimize/info/BackwardBranchMarker.java b/src/proguard/optimize/info/BackwardBranchMarker.java new file mode 100644 index 0000000..9e09b0f --- /dev/null +++ b/src/proguard/optimize/info/BackwardBranchMarker.java @@ -0,0 +1,90 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor marks all methods that branch backward in any of the + * instructions that it visits. + * + * @author Eric Lafortune + */ +public class BackwardBranchMarker +extends SimplifiedVisitor +implements InstructionVisitor +{ + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + markBackwardBranch(method, branchInstruction.branchOffset); + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + markBackwardBranch(method, switchInstruction.defaultOffset); + + for (int index = 0; index < switchInstruction.jumpOffsets.length; index++) + { + markBackwardBranch(method, switchInstruction.jumpOffsets[index]); + } + } + + + // Small utility methods. + + /** + * Marks the given method if the given branch offset is negative. + */ + private void markBackwardBranch(Method method, int branchOffset) + { + if (branchOffset < 0) + { + setBranchesBackward(method); + } + } + + + private static void setBranchesBackward(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setBranchesBackward(); + } + } + + + public static boolean branchesBackward(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || info.branchesBackward(); + } +} diff --git a/src/proguard/optimize/info/CatchExceptionMarker.java b/src/proguard/optimize/info/CatchExceptionMarker.java new file mode 100644 index 0000000..3f2a06f --- /dev/null +++ b/src/proguard/optimize/info/CatchExceptionMarker.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor marks all methods that catch exceptions. + * + * @author Eric Lafortune + */ +public class CatchExceptionMarker +extends SimplifiedVisitor +implements AttributeVisitor +{ + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (codeAttribute.u2exceptionTableLength > 0) + { + markCatchException(method); + } + } + + + // Small utility methods. + + private static void markCatchException(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setCatchesExceptions(); + } + } + + + public static boolean catchesExceptions(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || + info.catchesExceptions(); + } +} diff --git a/src/proguard/optimize/info/CaughtClassFilter.java b/src/proguard/optimize/info/CaughtClassFilter.java new file mode 100644 index 0000000..5e17763 --- /dev/null +++ b/src/proguard/optimize/info/CaughtClassFilter.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor delegates all its method calls to another ClassVisitor, + * but only for Clazz objects that are caught as exceptions. + * + * @see CaughtClassMarker + * @author Eric Lafortune + */ +public class CaughtClassFilter +implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + public CaughtClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (CaughtClassMarker.isCaught(programClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (CaughtClassMarker.isCaught(libraryClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/CaughtClassMarker.java b/src/proguard/optimize/info/CaughtClassMarker.java new file mode 100644 index 0000000..0cc350e --- /dev/null +++ b/src/proguard/optimize/info/CaughtClassMarker.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This InstructionVisitor marks all classes that are used in an 'instanceof' + * test by any of the instructions that it visits. + * + * @author Eric Lafortune + */ +public class CaughtClassMarker +implements ClassVisitor +{ + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) {} + + public void visitProgramClass(ProgramClass programClass) + { + setCaught(programClass); + } + + + // Small utility methods. + + private static void setCaught(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setCaught(); + } + } + + + public static boolean isCaught(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + return info == null || info.isCaught(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/ClassOptimizationInfo.java b/src/proguard/optimize/info/ClassOptimizationInfo.java new file mode 100644 index 0000000..99b6e7b --- /dev/null +++ b/src/proguard/optimize/info/ClassOptimizationInfo.java @@ -0,0 +1,151 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.Clazz; + +/** + * This class stores some optimization information that can be attached to + * a class. + * + * @author Eric Lafortune + */ +public class ClassOptimizationInfo +{ + private boolean isInstantiated = false; + private boolean isInstanceofed = false; + private boolean isDotClassed = false; + private boolean isCaught = false; + private boolean containsPackageVisibleMembers = false; + private boolean invokesPackageVisibleMembers = false; + private Clazz targetClass; + + + public void setInstantiated() + { + isInstantiated = true; + } + + + public boolean isInstantiated() + { + return isInstantiated; + } + + + public void setInstanceofed() + { + isInstanceofed = true; + } + + + public boolean isInstanceofed() + { + return isInstanceofed; + } + + + public void setDotClassed() + { + isDotClassed = true; + } + + + public boolean isDotClassed() + { + return isDotClassed; + } + + + public void setCaught() + { + isCaught = true; + } + + + public boolean isCaught() + { + return isCaught; + } + + + public void setContainsPackageVisibleMembers() + { + containsPackageVisibleMembers = true; + } + + + public boolean containsPackageVisibleMembers() + { + return containsPackageVisibleMembers; + } + + + public void setInvokesPackageVisibleMembers() + { + invokesPackageVisibleMembers = true; + } + + + public boolean invokesPackageVisibleMembers() + { + return invokesPackageVisibleMembers; + } + + + public void setTargetClass(Clazz targetClass) + { + this.targetClass = targetClass; + } + + + public Clazz getTargetClass() + { + return targetClass; + } + + + public void merge(ClassOptimizationInfo other) + { + this.isInstantiated |= other.isInstantiated; + this.isInstanceofed |= other.isInstanceofed; + this.isDotClassed |= other.isDotClassed; + this.isCaught |= other.isCaught; + this.containsPackageVisibleMembers |= other.containsPackageVisibleMembers; + this.invokesPackageVisibleMembers |= other.invokesPackageVisibleMembers; + } + + + public static void setClassOptimizationInfo(Clazz clazz) + { + clazz.setVisitorInfo(new ClassOptimizationInfo()); + } + + + public static ClassOptimizationInfo getClassOptimizationInfo(Clazz clazz) + { + Object visitorInfo = clazz.getVisitorInfo(); + + return visitorInfo instanceof ClassOptimizationInfo ? + (ClassOptimizationInfo)visitorInfo : + null; + } +} diff --git a/src/proguard/optimize/info/ClassOptimizationInfoSetter.java b/src/proguard/optimize/info/ClassOptimizationInfoSetter.java new file mode 100644 index 0000000..9cb167c --- /dev/null +++ b/src/proguard/optimize/info/ClassOptimizationInfoSetter.java @@ -0,0 +1,47 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; +import proguard.optimize.KeepMarker; + +/** + * This ClassVisitor attaches a ClassOptimizationInfo instance to every class + * that is not being kept that it visits. + * + * @author Eric Lafortune + */ +public class ClassOptimizationInfoSetter +extends SimplifiedVisitor +implements ClassVisitor +{ + // Implementations for MemberVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (!KeepMarker.isKept(programClass)) + { + ClassOptimizationInfo.setClassOptimizationInfo(programClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/DotClassFilter.java b/src/proguard/optimize/info/DotClassFilter.java new file mode 100644 index 0000000..8cbe7f0 --- /dev/null +++ b/src/proguard/optimize/info/DotClassFilter.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor delegates all its method calls to another ClassVisitor, + * but only for Clazz objects that are used in a .class construct. + * + * @see DotClassMarker + * @author Eric Lafortune + */ +public class DotClassFilter +implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + public DotClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (DotClassMarker.isDotClassed(programClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (DotClassMarker.isDotClassed(libraryClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/DotClassMarker.java b/src/proguard/optimize/info/DotClassMarker.java new file mode 100644 index 0000000..b5f12a7 --- /dev/null +++ b/src/proguard/optimize/info/DotClassMarker.java @@ -0,0 +1,96 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This InstructionVisitor marks all classes that are used in a .class + * construct by any of the instructions that it visits. + * + * @author Eric Lafortune + */ +public class DotClassMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + ClassVisitor +{ + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + if (constantInstruction.opcode == InstructionConstants.OP_LDC || + constantInstruction.opcode == InstructionConstants.OP_LDC_W) + { + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.referencedClassAccept(this); + } + + + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) {} + + public void visitProgramClass(ProgramClass programClass) + { + setDotClassed(programClass); + } + + + // Small utility methods. + + private static void setDotClassed(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setDotClassed(); + } + } + + + public static boolean isDotClassed(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + return info == null || info.isDotClassed(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/ExceptionInstructionChecker.java b/src/proguard/optimize/info/ExceptionInstructionChecker.java new file mode 100644 index 0000000..2792d90 --- /dev/null +++ b/src/proguard/optimize/info/ExceptionInstructionChecker.java @@ -0,0 +1,187 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.RefConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This class can tell whether an instruction might throw exceptions. + * + * @author Eric Lafortune + */ +public class ExceptionInstructionChecker +extends SimplifiedVisitor +implements InstructionVisitor +// ConstantVisitor, +// MemberVisitor +{ + // A return value for the visitor methods. + private boolean mayThrowExceptions; + + + /** + * Returns whether the given instruction may throw exceptions. + */ + public boolean mayThrowExceptions(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + mayThrowExceptions = false; + + instruction.accept(clazz, method, codeAttribute, offset, this); + + return mayThrowExceptions; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + byte opcode = simpleInstruction.opcode; + + // Check for instructions that may throw exceptions. + if (opcode == InstructionConstants.OP_IDIV || + opcode == InstructionConstants.OP_LDIV || + opcode == InstructionConstants.OP_IREM || + opcode == InstructionConstants.OP_LREM || + opcode == InstructionConstants.OP_IALOAD || + opcode == InstructionConstants.OP_LALOAD || + opcode == InstructionConstants.OP_FALOAD || + opcode == InstructionConstants.OP_DALOAD || + opcode == InstructionConstants.OP_AALOAD || + opcode == InstructionConstants.OP_BALOAD || + opcode == InstructionConstants.OP_CALOAD || + opcode == InstructionConstants.OP_SALOAD || + opcode == InstructionConstants.OP_IASTORE || + opcode == InstructionConstants.OP_LASTORE || + opcode == InstructionConstants.OP_FASTORE || + opcode == InstructionConstants.OP_DASTORE || + opcode == InstructionConstants.OP_AASTORE || + opcode == InstructionConstants.OP_BASTORE || + opcode == InstructionConstants.OP_CASTORE || + opcode == InstructionConstants.OP_SASTORE || + opcode == InstructionConstants.OP_NEWARRAY || + opcode == InstructionConstants.OP_ARRAYLENGTH || + opcode == InstructionConstants.OP_ATHROW || + opcode == InstructionConstants.OP_MONITORENTER || + opcode == InstructionConstants.OP_MONITOREXIT) + { + // These instructions may throw exceptions. + mayThrowExceptions = true; + } + + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + byte opcode = constantInstruction.opcode; + + // Check for instructions that may throw exceptions. + if (opcode == InstructionConstants.OP_GETSTATIC || + opcode == InstructionConstants.OP_PUTSTATIC || + opcode == InstructionConstants.OP_GETFIELD || + opcode == InstructionConstants.OP_PUTFIELD || + opcode == InstructionConstants.OP_INVOKEVIRTUAL || + opcode == InstructionConstants.OP_INVOKESPECIAL || + opcode == InstructionConstants.OP_INVOKESTATIC || + opcode == InstructionConstants.OP_INVOKEINTERFACE || + opcode == InstructionConstants.OP_NEW || + opcode == InstructionConstants.OP_ANEWARRAY || + opcode == InstructionConstants.OP_CHECKCAST || + opcode == InstructionConstants.OP_MULTIANEWARRAY) + { + // These instructions may throw exceptions. + mayThrowExceptions = true; + } +// else +// if (opcode == InstructionConstants.OP_INVOKEVIRTUAL || +// opcode == InstructionConstants.OP_INVOKESPECIAL || +// opcode == InstructionConstants.OP_INVOKESTATIC || +// opcode == InstructionConstants.OP_INVOKEINTERFACE) +// { +// // Check if the invoking the method may throw an exception. +// clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); +// } + } + + +// // Implementations for ConstantVisitor. +// +// public void visitAnyMethodrefConstant(Clazz clazz, RefConstant refConstant) +// { +// Member referencedMember = refConstant.referencedMember; +// +// // Do we have a reference to the method? +// if (referencedMember == null) +// { +// // We'll have to assume invoking the unknown method may throw an +// // an exception. +// mayThrowExceptions = true; +// } +// else +// { +// // First check the referenced method itself. +// refConstant.referencedMemberAccept(this); +// +// // If the result isn't conclusive, check down the hierarchy. +// if (!mayThrowExceptions) +// { +// Clazz referencedClass = refConstant.referencedClass; +// Method referencedMethod = (Method)referencedMember; +// +// // Check all other implementations of the method in the class +// // hierarchy. +// referencedClass.methodImplementationsAccept(referencedMethod, +// false, +// false, +// true, +// true, +// this); +// } +// } +// } +// +// +// // Implementations for MemberVisitor. +// +// public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) +// { +// mayThrowExceptions = mayThrowExceptions || +// ExceptionMethodMarker.mayThrowExceptions(programMethod); +// } +// +// +// public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) +// { +// mayThrowExceptions = mayThrowExceptions || +// !NoExceptionMethodMarker.doesntThrowExceptions(libraryMethod); +// } +} diff --git a/src/proguard/optimize/info/FieldOptimizationInfo.java b/src/proguard/optimize/info/FieldOptimizationInfo.java new file mode 100644 index 0000000..7a2d068 --- /dev/null +++ b/src/proguard/optimize/info/FieldOptimizationInfo.java @@ -0,0 +1,162 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.MethodLinker; +import proguard.evaluation.value.*; + +/** + * This class stores some optimization information that can be attached to + * a field. + * + * @author Eric Lafortune + */ +public class FieldOptimizationInfo +{ + private static final SpecificValueFactory VALUE_FACTORY = new SpecificValueFactory(); + + private boolean isWritten; + private boolean isRead; + private boolean canBeMadePrivate = true; + private ReferenceValue referencedClass; + private Value value; + + + public FieldOptimizationInfo(Clazz clazz, Field field) + { + isWritten = + isRead = (field.getAccessFlags() & ClassConstants.INTERNAL_ACC_VOLATILE) != 0; + value = initialValue(field.getDescriptor(clazz)); + } + + + public void setWritten() + { + isWritten = true; + } + + + public boolean isWritten() + { + return isWritten; + } + + + public void setRead() + { + isRead = true; + } + + + public boolean isRead() + { + return isRead; + } + + + public void setCanNotBeMadePrivate() + { + canBeMadePrivate = false; + } + + + public boolean canBeMadePrivate() + { + return canBeMadePrivate; + } + + + public void generalizeReferencedClass(ReferenceValue referencedClass) + { + this.referencedClass = this.referencedClass != null ? + this.referencedClass.generalize(referencedClass) : + referencedClass; + } + + + public ReferenceValue getReferencedClass() + { + return referencedClass; + } + + + public void generalizeValue(Value value) + { + this.value = this.value != null ? + this.value.generalize(value) : + value; + } + + + public Value getValue() + { + return value; + } + + + // Small utility methods. + + private Value initialValue(String type) + { + switch (type.charAt(0)) + { + case ClassConstants.INTERNAL_TYPE_BOOLEAN: + case ClassConstants.INTERNAL_TYPE_BYTE: + case ClassConstants.INTERNAL_TYPE_CHAR: + case ClassConstants.INTERNAL_TYPE_SHORT: + case ClassConstants.INTERNAL_TYPE_INT: + return VALUE_FACTORY.createIntegerValue(0); + + case ClassConstants.INTERNAL_TYPE_LONG: + return VALUE_FACTORY.createLongValue(0L); + + case ClassConstants.INTERNAL_TYPE_FLOAT: + return VALUE_FACTORY.createFloatValue(0.0f); + + case ClassConstants.INTERNAL_TYPE_DOUBLE: + return VALUE_FACTORY.createDoubleValue(0.0); + + case ClassConstants.INTERNAL_TYPE_CLASS_START: + case ClassConstants.INTERNAL_TYPE_ARRAY: + return VALUE_FACTORY.createReferenceValueNull(); + + default: + throw new IllegalArgumentException("Invalid type ["+type+"]"); + } + } + + + public static void setFieldOptimizationInfo(Clazz clazz, Field field) + { + MethodLinker.lastMember(field).setVisitorInfo(new FieldOptimizationInfo(clazz, field)); + } + + + public static FieldOptimizationInfo getFieldOptimizationInfo(Field field) + { + Object visitorInfo = MethodLinker.lastMember(field).getVisitorInfo(); + + return visitorInfo instanceof FieldOptimizationInfo ? + (FieldOptimizationInfo)visitorInfo : + null; + } +} diff --git a/src/proguard/optimize/info/InstanceofClassFilter.java b/src/proguard/optimize/info/InstanceofClassFilter.java new file mode 100644 index 0000000..35e1d77 --- /dev/null +++ b/src/proguard/optimize/info/InstanceofClassFilter.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor delegates all its method calls to another ClassVisitor, + * but only for Clazz objects that are used in an 'instanceof' test. + * + * @see InstanceofClassMarker + * @author Eric Lafortune + */ +public class InstanceofClassFilter +implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + public InstanceofClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (InstanceofClassMarker.isInstanceofed(programClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (InstanceofClassMarker.isInstanceofed(libraryClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/InstanceofClassMarker.java b/src/proguard/optimize/info/InstanceofClassMarker.java new file mode 100644 index 0000000..c60e1f8 --- /dev/null +++ b/src/proguard/optimize/info/InstanceofClassMarker.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This InstructionVisitor marks all classes that are used in an 'instanceof' + * test by any of the instructions that it visits. + * + * @author Eric Lafortune + */ +public class InstanceofClassMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + ClassVisitor +{ + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + if (constantInstruction.opcode == InstructionConstants.OP_INSTANCEOF) + { + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + } + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.referencedClassAccept(this); + } + + + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) {} + + public void visitProgramClass(ProgramClass programClass) + { + setInstanceofed(programClass); + } + + + // Small utility methods. + + private static void setInstanceofed(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setInstanceofed(); + } + } + + + public static boolean isInstanceofed(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + return info == null || info.isInstanceofed(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/InstantiationClassFilter.java b/src/proguard/optimize/info/InstantiationClassFilter.java new file mode 100644 index 0000000..a24e617 --- /dev/null +++ b/src/proguard/optimize/info/InstantiationClassFilter.java @@ -0,0 +1,62 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor delegates all its method calls to another ClassVisitor, + * but only for Clazz objects that are instantiated. + * + * @author Eric Lafortune + */ +public class InstantiationClassFilter +implements ClassVisitor +{ + private final ClassVisitor classVisitor; + + + public InstantiationClassFilter(ClassVisitor classVisitor) + { + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (InstantiationClassMarker.isInstantiated(programClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (InstantiationClassMarker.isInstantiated(libraryClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/InstantiationClassMarker.java b/src/proguard/optimize/info/InstantiationClassMarker.java new file mode 100644 index 0000000..124c23b --- /dev/null +++ b/src/proguard/optimize/info/InstantiationClassMarker.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This InstructionVisitor marks all classes that are instantiated by any of + * the instructions that it visits. + * + * @author Eric Lafortune + */ +public class InstantiationClassMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + ClassVisitor +{ + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + if (constantInstruction.opcode == InstructionConstants.OP_NEW) + { + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + } + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classConstant.referencedClassAccept(this); + } + + + // Implementations for ClassVisitor. + + public void visitLibraryClass(LibraryClass libraryClass) {} + + public void visitProgramClass(ProgramClass programClass) + { + setInstantiated(programClass); + } + + + // Small utility methods. + + private static void setInstantiated(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setInstantiated(); + } + } + + + public static boolean isInstantiated(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + return info == null || info.isInstantiated(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/MemberOptimizationInfoSetter.java b/src/proguard/optimize/info/MemberOptimizationInfoSetter.java new file mode 100644 index 0000000..a170a8e --- /dev/null +++ b/src/proguard/optimize/info/MemberOptimizationInfoSetter.java @@ -0,0 +1,59 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.KeepMarker; + +/** + * This MemberVisitor attaches a FieldOptimizationInfo instance to every field + * and a MethodOptimizationInfo instance to every method that is not being kept + * that it visits. + * + * @author Eric Lafortune + */ +public class MemberOptimizationInfoSetter +extends SimplifiedVisitor +implements MemberVisitor +{ + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (!KeepMarker.isKept(programMethod)) + { + MethodOptimizationInfo.setMethodOptimizationInfo(programClass, + programMethod); + } + } + + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (!KeepMarker.isKept(programField)) + { + FieldOptimizationInfo.setFieldOptimizationInfo(programClass, + programField); + } + } +} diff --git a/src/proguard/optimize/info/MethodInvocationMarker.java b/src/proguard/optimize/info/MethodInvocationMarker.java new file mode 100644 index 0000000..2528c94 --- /dev/null +++ b/src/proguard/optimize/info/MethodInvocationMarker.java @@ -0,0 +1,107 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This InstructionVisitor counts the number of times methods are invoked from + * the instructions that are visited. + * + * @author Eric Lafortune + */ +public class MethodInvocationMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + MemberVisitor +{ + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Mark the referenced method, if any. + stringConstant.referencedMemberAccept(this); + } + + + public void visitAnyMethodrefConstant(Clazz clazz, RefConstant refConstant) + { + // Mark the referenced method. + refConstant.referencedMemberAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz Clazz, Member member) {} + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + incrementInvocationCount(programMethod); + } + + + // Small utility methods. + + private static void incrementInvocationCount(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.incrementInvocationCount(); + } + } + + + /** + * Returns the number of times the given method was invoked by the + * instructions that were visited. + */ + public static int getInvocationCount(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null ? info.getInvocationCount() : + Integer.MAX_VALUE; + } +} diff --git a/src/proguard/optimize/info/MethodOptimizationInfo.java b/src/proguard/optimize/info/MethodOptimizationInfo.java new file mode 100644 index 0000000..d3b1bde --- /dev/null +++ b/src/proguard/optimize/info/MethodOptimizationInfo.java @@ -0,0 +1,302 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.evaluation.value.Value; + +/** + * This class stores some optimization information that can be attached to + * a method. + * + * @author Eric Lafortune + */ +public class MethodOptimizationInfo +{ + private boolean hasNoSideEffects = false; + private boolean hasSideEffects = false; + private boolean canBeMadePrivate = true; + private boolean catchesExceptions = false; + private boolean branchesBackward = false; + private boolean invokesSuperMethods = false; + private boolean accessesPrivateCode = false; + private boolean accessesPackageCode = false; + private boolean accessesProtectedCode = false; + private int invocationCount = 0; + private int parameterSize = 0; + private long usedParameters = 0L; + private Value[] parameters; + private Value returnValue; + + + /** + * Creates a new MethodOptimizationInfo for the given method. + */ + public MethodOptimizationInfo(Clazz clazz, Method method) + { + // Set up an array of the right size for storing information about the + // passed parameters. + int parameterCount = + ClassUtil.internalMethodParameterCount(method.getDescriptor(clazz)); + + if ((method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) == 0) + { + parameterCount++; + } + + if (parameterCount > 0) + { + parameters = new Value[parameterCount]; + } + } + + + public void setNoSideEffects() + { + hasNoSideEffects = true; + } + + + public boolean hasNoSideEffects() + { + return hasNoSideEffects; + } + + + public void setSideEffects() + { + hasSideEffects = true; + } + + + public boolean hasSideEffects() + { + return hasSideEffects; + } + + + public void setCanNotBeMadePrivate() + { + canBeMadePrivate = false; + } + + + public boolean canBeMadePrivate() + { + return canBeMadePrivate; + } + + + public void setCatchesExceptions() + { + catchesExceptions = true; + } + + + public boolean catchesExceptions() + { + return catchesExceptions; + } + + + public void setBranchesBackward() + { + branchesBackward = true; + } + + + public boolean branchesBackward() + { + return branchesBackward; + } + + + public void setInvokesSuperMethods() + { + invokesSuperMethods = true; + } + + + public boolean invokesSuperMethods() + { + return invokesSuperMethods; + } + + + public void setAccessesPrivateCode() + { + accessesPrivateCode = true; + } + + + public boolean accessesPrivateCode() + { + return accessesPrivateCode; + } + + + public void setAccessesPackageCode() + { + accessesPackageCode = true; + } + + + public boolean accessesPackageCode() + { + return accessesPackageCode; + } + + + public void setAccessesProtectedCode() + { + accessesProtectedCode = true; + } + + + public boolean accessesProtectedCode() + { + return accessesProtectedCode; + } + + + public void incrementInvocationCount() + { + invocationCount++; + } + + + public int getInvocationCount() + { + return invocationCount; + } + + + public void setParameterSize(int parameterSize) + { + this.parameterSize = parameterSize; + } + + + public int getParameterSize() + { + return parameterSize; + } + + + public void setParameterUsed(int parameterIndex) + { + usedParameters |= 1 << parameterIndex; + } + + + public void setUsedParameters(long usedParameters) + { + this.usedParameters = usedParameters; + } + + + public boolean isParameterUsed(int parameterIndex) + { + return parameterIndex >= 64 || (usedParameters & (1 << parameterIndex)) != 0; + } + + + public long getUsedParameters() + { + return usedParameters; + } + + + public void generalizeParameter(int parameterIndex, Value parameter) + { + parameters[parameterIndex] = parameters[parameterIndex] != null ? + parameters[parameterIndex].generalize(parameter) : + parameter; + } + + + public Value getParameter(int parameterIndex) + { + return parameters != null ? + parameters[parameterIndex] : + null; + } + + + public void generalizeReturnValue(Value returnValue) + { + this.returnValue = this.returnValue != null ? + this.returnValue.generalize(returnValue) : + returnValue; + } + + + public Value getReturnValue() + { + return returnValue; + } + + + public void merge(MethodOptimizationInfo other) + { + if (other != null) + { + this.hasNoSideEffects &= other.hasNoSideEffects; + this.hasSideEffects |= other.hasSideEffects; + //this.canBeMadePrivate &= other.canBeMadePrivate; + this.catchesExceptions |= other.catchesExceptions; + this.branchesBackward |= other.branchesBackward; + this.invokesSuperMethods |= other.invokesSuperMethods; + this.accessesPrivateCode |= other.accessesPrivateCode; + this.accessesPackageCode |= other.accessesPackageCode; + this.accessesProtectedCode |= other.accessesProtectedCode; + } + else + { + this.hasNoSideEffects = false; + this.hasSideEffects = true; + //this.canBeMadePrivate = false; + this.catchesExceptions = true; + this.branchesBackward = true; + this.invokesSuperMethods = true; + this.accessesPrivateCode = true; + this.accessesPackageCode = true; + this.accessesProtectedCode = true; + } + } + + + public static void setMethodOptimizationInfo(Clazz clazz, Method method) + { + MethodLinker.lastMember(method).setVisitorInfo(new MethodOptimizationInfo(clazz, method)); + } + + + public static MethodOptimizationInfo getMethodOptimizationInfo(Method method) + { + Object visitorInfo = MethodLinker.lastMember(method).getVisitorInfo(); + + return visitorInfo instanceof MethodOptimizationInfo ? + (MethodOptimizationInfo)visitorInfo : + null; + } +} diff --git a/src/proguard/optimize/info/NoSideEffectMethodMarker.java b/src/proguard/optimize/info/NoSideEffectMethodMarker.java new file mode 100644 index 0000000..5c78408 --- /dev/null +++ b/src/proguard/optimize/info/NoSideEffectMethodMarker.java @@ -0,0 +1,91 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This MemberVisitor marks all methods that it visits as not having any side + * effects. It will make the SideEffectMethodMarker consider them as such + * without further analysis. + * + * @see SideEffectMethodMarker + * @author Eric Lafortune + */ +public class NoSideEffectMethodMarker +extends SimplifiedVisitor +implements MemberVisitor +{ + // A visitor info flag to indicate the visitor accepter is being kept, + // but that it doesn't have any side effects. + private static final Object KEPT_BUT_NO_SIDE_EFFECTS = new Object(); + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz Clazz, Member member) + { + // Ignore any attempts to mark fields. + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + markNoSideEffects(programMethod); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + markNoSideEffects(libraryMethod); + } + + + // Small utility methods. + + private static void markNoSideEffects(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setNoSideEffects(); + } + else + { + MethodLinker.lastMember(method).setVisitorInfo(KEPT_BUT_NO_SIDE_EFFECTS); + } + } + + + public static boolean hasNoSideEffects(Method method) + { + if (MethodLinker.lastVisitorAccepter(method).getVisitorInfo() == KEPT_BUT_NO_SIDE_EFFECTS) + { + return true; + } + + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null && + info.hasNoSideEffects(); + } +} diff --git a/src/proguard/optimize/info/NonPrivateMemberMarker.java b/src/proguard/optimize/info/NonPrivateMemberMarker.java new file mode 100644 index 0000000..d451643 --- /dev/null +++ b/src/proguard/optimize/info/NonPrivateMemberMarker.java @@ -0,0 +1,177 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor marks all class members that can not be made private in the + * classes that it visits, and in the classes to which they refer. + * + * @author Eric Lafortune + */ +public class NonPrivateMemberMarker +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor +{ + private final MethodImplementationFilter filteredMethodMarker = new MethodImplementationFilter(this); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Mark all referenced class members in different classes. + programClass.constantPoolEntriesAccept(this); + + // Explicitly mark the method. + programClass.methodAccept(ClassConstants.INTERNAL_METHOD_NAME_CLINIT, + ClassConstants.INTERNAL_METHOD_TYPE_CLINIT, + this); + + // Explicitly mark the parameterless method. + programClass.methodAccept(ClassConstants.INTERNAL_METHOD_NAME_INIT, + ClassConstants.INTERNAL_METHOD_TYPE_INIT, + this); + + // Mark all methods that may have implementations. + programClass.methodsAccept(filteredMethodMarker); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Go over all methods. + libraryClass.methodsAccept(this); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + Clazz referencedClass = stringConstant.referencedClass; + + // Is it refering to another class or class member? + if (referencedClass != null && + !referencedClass.equals(clazz)) + { + // The referenced class member, if any, can never be made private. + stringConstant.referencedMemberAccept(this); + } + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + Clazz referencedClass = refConstant.referencedClass; + + // Is it refering to a class member in another class? + // The class member might be in another class, or + // it may be referenced through another class. + if (referencedClass != null && + !referencedClass.equals(clazz) || + !refConstant.getClassName(clazz).equals(clazz.getName())) + { + // The referenced class member can never be made private. + refConstant.referencedMemberAccept(this); + } + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + markCanNotBeMadePrivate(programField); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + markCanNotBeMadePrivate(libraryField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + markCanNotBeMadePrivate(programMethod); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + markCanNotBeMadePrivate(libraryMethod); + } + + + // Small utility methods. + + private static void markCanNotBeMadePrivate(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + if (info != null) + { + info.setCanNotBeMadePrivate(); + } + } + + + /** + * Returns whether the given field can be made private. + */ + public static boolean canBeMadePrivate(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + return info != null && + info.canBeMadePrivate(); + } + + + private static void markCanNotBeMadePrivate(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setCanNotBeMadePrivate(); + } + } + + + /** + * Returns whether the given method can be made private. + */ + public static boolean canBeMadePrivate(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null && + info.canBeMadePrivate(); + } +} diff --git a/src/proguard/optimize/info/PackageVisibleMemberContainingClassMarker.java b/src/proguard/optimize/info/PackageVisibleMemberContainingClassMarker.java new file mode 100644 index 0000000..d40bc6b --- /dev/null +++ b/src/proguard/optimize/info/PackageVisibleMemberContainingClassMarker.java @@ -0,0 +1,67 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This MemberVisitor marks all classes that contain visited package visible + * members. + * + * @author Eric Lafortune + */ +public class PackageVisibleMemberContainingClassMarker +extends SimplifiedVisitor +implements MemberVisitor +{ + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz clazz, Member member) + { + if ((member.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_PUBLIC)) == 0) + { + setPackageVisibleMembers(clazz); + } + } + + + // Small utility methods. + + private static void setPackageVisibleMembers(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setContainsPackageVisibleMembers(); + } + } + + + public static boolean containsPackageVisibleMembers(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + return info == null || info.containsPackageVisibleMembers(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/PackageVisibleMemberInvokingClassMarker.java b/src/proguard/optimize/info/PackageVisibleMemberInvokingClassMarker.java new file mode 100644 index 0000000..9ec8ec6 --- /dev/null +++ b/src/proguard/optimize/info/PackageVisibleMemberInvokingClassMarker.java @@ -0,0 +1,81 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This ConstantVisitor marks all classes that invoke package visible members + * in other classes. + * + * @author Eric Lafortune + */ +public class PackageVisibleMemberInvokingClassMarker +extends SimplifiedVisitor +implements ConstantVisitor +{ + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + Clazz referencedClass = refConstant.referencedClass; + if (referencedClass != null && + (referencedClass.getAccessFlags() & + ClassConstants.INTERNAL_ACC_PUBLIC) == 0) + { + setInvokesPackageVisibleMembers(clazz); + } + + Member referencedMember = refConstant.referencedMember; + if (referencedMember != null && + (referencedMember.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_PUBLIC | + ClassConstants.INTERNAL_ACC_PRIVATE)) == 0) + { + setInvokesPackageVisibleMembers(clazz); + } + } + + + // Small utility methods. + + private static void setInvokesPackageVisibleMembers(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setInvokesPackageVisibleMembers(); + } + } + + + public static boolean invokesPackageVisibleMembers(Clazz clazz) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + return info == null || info.invokesPackageVisibleMembers(); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/info/ParameterUsageMarker.java b/src/proguard/optimize/info/ParameterUsageMarker.java new file mode 100644 index 0000000..15ce88a --- /dev/null +++ b/src/proguard/optimize/info/ParameterUsageMarker.java @@ -0,0 +1,285 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.attribute.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.evaluation.PartialEvaluator; +import proguard.evaluation.value.*; + +/** + * This MemberVisitor counts the parameters and marks the used parameters + * of the methods that it visits. It also marks the 'this' parameters of + * methods that have hierarchies. + * + * @author Eric Lafortune + */ +public class ParameterUsageMarker +extends SimplifiedVisitor +implements MemberVisitor, + AttributeVisitor, + InstructionVisitor +{ + private static final boolean DEBUG = false; + + + private final boolean markThisParameter; + private final boolean markAllParameters; + private final PartialEvaluator partialEvaluator = new PartialEvaluator(); + + + /** + * Creates a new ParameterUsageMarker. + */ + public ParameterUsageMarker() + { + this(false, false); + } + + + /** + * Creates a new ParameterUsageMarker that optionally marks all parameters. + * @param markThisParameter specifies whether all 'this' parameters should + * be marked as being used. + * @param markAllParameters specifies whether all other parameters should + * be marked as being used. + */ + public ParameterUsageMarker(boolean markThisParameter, + boolean markAllParameters) + { + this.markThisParameter = markThisParameter; + this.markAllParameters = markAllParameters; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + int parameterSize = + ClassUtil.internalMethodParameterSize(programMethod.getDescriptor(programClass), + programMethod.getAccessFlags()); + + if (parameterSize > 0) + { + int accessFlags = programMethod.getAccessFlags(); + + // Must we mark the 'this' parameter? + if (markThisParameter && + (accessFlags & ClassConstants.INTERNAL_ACC_STATIC) == 0) + { + // Mark the 'this' parameter. + markParameterUsed(programMethod, 0); + } + + // Must we mark all other parameters? + if (markAllParameters) + { + // Mark all parameters, without the 'this' parameter. + markUsedParameters(programMethod, + (accessFlags & ClassConstants.INTERNAL_ACC_STATIC) != 0 ? + -1L : -2L); + } + + // Is it a native method? + if ((accessFlags & ClassConstants.INTERNAL_ACC_NATIVE) != 0) + { + // Mark all parameters. + markUsedParameters(programMethod, -1L); + } + + // Is it an abstract method? + else if ((accessFlags & ClassConstants.INTERNAL_ACC_ABSTRACT) != 0) + { + // Mark the 'this' parameter. + markParameterUsed(programMethod, 0); + } + + // Is it a non-native, concrete method? + else + { + // Is the method not static, but synchronized, or can it have + // other implementations, or is it a class instance initializer? + if ((accessFlags & ClassConstants.INTERNAL_ACC_STATIC) == 0 && + ((accessFlags & ClassConstants.INTERNAL_ACC_SYNCHRONIZED) != 0 || + programClass.mayHaveImplementations(programMethod) || + programMethod.getName(programClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT))) + { + // Mark the 'this' parameter. + markParameterUsed(programMethod, 0); + } + + // Mark the parameters that are used by the code. + programMethod.attributesAccept(programClass, this); + } + + if (DEBUG) + { + System.out.print("ParameterUsageMarker: ["+programClass.getName() +"."+programMethod.getName(programClass)+programMethod.getDescriptor(programClass)+"]: "); + for (int index = 0; index < parameterSize; index++) + { + System.out.print(isParameterUsed(programMethod, index) ? '+' : '-'); + } + System.out.println(); + } + + } + + // Set the parameter size. + setParameterSize(programMethod, parameterSize); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Can the method have other implementations? + if (libraryClass.mayHaveImplementations(libraryMethod)) + { + // All implementations must keep all parameters of this method, + // including the 'this' parameter. + markUsedParameters(libraryMethod, -1L); + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Evaluate the code. + partialEvaluator.visitCodeAttribute(clazz, method, codeAttribute); + + // Mark the parameters that are used by the code. + codeAttribute.instructionsAccept(clazz, method, this); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + if (partialEvaluator.isTraced(offset) && + variableInstruction.isLoad()) + { + int parameterIndex = variableInstruction.variableIndex; + if (parameterIndex < codeAttribute.u2maxLocals) + { + Value producer = + partialEvaluator.getVariablesBefore(offset).getProducerValue(parameterIndex); + if (producer != null && + producer.instructionOffsetValue().contains(PartialEvaluator.AT_METHOD_ENTRY)) + { + // Mark the variable. + markParameterUsed(method, parameterIndex); + + // Account for Category 2 instructions, which take up two entries. + if (variableInstruction.isCategory2()) + { + markParameterUsed(method, parameterIndex + 1); + } + } + } + } + } + + + // Small utility methods. + + /** + * Sets the total size of the parameters. + */ + private static void setParameterSize(Method method, int parameterSize) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setParameterSize(parameterSize); + } + } + + + /** + * Returns the total size of the parameters. + */ + public static int getParameterSize(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null ? info.getParameterSize() : 0; + } + + + /** + * Marks the given parameter as being used. + */ + public static void markParameterUsed(Method method, int variableIndex) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setParameterUsed(variableIndex); + } + } + + + /** + * Marks the given parameters as being used. + */ + public static void markUsedParameters(Method method, long usedParameters) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setUsedParameters(info.getUsedParameters() | usedParameters); + } + } + + + /** + * Returns whether the given parameter is being used. + */ + public static boolean isParameterUsed(Method method, int variableIndex) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || + info.isParameterUsed(variableIndex); + } + + + /** + * Returns which parameters are being used. + */ + public static long getUsedParameters(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info != null ? info.getUsedParameters() : -1L; + } +} diff --git a/src/proguard/optimize/info/ReadWriteFieldMarker.java b/src/proguard/optimize/info/ReadWriteFieldMarker.java new file mode 100644 index 0000000..57d8561 --- /dev/null +++ b/src/proguard/optimize/info/ReadWriteFieldMarker.java @@ -0,0 +1,163 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This InstructionVisitor marks all fields that are write-only. + * + * @author Eric Lafortune + */ +public class ReadWriteFieldMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + MemberVisitor +{ + // Parameters for the visitor methods. + private boolean reading = true; + private boolean writing = true; + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + byte opcode = constantInstruction.opcode; + + // Check for instructions that involve fields. + switch (opcode) + { + case InstructionConstants.OP_LDC: + case InstructionConstants.OP_LDC_W: + // Mark the field, if any, as being read from and written to. + reading = true; + writing = true; + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + break; + + case InstructionConstants.OP_GETSTATIC: + case InstructionConstants.OP_GETFIELD: + // Mark the field as being read from. + reading = true; + writing = false; + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + break; + + case InstructionConstants.OP_PUTSTATIC: + case InstructionConstants.OP_PUTFIELD: + // Mark the field as being written to. + reading = false; + writing = true; + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + break; + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Mark the referenced field, if any. + stringConstant.referencedMemberAccept(this); + } + + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + // Mark the referenced field. + fieldrefConstant.referencedMemberAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz Clazz, Member member) {} + + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Mark the field if it is being read from. + if (reading) + { + markAsRead(programField); + } + + // Mark the field if it is being written to. + if (writing) + { + markAsWritten(programField); + } + } + + + // Small utility methods. + + private static void markAsRead(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + if (info != null) + { + info.setRead(); + } + } + + + public static boolean isRead(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + return info == null || + info.isRead(); + } + + + private static void markAsWritten(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + if (info != null) + { + info.setWritten(); + } + } + + + public static boolean isWritten(Field field) + { + FieldOptimizationInfo info = FieldOptimizationInfo.getFieldOptimizationInfo(field); + return info == null || + info.isWritten(); + } +} diff --git a/src/proguard/optimize/info/SideEffectInstructionChecker.java b/src/proguard/optimize/info/SideEffectInstructionChecker.java new file mode 100644 index 0000000..8be9dc1 --- /dev/null +++ b/src/proguard/optimize/info/SideEffectInstructionChecker.java @@ -0,0 +1,224 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This class can tell whether an instruction has any side effects. Return + * instructions can be included or not. + * + * @see ReadWriteFieldMarker + * @see NoSideEffectMethodMarker + * @see SideEffectMethodMarker + * @author Eric Lafortune + */ +public class SideEffectInstructionChecker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor, + MemberVisitor +{ + private final boolean includeReturnInstructions; + + // A return value for the visitor methods. + private boolean hasSideEffects; + + + public SideEffectInstructionChecker(boolean includeReturnInstructions) + { + this.includeReturnInstructions = includeReturnInstructions; + } + + + public boolean hasSideEffects(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + hasSideEffects = false; + + instruction.accept(clazz, method, codeAttribute, offset, this); + + return hasSideEffects; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + byte opcode = simpleInstruction.opcode; + + // Check for instructions that might cause side effects. + if (opcode == InstructionConstants.OP_IASTORE || + opcode == InstructionConstants.OP_LASTORE || + opcode == InstructionConstants.OP_FASTORE || + opcode == InstructionConstants.OP_DASTORE || + opcode == InstructionConstants.OP_AASTORE || + opcode == InstructionConstants.OP_BASTORE || + opcode == InstructionConstants.OP_CASTORE || + opcode == InstructionConstants.OP_SASTORE || + opcode == InstructionConstants.OP_ATHROW || + opcode == InstructionConstants.OP_MONITORENTER || + opcode == InstructionConstants.OP_MONITOREXIT || + (includeReturnInstructions && + (opcode == InstructionConstants.OP_IRETURN || + opcode == InstructionConstants.OP_LRETURN || + opcode == InstructionConstants.OP_FRETURN || + opcode == InstructionConstants.OP_DRETURN || + opcode == InstructionConstants.OP_ARETURN || + opcode == InstructionConstants.OP_RETURN))) + { + // These instructions always cause a side effect. + hasSideEffects = true; + } + + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + byte opcode = variableInstruction.opcode; + + // Check for instructions that might cause side effects. + if (includeReturnInstructions && + opcode == InstructionConstants.OP_RET) + { + hasSideEffects = true; + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + byte opcode = constantInstruction.opcode; + + // Check for instructions that might cause side effects. + if (opcode == InstructionConstants.OP_PUTSTATIC || + opcode == InstructionConstants.OP_PUTFIELD || + opcode == InstructionConstants.OP_INVOKEVIRTUAL || + opcode == InstructionConstants.OP_INVOKESPECIAL || + opcode == InstructionConstants.OP_INVOKESTATIC || + opcode == InstructionConstants.OP_INVOKEINTERFACE) + { + // Check if the field is write-only or volatile, or if the invoked + // method is causing any side effects. + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + byte opcode = branchInstruction.opcode; + + // Check for instructions that might cause side effects. + if (includeReturnInstructions && + (opcode == InstructionConstants.OP_JSR || + opcode == InstructionConstants.OP_JSR_W)) + { + hasSideEffects = true; + } + } + + + // Implementations for ConstantVisitor. + + public void visitFieldrefConstant(Clazz clazz, FieldrefConstant fieldrefConstant) + { + // We'll have to assume accessing an unknown field has side effects. + hasSideEffects = true; + + // Check the referenced field. + fieldrefConstant.referencedMemberAccept(this); + } + + + public void visitAnyMethodrefConstant(Clazz clazz, RefConstant refConstant) + { + Member referencedMember = refConstant.referencedMember; + + // Do we have a reference to the method? + if (referencedMember == null) + { + // We'll have to assume invoking the unknown method has side effects. + hasSideEffects = true; + } + else + { + // First check the referenced method itself. + refConstant.referencedMemberAccept(this); + + // If the result isn't conclusive, check down the hierarchy. + if (!hasSideEffects) + { + Clazz referencedClass = refConstant.referencedClass; + Method referencedMethod = (Method)referencedMember; + + // Check all other implementations of the method down the class + // hierarchy. + if ((referencedMethod.getAccessFlags() & ClassConstants.INTERNAL_ACC_PRIVATE) == 0) + { + clazz.hierarchyAccept(false, false, false, true, + new NamedMethodVisitor(referencedMethod.getName(referencedClass), + referencedMethod.getDescriptor(referencedClass), + this)); + } + } + } + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + hasSideEffects = ReadWriteFieldMarker.isRead(programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + hasSideEffects = hasSideEffects || + SideEffectMethodMarker.hasSideEffects(programMethod); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + hasSideEffects = true; + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + hasSideEffects = hasSideEffects || + !NoSideEffectMethodMarker.hasNoSideEffects(libraryMethod); + } +} diff --git a/src/proguard/optimize/info/SideEffectMethodMarker.java b/src/proguard/optimize/info/SideEffectMethodMarker.java new file mode 100644 index 0000000..25fda72 --- /dev/null +++ b/src/proguard/optimize/info/SideEffectMethodMarker.java @@ -0,0 +1,175 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassPoolVisitor marks all methods that have side effects. + * + * @see ReadWriteFieldMarker + * @see NoSideEffectMethodMarker + * @author Eric Lafortune + */ +public class SideEffectMethodMarker +extends SimplifiedVisitor +implements ClassPoolVisitor, + ClassVisitor, + MemberVisitor, + AttributeVisitor +{ + // A reusable object for checking whether instructions have side effects. + private final SideEffectInstructionChecker sideEffectInstructionChecker = new SideEffectInstructionChecker(false); + + // Parameters and values for visitor methods. + private int newSideEffectCount; + private boolean hasSideEffects; + + + // Implementations for ClassPoolVisitor. + + public void visitClassPool(ClassPool classPool) + { + // Go over all classes and their methods, marking if they have side + // effects, until no new cases can be found. + do + { + newSideEffectCount = 0; + + // Go over all classes and their methods once. + classPool.classesAccept(this); + } + while (newSideEffectCount > 0); + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Go over all methods. + programClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (!hasSideEffects(programMethod) && + !NoSideEffectMethodMarker.hasNoSideEffects(programMethod)) + { + // Initialize the return value. + hasSideEffects = + (programMethod.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_NATIVE | + ClassConstants.INTERNAL_ACC_SYNCHRONIZED)) != 0; + + // Look further if the method hasn't been marked yet. + if (!hasSideEffects) + { + // Investigate the actual code. + programMethod.attributesAccept(programClass, this); + } + + // Mark the method depending on the return value. + if (hasSideEffects) + { + markSideEffects(programMethod); + + newSideEffectCount++; + } + } + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Remember whether the code has any side effects. + hasSideEffects = hasSideEffects(clazz, method, codeAttribute); + } + + + // Small utility methods. + + /** + * Returns whether the given code has any side effects. + */ + private boolean hasSideEffects(Clazz clazz, + Method method, + CodeAttribute codeAttribute) + { + byte[] code = codeAttribute.code; + int length = codeAttribute.u4codeLength; + + // Go over all instructions. + int offset = 0; + do + { + // Get the current instruction. + Instruction instruction = InstructionFactory.create(code, offset); + + // Check if it may be throwing exceptions. + if (sideEffectInstructionChecker.hasSideEffects(clazz, + method, + codeAttribute, + offset, + instruction)) + { + return true; + } + + // Go to the next instruction. + offset += instruction.length(offset); + } + while (offset < length); + + return false; + } + + + private static void markSideEffects(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setSideEffects(); + } + } + + + public static boolean hasSideEffects(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || + info.hasSideEffects(); + } +} diff --git a/src/proguard/optimize/info/SuperInvocationMarker.java b/src/proguard/optimize/info/SuperInvocationMarker.java new file mode 100644 index 0000000..6f3d3bd --- /dev/null +++ b/src/proguard/optimize/info/SuperInvocationMarker.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.RefConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor marks all methods that invoke super methods (other + * than initializers) from the instructions that it visits. + * + * @author Eric Lafortune + */ +public class SuperInvocationMarker +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor +{ + private boolean invokesSuperMethods; + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + if (constantInstruction.opcode == InstructionConstants.OP_INVOKESPECIAL) + { + invokesSuperMethods = false; + + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + + if (invokesSuperMethods) + { + setInvokesSuperMethods(method); + } + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyMethodrefConstant(Clazz clazz, RefConstant refConstant) + { + invokesSuperMethods = + !clazz.equals(refConstant.referencedClass) && + !refConstant.getName(clazz).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT); + } + + + // Small utility methods. + + private static void setInvokesSuperMethods(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + if (info != null) + { + info.setInvokesSuperMethods(); + } + } + + + public static boolean invokesSuperMethods(Method method) + { + MethodOptimizationInfo info = MethodOptimizationInfo.getMethodOptimizationInfo(method); + return info == null || info.invokesSuperMethods(); + } +} diff --git a/src/proguard/optimize/info/VariableUsageMarker.java b/src/proguard/optimize/info/VariableUsageMarker.java new file mode 100644 index 0000000..660c4ba --- /dev/null +++ b/src/proguard/optimize/info/VariableUsageMarker.java @@ -0,0 +1,95 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.info; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor marks the local variables that are used in the code + * attributes that it visits. + * + * @author Eric Lafortune + */ +public class VariableUsageMarker +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor +{ + private boolean[] variableUsed = new boolean[ClassConstants.TYPICAL_VARIABLES_SIZE]; + + + /** + * Returns whether the given variable has been marked as being used. + */ + public boolean isVariableUsed(int variableIndex) + { + return variableUsed[variableIndex]; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + int maxLocals = codeAttribute.u2maxLocals; + + // Try to reuse the previous array. + if (variableUsed.length < maxLocals) + { + variableUsed = new boolean[maxLocals]; + } + else + { + for (int index = 0; index < maxLocals; index++) + { + variableUsed[index] = false; + } + } + + codeAttribute.instructionsAccept(clazz, method, this); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + // Mark the variable. + variableUsed[variableInstruction.variableIndex] = true; + + // Account for Category 2 instructions, which take up two entries. + if (variableInstruction.isCategory2()) + { + variableUsed[variableInstruction.variableIndex + 1] = true; + } + } +} diff --git a/src/proguard/optimize/info/package.html b/src/proguard/optimize/info/package.html new file mode 100644 index 0000000..d16486e --- /dev/null +++ b/src/proguard/optimize/info/package.html @@ -0,0 +1,4 @@ + +This package contains classes to collect additional information about classes +and class members, which can then be used for optimization. + diff --git a/src/proguard/optimize/package.html b/src/proguard/optimize/package.html new file mode 100644 index 0000000..3ee1353 --- /dev/null +++ b/src/proguard/optimize/package.html @@ -0,0 +1,4 @@ + +This package contains visitors that assist with various optimizations of byte +code. + diff --git a/src/proguard/optimize/peephole/BranchTargetFinder.java b/src/proguard/optimize/peephole/BranchTargetFinder.java new file mode 100644 index 0000000..8f650bb --- /dev/null +++ b/src/proguard/optimize/peephole/BranchTargetFinder.java @@ -0,0 +1,691 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor finds all instruction offsets, branch targets, and + * exception targets in the CodeAttribute objects that it visits. + * + * @author Eric Lafortune + */ +public class BranchTargetFinder +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor, + ConstantVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + public static final int NONE = -2; + public static final int AT_METHOD_ENTRY = -1; + + private static final short INSTRUCTION = 1 << 0; + private static final short BRANCH_ORIGIN = 1 << 1; + private static final short BRANCH_TARGET = 1 << 2; + private static final short AFTER_BRANCH = 1 << 3; + private static final short EXCEPTION_START = 1 << 4; + private static final short EXCEPTION_END = 1 << 5; + private static final short EXCEPTION_HANDLER = 1 << 6; + private static final short SUBROUTINE_INVOCATION = 1 << 7; + private static final short SUBROUTINE_RETURNING = 1 << 8; + + private static final int MAXIMUM_CREATION_OFFSETS = 32; + + + private short[] instructionMarks = new short[ClassConstants.TYPICAL_CODE_LENGTH + 1]; + private int[] subroutineStarts = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] subroutineEnds = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] creationOffsets = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private int[] initializationOffsets = new int[ClassConstants.TYPICAL_CODE_LENGTH]; + private int superInitializationOffset; + + private int currentSubroutineStart; + private int currentSubroutineEnd; + private int[] recentCreationOffsets = new int[MAXIMUM_CREATION_OFFSETS]; + private int recentCreationOffsetIndex; + private boolean isInitializer; + + + /** + * Returns whether there is an instruction at the given offset in the + * CodeAttribute that was visited most recently. + */ + public boolean isInstruction(int offset) + { + return (instructionMarks[offset] & INSTRUCTION) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the target of + * any kind in the CodeAttribute that was visited most recently. + */ + public boolean isTarget(int offset) + { + return offset == 0 || + (instructionMarks[offset] & (BRANCH_TARGET | + EXCEPTION_START | + EXCEPTION_END | + EXCEPTION_HANDLER)) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the origin of a + * branch instruction in the CodeAttribute that was visited most recently. + */ + public boolean isBranchOrigin(int offset) + { + return (instructionMarks[offset] & BRANCH_ORIGIN) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the target of a + * branch instruction in the CodeAttribute that was visited most recently. + */ + public boolean isBranchTarget(int offset) + { + return (instructionMarks[offset] & BRANCH_TARGET) != 0; + } + + + /** + * Returns whether the instruction at the given offset comes right after a + * definite branch instruction in the CodeAttribute that was visited most + * recently. + */ + public boolean isAfterBranch(int offset) + { + return (instructionMarks[offset] & AFTER_BRANCH) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the start of an + * exception try block in the CodeAttribute that was visited most recently. + */ + public boolean isExceptionStart(int offset) + { + return (instructionMarks[offset] & EXCEPTION_START) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the end of an + * exception try block in the CodeAttribute that was visited most recently. + */ + public boolean isExceptionEnd(int offset) + { + return (instructionMarks[offset] & EXCEPTION_END) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the start of an + * exception catch block in the CodeAttribute that was visited most recently. + */ + public boolean isExceptionHandler(int offset) + { + return (instructionMarks[offset] & EXCEPTION_HANDLER) != 0; + } + + + /** + * Returns whether the instruction at the given offset is a subroutine + * invocation in the CodeAttribute that was visited most recently. + */ + public boolean isSubroutineInvocation(int offset) + { + return (instructionMarks[offset] & SUBROUTINE_INVOCATION) != 0; + } + + + /** + * Returns whether the instruction at the given offset is the start of a + * subroutine in the CodeAttribute that was visited most recently. + */ + public boolean isSubroutineStart(int offset) + { + return subroutineStarts[offset] == offset; + } + + + /** + * Returns whether the instruction at the given offset is part of a + * subroutine in the CodeAttribute that was visited most recently. + */ + public boolean isSubroutine(int offset) + { + return subroutineStarts[offset] != NONE; + } + + + /** + * Returns whether the subroutine at the given offset is ever returning + * by means of a regular 'ret' instruction. + */ + public boolean isSubroutineReturning(int offset) + { + return (instructionMarks[offset] & SUBROUTINE_RETURNING) != 0; + } + + + /** + * Returns the start offset of the subroutine at the given offset, in the + * CodeAttribute that was visited most recently. + */ + public int subroutineStart(int offset) + { + return subroutineStarts[offset]; + } + + + /** + * Returns the offset after the subroutine at the given offset, in the + * CodeAttribute that was visited most recently. + */ + public int subroutineEnd(int offset) + { + return subroutineEnds[offset]; + } + + + /** + * Returns whether the instruction at the given offset is a 'new' + * instruction, in the CodeAttribute that was visited most recently. + */ + public boolean isNew(int offset) + { + return initializationOffsets[offset] != NONE; + } + + + /** + * Returns the instruction offset at which the object instance that is + * created at the given 'new' instruction offset is initialized, or + * NONE if it is not being created. + */ + public int initializationOffset(int offset) + { + return initializationOffsets[offset]; + } + + + /** + * Returns whether the method is an instance initializer, in the + * CodeAttribute that was visited most recently. + */ + public boolean isInitializer() + { + return superInitializationOffset != NONE; + } + + + /** + * Returns the instruction offset at which this initializer is calling + * the "super" or "this" initializer method, or NONE if it is + * not an initializer. + */ + public int superInitializationOffset() + { + return superInitializationOffset; + } + + + /** + * Returns whether the instruction at the given offset is the special + * invocation of an instance initializer, in the CodeAttribute that was + * visited most recently. + */ + public boolean isInitializer(int offset) + { + return creationOffsets[offset] != NONE; + } + + + /** + * Returns the offset of the 'new' instruction that corresponds to the + * invocation of the instance initializer at the given offset, or + * AT_METHOD_ENTRY if the invocation is calling the "super" or + * "this" initializer method, , or NONE if it is not a 'new' + * instruction. + */ + public int creationOffset(int offset) + { + return creationOffsets[offset]; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // Make sure there are sufficiently large arrays. + int codeLength = codeAttribute.u4codeLength; + if (subroutineStarts.length < codeLength) + { + // Create new arrays. + instructionMarks = new short[codeLength + 1]; + subroutineStarts = new int[codeLength]; + subroutineEnds = new int[codeLength]; + creationOffsets = new int[codeLength]; + initializationOffsets = new int[codeLength]; + + // Reset the arrays. + for (int index = 0; index < codeLength; index++) + { + subroutineStarts[index] = NONE; + subroutineEnds[index] = NONE; + creationOffsets[index] = NONE; + initializationOffsets[index] = NONE; + } + } + else + { + // Reset the arrays. + for (int index = 0; index < codeLength; index++) + { + instructionMarks[index] = 0; + subroutineStarts[index] = NONE; + subroutineEnds[index] = NONE; + creationOffsets[index] = NONE; + initializationOffsets[index] = NONE; + } + + instructionMarks[codeLength] = 0; + } + + superInitializationOffset = NONE; + + // We're assuming all subroutines are contiguous blocks of code. + // We're not starting in a subroutine. + currentSubroutineStart = NONE; + currentSubroutineEnd = NONE; + + recentCreationOffsetIndex = 0; + + // Initialize the stack of 'new' instruction offsets if this method is + // an instance initializer. + if (method.getName(clazz).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + recentCreationOffsets[recentCreationOffsetIndex++] = AT_METHOD_ENTRY; + } + + // The end of the code is a branch target sentinel. + instructionMarks[codeLength] = BRANCH_TARGET; + + // Mark branch targets by going over all instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Mark branch targets in the exception table. + codeAttribute.exceptionsAccept(clazz, method, this); + + // Fill out any gaps in the subroutine starts and the subroutine ends + // and subroutine returning flags, working backward. + + // We're not starting in a subroutine. + int subroutineStart = NONE; + int subroutineEnd = codeLength; + boolean subroutineReturning = false; + + for (int index = codeLength - 1; index >= 0; index--) + { + if (isInstruction(index)) + { + // Are we inside a previously marked subroutine? + if (subroutineStarts[index] != NONE) + { + // Update the current subroutine start. + subroutineStart = subroutineStarts[index]; + } + else if (subroutineStart != NONE) + { + // Mark the subroutine start. + subroutineStarts[index] = subroutineStart; + } + + // Did we reach the start of the subroutine. + if (isSubroutineStart(index)) + { + // Stop marking it. + subroutineStart = NONE; + } + + // Are we inside a subroutine? + if (isSubroutine(index)) + { + // Mark the subroutine end. + subroutineEnds[index] = subroutineEnd; + + // Update or mark the subroutine returning flag. + if (isSubroutineReturning(index)) + { + subroutineReturning = true; + } + else if (subroutineReturning) + { + instructionMarks[index] |= SUBROUTINE_RETURNING; + } + } + else + { + // Update the subroutine end and returning flag. + subroutineEnd = index; + subroutineReturning = false; + } + } + } + + if (DEBUG) + { + System.out.println(); + System.out.println("Branch targets: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + + for (int index = 0; index < codeLength; index++) + { + if (isInstruction(index)) + { + System.out.println("" + + (isBranchOrigin(index) ? 'B' : '-') + + (isAfterBranch(index) ? 'b' : '-') + + (isBranchTarget(index) ? 'T' : '-') + + (isExceptionStart(index) ? 'E' : '-') + + (isExceptionEnd(index) ? 'e' : '-') + + (isExceptionHandler(index) ? 'H' : '-') + + (isSubroutineInvocation(index) ? 'J' : '-') + + (isSubroutineStart(index) ? 'S' : '-') + + (isSubroutineReturning(index) ? 'r' : '-') + + (isSubroutine(index) ? " ["+subroutineStart(index)+" -> "+subroutineEnd(index)+"]" : "") + + (isNew(index) ? " ["+initializationOffset(index)+"] " : " ---- ") + + InstructionFactory.create(codeAttribute.code, index).toString(index)); + } + } + } + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + // Mark the instruction. + instructionMarks[offset] |= INSTRUCTION; + + // Check if this is the first instruction of a subroutine. + checkSubroutine(offset); + + byte opcode = simpleInstruction.opcode; + if (opcode == InstructionConstants.OP_IRETURN || + opcode == InstructionConstants.OP_LRETURN || + opcode == InstructionConstants.OP_FRETURN || + opcode == InstructionConstants.OP_DRETURN || + opcode == InstructionConstants.OP_ARETURN || + opcode == InstructionConstants.OP_ATHROW) + { + // Mark the branch origin. + markBranchOrigin(offset); + + // Mark the next instruction. + markAfterBranchOrigin(offset + simpleInstruction.length(offset)); + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Mark the instruction. + instructionMarks[offset] |= INSTRUCTION; + + // Check if this is the first instruction of a subroutine. + checkSubroutine(offset); + + // Check if the instruction is a 'new' instruction. + if (constantInstruction.opcode == InstructionConstants.OP_NEW) + { + // Push the 'new' instruction offset on the stack. + recentCreationOffsets[recentCreationOffsetIndex++] = offset; + } + else + { + // Check if the instruction is an initializer invocation. + isInitializer = false; + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + if (isInitializer) + { + // Pop the 'new' instruction offset from the stack. + int recentCreationOffset = recentCreationOffsets[--recentCreationOffsetIndex]; + + // Fill it out in the creation offsets. + creationOffsets[offset] = recentCreationOffset; + + // Fill out the initialization offsets. + if (recentCreationOffset == AT_METHOD_ENTRY) + { + superInitializationOffset = offset; + } + else + { + initializationOffsets[recentCreationOffset] = offset; + } + } + } + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + // Mark the instruction. + instructionMarks[offset] |= INSTRUCTION; + + // Check if this is the first instruction of a subroutine. + checkSubroutine(offset); + + if (variableInstruction.opcode == InstructionConstants.OP_RET) + { + // Mark the branch origin. + markBranchOrigin(offset); + + // Mark the regular subroutine return. + instructionMarks[offset] |= SUBROUTINE_RETURNING; + + // Mark the next instruction. + markAfterBranchOrigin(offset + variableInstruction.length(offset)); + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Mark the branch origin. + markBranchOrigin(offset); + + // Check if this is the first instruction of a subroutine. + checkSubroutine(offset); + + // Mark the branch target. + markBranchTarget(offset, branchInstruction.branchOffset); + + byte opcode = branchInstruction.opcode; + if (opcode == InstructionConstants.OP_JSR || + opcode == InstructionConstants.OP_JSR_W) + { + // Mark the subroutine invocation. + instructionMarks[offset] |= SUBROUTINE_INVOCATION; + + // Mark the subroutine start. + int targetOffset = offset + branchInstruction.branchOffset; + subroutineStarts[targetOffset] = targetOffset; + } + else if (opcode == InstructionConstants.OP_GOTO || + opcode == InstructionConstants.OP_GOTO_W) + { + // Mark the next instruction. + markAfterBranchOrigin(offset + branchInstruction.length(offset)); + } + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + // Mark the branch origin. + markBranchOrigin(offset); + + // Check if this is the first instruction of a subroutine. + checkSubroutine(offset); + + // Mark the branch targets of the default jump offset. + markBranchTarget(offset, switchInstruction.defaultOffset); + + // Mark the branch targets of the jump offsets. + markBranchTargets(offset, + switchInstruction.jumpOffsets); + + // Mark the next instruction. + markAfterBranchOrigin(offset + switchInstruction.length(offset)); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + isInitializer = methodrefConstant.getName(clazz).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + // Mark the exception offsets. + instructionMarks[exceptionInfo.u2startPC] |= EXCEPTION_START; + instructionMarks[exceptionInfo.u2endPC] |= EXCEPTION_END; + instructionMarks[exceptionInfo.u2handlerPC] |= EXCEPTION_HANDLER; + } + + + // Small utility methods. + + /** + * Marks the branch targets of the given jump offsets for the instruction + * at the given offset. + */ + private void markBranchTargets(int offset, int[] jumpOffsets) + { + for (int index = 0; index < jumpOffsets.length; index++) + { + markBranchTarget(offset, jumpOffsets[index]); + } + } + + + /** + * Marks the branch origin at the given offset. + */ + private void markBranchOrigin(int offset) + { + instructionMarks[offset] |= INSTRUCTION | BRANCH_ORIGIN; + } + + + /** + * Marks the branch target at the given offset. + */ + private void markBranchTarget(int offset, int jumpOffset) + { + int targetOffset = offset + jumpOffset; + + instructionMarks[targetOffset] |= BRANCH_TARGET; + + // Are we inside a previously marked subroutine? + if (isSubroutine(offset)) + { + // Mark the subroutine start of the target. + subroutineStarts[targetOffset] = currentSubroutineStart; + + // Update the current subroutine end. + if (currentSubroutineEnd < targetOffset) + { + currentSubroutineEnd = targetOffset; + } + } + } + + + /** + * Marks the instruction at the given offset, after a branch. + */ + private void markAfterBranchOrigin(int nextOffset) + { + instructionMarks[nextOffset] |= AFTER_BRANCH; + + // Are we at the end of the current subroutine? + if (currentSubroutineEnd <= nextOffset) + { + // Reset the subroutine start. + currentSubroutineStart = NONE; + } + } + + + /** + * Checks if the specified instruction is inside a subroutine. + */ + private void checkSubroutine(int offset) + { + // Are we inside a previously marked subroutine? + if (isSubroutine(offset)) + { + // Update the current subroutine start. + currentSubroutineStart = subroutineStarts[offset]; + } + else + { + // Mark the subroutine start (or NONE). + subroutineStarts[offset] = currentSubroutineStart; + } + } +} diff --git a/src/proguard/optimize/peephole/ClassFinalizer.java b/src/proguard/optimize/peephole/ClassFinalizer.java new file mode 100644 index 0000000..b5e54f8 --- /dev/null +++ b/src/proguard/optimize/peephole/ClassFinalizer.java @@ -0,0 +1,84 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.optimize.KeepMarker; + +/** + * This ClassVisitor makes the program classes that it visits + * final, if possible. + * + * @author Eric Lafortune + */ +public class ClassFinalizer +extends SimplifiedVisitor +implements ClassVisitor +{ + private final ClassVisitor extraClassVisitor; + + + /** + * Creates a new ClassFinalizer. + */ + public ClassFinalizer() + { + this(null); + } + + + /** + * Creates a new ClassFinalizer. + * @param extraClassVisitor an optional extra visitor for all finalized + * classes. + */ + public ClassFinalizer(ClassVisitor extraClassVisitor) + { + this.extraClassVisitor = extraClassVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // If the class is not final/interface/abstract, + // and it is not being kept, + // and it doesn't have any subclasses, + // then make it final. + if ((programClass.u2accessFlags & (ClassConstants.INTERNAL_ACC_FINAL | + ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) == 0 && + !KeepMarker.isKept(programClass) && + programClass.subClasses == null) + { + programClass.u2accessFlags |= ClassConstants.INTERNAL_ACC_FINAL; + + // Visit the class, if required. + if (extraClassVisitor != null) + { + extraClassVisitor.visitProgramClass(programClass); + } + } + } +} diff --git a/src/proguard/optimize/peephole/ClassMerger.java b/src/proguard/optimize/peephole/ClassMerger.java new file mode 100644 index 0000000..1e1a950 --- /dev/null +++ b/src/proguard/optimize/peephole/ClassMerger.java @@ -0,0 +1,541 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.constant.visitor.*; +import proguard.classfile.editor.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.optimize.KeepMarker; +import proguard.optimize.info.*; +import proguard.util.*; + +import java.util.*; + +/** + * This ClassVisitor inlines the classes that it visits in a given target class, + * whenever possible. + * + * @see RetargetedInnerClassAttributeRemover + * @see TargetClassChanger + * @see ClassReferenceFixer + * @see MemberReferenceFixer + * @see AccessFixer + * @author Eric Lafortune + */ +public class ClassMerger +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private final ProgramClass targetClass; + private final boolean allowAccessModification; + private final boolean mergeInterfacesAggressively; + private final ClassVisitor extraClassVisitor; + + + /** + * Creates a new ClassMerger that will merge classes into the given target + * class. + * @param targetClass the class into which all visited + * classes will be merged. + * @param allowAccessModification specifies whether the access modifiers + * of classes can be changed in order to + * merge them. + * @param mergeInterfacesAggressively specifies whether interfaces may + * be merged aggressively. + */ + public ClassMerger(ProgramClass targetClass, + boolean allowAccessModification, + boolean mergeInterfacesAggressively) + { + this(targetClass, allowAccessModification, mergeInterfacesAggressively, null); + } + + + /** + * Creates a new ClassMerger that will merge classes into the given target + * class. + * @param targetClass the class into which all visited + * classes will be merged. + * @param allowAccessModification specifies whether the access modifiers + * of classes can be changed in order to + * merge them. + * @param mergeInterfacesAggressively specifies whether interfaces may + * be merged aggressively. + * @param extraClassVisitor an optional extra visitor for all + * merged classes. + */ + public ClassMerger(ProgramClass targetClass, + boolean allowAccessModification, + boolean mergeInterfacesAggressively, + ClassVisitor extraClassVisitor) + { + this.targetClass = targetClass; + this.allowAccessModification = allowAccessModification; + this.mergeInterfacesAggressively = mergeInterfacesAggressively; + this.extraClassVisitor = extraClassVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + //final String CLASS_NAME = "abc/Def"; + //DEBUG = programClass.getName().equals(CLASS_NAME) || + // targetClass.getName().equals(CLASS_NAME); + + // TODO: Remove this when the class merger has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + visitProgramClass0(programClass); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while merging classes:"); + System.err.println(" Class = ["+programClass.getName()+"]"); + System.err.println(" Target class = ["+targetClass.getName()+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + if (DEBUG) + { + programClass.accept(new ClassPrinter()); + targetClass.accept(new ClassPrinter()); + } + + throw ex; + } + } + + public void visitProgramClass0(ProgramClass programClass) + { + if (!programClass.equals(targetClass) && + + // Don't merge classes that must be preserved. + !KeepMarker.isKept(programClass) && + !KeepMarker.isKept(targetClass) && + + // Only merge classes that haven't been retargeted yet. + getTargetClass(programClass) == null && + getTargetClass(targetClass) == null && + + // Don't merge annotation classes, with all their introspection and + // infinite recursion. + (programClass.getAccessFlags() & ClassConstants.INTERNAL_ACC_ANNOTATTION) == 0 && + + // Only merge classes if we can change the access permissioms, or + // if they are in the same package, or + // if they are public and don't contain or invoke package visible + // class members. + (allowAccessModification || + ((programClass.getAccessFlags() & + targetClass.getAccessFlags() & + ClassConstants.INTERNAL_ACC_PUBLIC) != 0 && + !PackageVisibleMemberContainingClassMarker.containsPackageVisibleMembers(programClass) && + !PackageVisibleMemberInvokingClassMarker.invokesPackageVisibleMembers(programClass)) || + ClassUtil.internalPackageName(programClass.getName()).equals( + ClassUtil.internalPackageName(targetClass.getName()))) && + + // Only merge two classes or two interfaces or two abstract classes, + // or a class into an interface with a single implementation. + ((programClass.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) == + (targetClass.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) || + (isOnlySubClass(programClass, targetClass) && + (programClass.getSuperClass().equals(targetClass) || + programClass.getSuperClass().equals(targetClass.getSuperClass())))) && + + // One class must not implement the other class indirectly. + !indirectlyImplementedInterfaces(programClass).contains(targetClass) && + !targetClass.extendsOrImplements(programClass) && + + // The two classes must have the same superclasses and interfaces + // with static initializers. + initializedSuperClasses(programClass).equals(initializedSuperClasses(targetClass)) && + + // The two classes must have the same superclasses and interfaces + // that are tested with 'instanceof'. + instanceofedSuperClasses(programClass).equals(instanceofedSuperClasses(targetClass)) && + + // The two classes must have the same superclasses that are caught + // as exceptions. + caughtSuperClasses(programClass).equals(caughtSuperClasses(targetClass)) && + + // The two classes must not both be part of a .class construct. + !(DotClassMarker.isDotClassed(programClass) && + DotClassMarker.isDotClassed(targetClass)) && + + // The two classes must not introduce any unwanted fields. + !introducesUnwantedFields(programClass, targetClass) && + !introducesUnwantedFields(targetClass, programClass) && + + // The classes must not have clashing constructors. + !haveAnyIdenticalInitializers(programClass, targetClass) && + + // The classes must not introduce abstract methods, unless + // explicitly allowed. + (mergeInterfacesAggressively || + (!introducesUnwantedAbstractMethods(programClass, targetClass) && + !introducesUnwantedAbstractMethods(targetClass, programClass))) && + + // The classes must not override each others concrete methods. + !overridesAnyMethods(programClass, targetClass) && + !overridesAnyMethods(targetClass, programClass) && + + // The classes must not shadow each others non-private methods. + !shadowsAnyMethods(programClass, targetClass) && + !shadowsAnyMethods(targetClass, programClass)) + { + if (DEBUG) + { + System.out.println("ClassMerger ["+programClass.getName()+"] -> ["+targetClass.getName()+"]"); + System.out.println(" Source interface? ["+((programClass.getAccessFlags() & ClassConstants.INTERNAL_ACC_INTERFACE)!=0)+"]"); + System.out.println(" Target interface? ["+((targetClass.getAccessFlags() & ClassConstants.INTERNAL_ACC_INTERFACE)!=0)+"]"); + System.out.println(" Source subclasses ["+programClass.subClasses+"]"); + System.out.println(" Target subclasses ["+targetClass.subClasses+"]"); + System.out.println(" Source superclass ["+programClass.getSuperClass().getName()+"]"); + System.out.println(" Target superclass ["+targetClass.getSuperClass().getName()+"]"); + } + + // Combine the access flags. + int targetAccessFlags = targetClass.getAccessFlags(); + int sourceAccessFlags = programClass.getAccessFlags(); + + targetClass.u2accessFlags = + ((targetAccessFlags & + sourceAccessFlags) & + (ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) | + ((targetAccessFlags | + sourceAccessFlags) & + (ClassConstants.INTERNAL_ACC_PUBLIC | + ClassConstants.INTERNAL_ACC_ANNOTATTION | + ClassConstants.INTERNAL_ACC_ENUM)); + + // Copy over the superclass, unless it's the target class itself. + //if (!targetClass.getName().equals(programClass.getSuperName())) + //{ + // targetClass.u2superClass = + // new ConstantAdder(targetClass).addConstant(programClass, programClass.u2superClass); + //} + + // Copy over the interfaces that aren't present yet and that + // wouldn't cause loops in the class hierarchy. + programClass.interfaceConstantsAccept( + new ExceptClassConstantFilter(targetClass.getName(), + new ImplementedClassConstantFilter(targetClass, + new ImplementingClassConstantFilter(targetClass, + new InterfaceAdder(targetClass))))); + + // Copy over the class members. + MemberAdder memberAdder = + new MemberAdder(targetClass); + + programClass.fieldsAccept(memberAdder); + programClass.methodsAccept(memberAdder); + + // Copy over the other attributes. + programClass.attributesAccept( + new AttributeAdder(targetClass, true)); + + // Update the optimization information of the target class. + ClassOptimizationInfo info = + ClassOptimizationInfo.getClassOptimizationInfo(targetClass); + if (info != null) + { + info.merge(ClassOptimizationInfo.getClassOptimizationInfo(programClass)); + } + + // Remember to replace the inlined class by the target class. + setTargetClass(programClass, targetClass); + + // Visit the merged class, if required. + if (extraClassVisitor != null) + { + extraClassVisitor.visitProgramClass(programClass); + } + } + } + + + // Small utility methods. + + /** + * Returns whether a given class is the only subclass of another given class. + */ + private boolean isOnlySubClass(Clazz subClass, + ProgramClass clazz) + { + // TODO: The list of subclasses is not up to date. + return clazz.subClasses != null && + clazz.subClasses.length == 1 && + clazz.subClasses[0].equals(subClass); + } + + + /** + * Returns the set of indirectly implemented interfaces. + */ + private Set indirectlyImplementedInterfaces(Clazz clazz) + { + Set set = new HashSet(); + + ReferencedClassVisitor referencedInterfaceCollector = + new ReferencedClassVisitor( + new ClassHierarchyTraveler(false, false, true, false, + new ClassCollector(set))); + + // Visit all superclasses and collect their interfaces. + clazz.superClassConstantAccept(referencedInterfaceCollector); + + // Visit all interfaces and collect their interfaces. + clazz.interfaceConstantsAccept(referencedInterfaceCollector); + + return set; + } + + + /** + * Returns the set of superclasses and interfaces that are initialized. + */ + private Set initializedSuperClasses(Clazz clazz) + { + Set set = new HashSet(); + + // Visit all superclasses and interfaces, collecting the ones that have + // static initializers. + clazz.hierarchyAccept(true, true, true, false, + new NamedMethodVisitor(ClassConstants.INTERNAL_METHOD_NAME_CLINIT, + ClassConstants.INTERNAL_METHOD_TYPE_INIT, + new MemberToClassVisitor( + new ClassCollector(set)))); + + return set; + } + + + /** + * Returns the set of superclasses and interfaces that are used in + * 'instanceof' tests. + */ + private Set instanceofedSuperClasses(Clazz clazz) + { + Set set = new HashSet(); + + // Visit all superclasses and interfaces, collecting the ones that are + // used in an 'instanceof' test. + clazz.hierarchyAccept(true, true, true, false, + new InstanceofClassFilter( + new ClassCollector(set))); + + return set; + } + + + /** + * Returns the set of superclasses that are caught as exceptions. + */ + private Set caughtSuperClasses(Clazz clazz) + { + Set set = new HashSet(); + + // Visit all superclasses, collecting the ones that are caught. + clazz.hierarchyAccept(true, true, false, false, + new CaughtClassFilter( + new ClassCollector(set))); + + return set; + } + + + /** + * Returns whether the given class would introduce any unwanted fields + * in the target class. + */ + private boolean introducesUnwantedFields(ProgramClass programClass, + ProgramClass targetClass) + { + // The class must not have any fields, or it must not be instantiated, + // without any other subclasses. + return + programClass.u2fieldsCount != 0 && + (InstantiationClassMarker.isInstantiated(targetClass) || + (targetClass.subClasses != null && + !isOnlySubClass(programClass, targetClass))); + } + + + /** + * Returns whether the two given classes have initializers with the same + * descriptors. + */ + private boolean haveAnyIdenticalInitializers(Clazz clazz, Clazz targetClass) + { + MemberCounter counter = new MemberCounter(); + + // TODO: Currently checking shared methods, not just initializers. + // TODO: Allow identical methods. + // Visit all methods, counting the ones that are also present in the + // target class. + clazz.methodsAccept(//new MemberNameFilter(new FixedStringMatcher(ClassConstants.INTERNAL_METHOD_NAME_INIT), + new SimilarMemberVisitor(targetClass, true, false, false, false, + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_ABSTRACT, + counter))); + + return counter.getCount() > 0; + } + + + /** + * Returns whether the given class would introduce any abstract methods + * in the target class. + */ + private boolean introducesUnwantedAbstractMethods(Clazz clazz, + ProgramClass targetClass) + { + // It's ok if the target class is already abstract and it has at most + // the class as a subclass. + if ((targetClass.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_ABSTRACT | + ClassConstants.INTERNAL_ACC_INTERFACE)) != 0 && + (targetClass.subClasses == null || + isOnlySubClass(clazz, targetClass))) + { + return false; + } + + MemberCounter counter = new MemberCounter(); + Set targetSet = new HashSet(); + + // Collect all abstract methods, and similar abstract methods in the + // class hierarchy of the target class. + clazz.methodsAccept(new MemberAccessFilter(ClassConstants.INTERNAL_ACC_ABSTRACT, 0, + new MultiMemberVisitor(new MemberVisitor[] + { + counter, + new SimilarMemberVisitor(targetClass, true, true, true, false, + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_ABSTRACT, 0, + new MemberCollector(targetSet))) + }))); + + return targetSet.size() < counter.getCount(); + } + + + /** + * Returns whether the given class overrides any methods in the given + * target class. + */ + private boolean overridesAnyMethods(Clazz clazz, Clazz targetClass) + { + MemberCounter counter = new MemberCounter(); + + // Visit all non-private non-static methods, counting the ones that are + // being overridden in the class hierarchy of the target class. + clazz.methodsAccept(new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE | ClassConstants.INTERNAL_ACC_STATIC | ClassConstants.INTERNAL_ACC_ABSTRACT, + new MemberNameFilter(new NotMatcher(new FixedStringMatcher(ClassConstants.INTERNAL_METHOD_NAME_CLINIT)), + new MemberNameFilter(new NotMatcher(new FixedStringMatcher(ClassConstants.INTERNAL_METHOD_NAME_INIT)), + new SimilarMemberVisitor(targetClass, true, true, false, false, + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE | ClassConstants.INTERNAL_ACC_STATIC | ClassConstants.INTERNAL_ACC_ABSTRACT, + counter)))))); + + return counter.getCount() > 0; + } + + + /** + * Returns whether the given class or its subclasses shadow any methods in + * the given target class. + */ + private boolean shadowsAnyMethods(Clazz clazz, Clazz targetClass) + { + MemberCounter counter = new MemberCounter(); + + // Visit all private methods, counting the ones that are shadowing + // non-private methods in the class hierarchy of the target class. + clazz.hierarchyAccept(true, false, false, true, + new AllMethodVisitor( + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_PRIVATE, 0, + new MemberNameFilter(new NotMatcher(new FixedStringMatcher(ClassConstants.INTERNAL_METHOD_NAME_INIT)), + new SimilarMemberVisitor(targetClass, true, true, true, false, + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + counter)))))); + + // Visit all static methods, counting the ones that are shadowing + // non-private methods in the class hierarchy of the target class. + clazz.hierarchyAccept(true, false, false, true, + new AllMethodVisitor( + new MemberAccessFilter(ClassConstants.INTERNAL_ACC_STATIC, 0, + new MemberNameFilter(new NotMatcher(new FixedStringMatcher(ClassConstants.INTERNAL_METHOD_NAME_CLINIT)), + new SimilarMemberVisitor(targetClass, true, true, true, false, + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE, + counter)))))); + + return counter.getCount() > 0; + } + + + public static void setTargetClass(Clazz clazz, Clazz targetClass) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info != null) + { + info.setTargetClass(targetClass); + } + } + + + public static Clazz getTargetClass(Clazz clazz) + { + Clazz targetClass = null; + + // Return the last target class, if any. + while (true) + { + ClassOptimizationInfo info = ClassOptimizationInfo.getClassOptimizationInfo(clazz); + if (info == null) + { + return targetClass; + } + + clazz = info.getTargetClass(); + if (clazz == null) + { + return targetClass; + } + + targetClass = clazz; + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/GotoCommonCodeReplacer.java b/src/proguard/optimize/peephole/GotoCommonCodeReplacer.java new file mode 100644 index 0000000..4833275 --- /dev/null +++ b/src/proguard/optimize/peephole/GotoCommonCodeReplacer.java @@ -0,0 +1,266 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor redirects unconditional branches so any common code + * is shared, and the code preceding the branch can be removed, in the code + * attributes that it visits. + * + * @author Eric Lafortune + */ +public class GotoCommonCodeReplacer +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private final InstructionVisitor extraInstructionVisitor; + + private final BranchTargetFinder branchTargetFinder = new BranchTargetFinder(); + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + + /** + * Creates a new GotoCommonCodeReplacer. + * @param extraInstructionVisitor an optional extra visitor for all replaced + * goto instructions. + */ + public GotoCommonCodeReplacer(InstructionVisitor extraInstructionVisitor) + { + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // Mark all branch targets. + branchTargetFinder.visitCodeAttribute(clazz, method, codeAttribute); + + // Reset the code attribute editor. + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + // Remap the variables of the instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Apply the code atribute editor. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Check if the instruction is an unconditional goto instruction that + // isn't the target of a branch itself. + byte opcode = branchInstruction.opcode; + if ((opcode == InstructionConstants.OP_GOTO || + opcode == InstructionConstants.OP_GOTO_W) && + !branchTargetFinder.isBranchTarget(offset)) + { + int branchOffset = branchInstruction.branchOffset; + int targetOffset = offset + branchOffset; + + // Get the number of common bytes. + int commonCount = commonByteCodeCount(codeAttribute, offset, targetOffset); + + if (commonCount > 0 && + !exceptionBoundary(codeAttribute, offset, targetOffset)) + { + if (DEBUG) + { + System.out.println("GotoCommonCodeReplacer: "+clazz.getName()+"."+method.getName(clazz)+" (["+(offset-commonCount)+"] - "+branchInstruction.toString(offset)+" -> "+targetOffset+")"); + } + + // Delete the common instructions. + for (int delta = 0; delta <= commonCount; delta++) + { + int deleteOffset = offset - delta; + if (branchTargetFinder.isInstruction(deleteOffset)) + { + codeAttributeEditor.replaceInstruction( deleteOffset, (Instruction)null); + codeAttributeEditor.insertBeforeInstruction(deleteOffset, (Instruction)null); + codeAttributeEditor.insertAfterInstruction( deleteOffset, (Instruction)null); + + codeAttributeEditor.deleteInstruction(deleteOffset); + } + } + + // Redirect the goto instruction, if it is still necessary. + int newBranchOffset = branchOffset - commonCount; + if (newBranchOffset != branchInstruction.length(offset)) + { + Instruction newGotoInstruction = + new BranchInstruction(opcode, newBranchOffset); + codeAttributeEditor.replaceInstruction(offset, + newGotoInstruction); + } + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + extraInstructionVisitor.visitBranchInstruction(clazz, method, codeAttribute, offset, branchInstruction); + } + } + } + } + + + // Small utility methods. + + /** + * Returns the number of common bytes preceding the given offsets, + * avoiding branches and exception blocks. + */ + private int commonByteCodeCount(CodeAttribute codeAttribute, int offset1, int offset2) + { + // Find the block of common instructions preceding it. + byte[] code = codeAttribute.code; + + int successfulDelta = 0; + + for (int delta = 1; + delta <= offset1 && + delta <= offset2 && + offset2 - delta != offset1; + delta++) + { + int newOffset1 = offset1 - delta; + int newOffset2 = offset2 - delta; + + // Is the code identical at both offsets? + if (code[newOffset1] != code[newOffset2]) + { + break; + } + + // Are there instructions at either offset but not both? + if (branchTargetFinder.isInstruction(newOffset1) ^ + branchTargetFinder.isInstruction(newOffset2)) + { + break; + } + + // Are there instructions at both offsets? + if (branchTargetFinder.isInstruction(newOffset1) && + branchTargetFinder.isInstruction(newOffset2)) + { + // Are the offsets involved in some branches? + // Note that the preverifier doesn't like initializer + // invocations to be moved around. + // Also note that the preverifier doesn't like pop instructions + // that work on different operands. + if (branchTargetFinder.isBranchOrigin(newOffset1) || + branchTargetFinder.isBranchTarget(newOffset1) || + branchTargetFinder.isExceptionStart(newOffset1) || + branchTargetFinder.isExceptionEnd(newOffset1) || + branchTargetFinder.isInitializer(newOffset1) || + branchTargetFinder.isExceptionStart(newOffset2) || + branchTargetFinder.isExceptionEnd(newOffset2) || + isPop(code[newOffset1])) + { + break; + } + + // Make sure the new branch target was a branch target before, + // in order not to introduce new entries in the stack map table. + if (branchTargetFinder.isBranchTarget(newOffset2)) + { + successfulDelta = delta; + } + + if (branchTargetFinder.isBranchTarget(newOffset1)) + { + break; + } + } + } + + return successfulDelta; + } + + + /** + * Returns whether the given opcode represents a pop instruction that must + * get a consistent type (pop, pop2, arraylength). + */ + private boolean isPop(byte opcode) + { + return opcode == InstructionConstants.OP_POP || + opcode == InstructionConstants.OP_POP2 || + opcode == InstructionConstants.OP_ARRAYLENGTH; + } + + + /** + * Returns the whether there is a boundary of an exception block between + * the given offsets (including both). + */ + private boolean exceptionBoundary(CodeAttribute codeAttribute, int offset1, int offset2) + { + // Swap the offsets if the second one is smaller than the first one. + if (offset2 < offset1) + { + int offset = offset1; + offset1 = offset2; + offset2 = offset; + } + + // Check if there is a boundary of an exception block. + for (int offset = offset1; offset <= offset2; offset++) + { + if (branchTargetFinder.isExceptionStart(offset) || + branchTargetFinder.isExceptionEnd(offset)) + { + return true; + } + } + + return false; + } +} diff --git a/src/proguard/optimize/peephole/GotoGotoReplacer.java b/src/proguard/optimize/peephole/GotoGotoReplacer.java new file mode 100644 index 0000000..7d7e66c --- /dev/null +++ b/src/proguard/optimize/peephole/GotoGotoReplacer.java @@ -0,0 +1,114 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor simplifies unconditional branches to other + * unconditional branches. + * + * @author Eric Lafortune + */ +public class GotoGotoReplacer +extends SimplifiedVisitor +implements InstructionVisitor +{ + private final CodeAttributeEditor codeAttributeEditor; + private final InstructionVisitor extraInstructionVisitor; + + + /** + * Creates a new GotoGotoReplacer. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + */ + public GotoGotoReplacer(CodeAttributeEditor codeAttributeEditor) + { + this(codeAttributeEditor, null); + } + + + /** + * Creates a new GotoGotoReplacer. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + * @param extraInstructionVisitor an optional extra visitor for all replaced + * goto instructions. + */ + public GotoGotoReplacer(CodeAttributeEditor codeAttributeEditor, + InstructionVisitor extraInstructionVisitor) + { + this.codeAttributeEditor = codeAttributeEditor; + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Check if the instruction is an unconditional goto instruction. + byte opcode = branchInstruction.opcode; + if (opcode == InstructionConstants.OP_GOTO || + opcode == InstructionConstants.OP_GOTO_W) + { + // Check if the goto instruction points to another simple goto + // instruction. + int branchOffset = branchInstruction.branchOffset; + int targetOffset = offset + branchOffset; + + if (branchOffset != branchInstruction.length(offset) && + !codeAttributeEditor.isModified(offset) && + !codeAttributeEditor.isModified(targetOffset)) + { + Instruction targetInstruction = + InstructionFactory.create(codeAttribute.code, targetOffset); + + if (targetInstruction.opcode == InstructionConstants.OP_GOTO) + { + // Simplify the goto instruction. + int targetBranchOffset = ((BranchInstruction)targetInstruction).branchOffset; + + Instruction newBranchInstruction = + new BranchInstruction(opcode, + (branchOffset + targetBranchOffset)); + codeAttributeEditor.replaceInstruction(offset, + newBranchInstruction); + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + extraInstructionVisitor.visitBranchInstruction(clazz, method, codeAttribute, offset, branchInstruction); + } + } + } + } + } +} diff --git a/src/proguard/optimize/peephole/GotoReturnReplacer.java b/src/proguard/optimize/peephole/GotoReturnReplacer.java new file mode 100644 index 0000000..5c3eb77 --- /dev/null +++ b/src/proguard/optimize/peephole/GotoReturnReplacer.java @@ -0,0 +1,115 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor replaces unconditional branches to return instructions + * by these same return instructions. + * + * @author Eric Lafortune + */ +public class GotoReturnReplacer +extends SimplifiedVisitor +implements InstructionVisitor +{ + private final CodeAttributeEditor codeAttributeEditor; + private final InstructionVisitor extraInstructionVisitor; + + + /** + * Creates a new GotoReturnReplacer. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + */ + public GotoReturnReplacer(CodeAttributeEditor codeAttributeEditor) + { + this(codeAttributeEditor, null); + } + + + /** + * Creates a new GotoReturnReplacer. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + * @param extraInstructionVisitor an optional extra visitor for all replaced + * goto instructions. + */ + public GotoReturnReplacer(CodeAttributeEditor codeAttributeEditor, + InstructionVisitor extraInstructionVisitor) + { + this.codeAttributeEditor = codeAttributeEditor; + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Check if the instruction is an unconditional goto instruction. + byte opcode = branchInstruction.opcode; + if (opcode == InstructionConstants.OP_GOTO || + opcode == InstructionConstants.OP_GOTO_W) + { + // Check if the goto instruction points to a return instruction. + int targetOffset = offset + branchInstruction.branchOffset; + + if (!codeAttributeEditor.isModified(offset) && + !codeAttributeEditor.isModified(targetOffset)) + { + Instruction targetInstruction = InstructionFactory.create(codeAttribute.code, + targetOffset); + switch (targetInstruction.opcode) + { + case InstructionConstants.OP_IRETURN: + case InstructionConstants.OP_LRETURN: + case InstructionConstants.OP_FRETURN: + case InstructionConstants.OP_DRETURN: + case InstructionConstants.OP_ARETURN: + case InstructionConstants.OP_RETURN: + // Replace the goto instruction by the return instruction. + Instruction returnInstruction = + new SimpleInstruction(targetInstruction.opcode); + codeAttributeEditor.replaceInstruction(offset, + returnInstruction); + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + extraInstructionVisitor.visitBranchInstruction(clazz, method, codeAttribute, offset, branchInstruction); + } + + break; + } + } + } + } +} diff --git a/src/proguard/optimize/peephole/HorizontalClassMerger.java b/src/proguard/optimize/peephole/HorizontalClassMerger.java new file mode 100644 index 0000000..a37b9a5 --- /dev/null +++ b/src/proguard/optimize/peephole/HorizontalClassMerger.java @@ -0,0 +1,90 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor inlines siblings in the program classes that it visits, + * whenever possible. + * + * @see ClassMerger + * @author Eric Lafortune + */ +public class HorizontalClassMerger +extends SimplifiedVisitor +implements ClassVisitor +{ + private final boolean allowAccessModification; + private final boolean mergeInterfacesAggressively; + private final ClassVisitor extraClassVisitor; + + + /** + * Creates a new HorizontalClassMerger. + * @param allowAccessModification specifies whether the access modifiers + * of classes can be changed in order to + * merge them. + * @param mergeInterfacesAggressively specifies whether interfaces may + * be merged aggressively. + */ + public HorizontalClassMerger(boolean allowAccessModification, + boolean mergeInterfacesAggressively) + { + this(allowAccessModification, mergeInterfacesAggressively, null); + } + + + /** + * Creates a new VerticalClassMerger. + * @param allowAccessModification specifies whether the access modifiers + * of classes can be changed in order to + * merge them. + * @param mergeInterfacesAggressively specifies whether interfaces may + * be merged aggressively. + * @param extraClassVisitor an optional extra visitor for all + * merged classes. + */ + public HorizontalClassMerger(boolean allowAccessModification, + boolean mergeInterfacesAggressively, + ClassVisitor extraClassVisitor) + { + this.allowAccessModification = allowAccessModification; + this.mergeInterfacesAggressively = mergeInterfacesAggressively; + this.extraClassVisitor = extraClassVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.superClassConstantAccept(new ReferencedClassVisitor( + new SubclassTraveler( + new ProgramClassFilter( + new ClassMerger(programClass, + allowAccessModification, + mergeInterfacesAggressively, + extraClassVisitor))))); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/InstructionSequenceConstants.java b/src/proguard/optimize/peephole/InstructionSequenceConstants.java new file mode 100644 index 0000000..b33204b --- /dev/null +++ b/src/proguard/optimize/peephole/InstructionSequenceConstants.java @@ -0,0 +1,3351 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.constant.*; +import proguard.classfile.instruction.*; +import proguard.classfile.util.InstructionSequenceMatcher; + +/** + * This class contains a set of instruction sequences and their suggested + * replacements. + * + * @see InstructionSequencesReplacer + * @author Eric Lafortune + */ +public class InstructionSequenceConstants +{ + public static final int X = InstructionSequenceMatcher.X; + public static final int Y = InstructionSequenceMatcher.Y; + public static final int Z = InstructionSequenceMatcher.Z; + + public static final int A = InstructionSequenceMatcher.A; + public static final int B = InstructionSequenceMatcher.B; + public static final int C = InstructionSequenceMatcher.C; + public static final int D = InstructionSequenceMatcher.D; + + + private static final int I_32768 = 0; + private static final int I_65536 = 1; + private static final int I_16777216 = 2; + +// private static final int I_0x000000ff + private static final int I_0x0000ff00 = 3; + private static final int I_0x00ff0000 = 4; + private static final int I_0xff000000 = 5; + private static final int I_0x0000ffff = 6; + private static final int I_0xffff0000 = 7; + + private static final int L_M1 = 8; + private static final int L_2 = 9; + private static final int L_4 = 10; + private static final int L_8 = 11; + private static final int L_16 = 12; + private static final int L_32 = 13; + private static final int L_64 = 14; + private static final int L_128 = 15; + private static final int L_256 = 16; + private static final int L_512 = 17; + private static final int L_1024 = 18; + private static final int L_2048 = 19; + private static final int L_4096 = 20; + private static final int L_8192 = 21; + private static final int L_16384 = 22; + private static final int L_32768 = 23; + private static final int L_65536 = 24; + private static final int L_16777216 = 25; + private static final int L_4294967296 = 26; + + private static final int L_0x00000000ffffffff = 27; + private static final int L_0xffffffff00000000 = 28; + + private static final int F_M1 = 29; + + private static final int D_M1 = 30; + + private static final int FIELD_I = 31; + private static final int FIELD_L = 32; + private static final int FIELD_F = 33; + private static final int FIELD_D = 34; + + private static final int NAME_AND_TYPE_I = 35; + private static final int NAME_AND_TYPE_L = 36; + private static final int NAME_AND_TYPE_F = 37; + private static final int NAME_AND_TYPE_D = 38; + + private static final int TYPE_I = 39; + private static final int TYPE_L = 40; + private static final int TYPE_F = 41; + private static final int TYPE_D = 42; + + + public static final Constant[] CONSTANTS = new Constant[] + { + new IntegerConstant(32768), + new IntegerConstant(65536), + new IntegerConstant(16777216), + + new IntegerConstant(0x0000ff00), + new IntegerConstant(0x00ff0000), + new IntegerConstant(0xff000000), + new IntegerConstant(0x0000ffff), + new IntegerConstant(0xffff0000), + + new LongConstant(-1L), + new LongConstant(2L), + new LongConstant(4L), + new LongConstant(8L), + new LongConstant(16L), + new LongConstant(32L), + new LongConstant(64L), + new LongConstant(128L), + new LongConstant(256L), + new LongConstant(512L), + new LongConstant(1024L), + new LongConstant(2048L), + new LongConstant(4096L), + new LongConstant(8192L), + new LongConstant(16384L), + new LongConstant(32768L), + new LongConstant(65536L), + new LongConstant(16777216L), + new LongConstant(4294967296L), + + new LongConstant(0x00000000ffffffffL), + new LongConstant(0xffffffff00000000L), + + new FloatConstant(-1f), + + new DoubleConstant(-1d), + + new FieldrefConstant(X, NAME_AND_TYPE_I, null, null), + new FieldrefConstant(X, NAME_AND_TYPE_L, null, null), + new FieldrefConstant(X, NAME_AND_TYPE_F, null, null), + new FieldrefConstant(X, NAME_AND_TYPE_D, null, null), + + new NameAndTypeConstant(Y, TYPE_I), + new NameAndTypeConstant(Y, TYPE_L), + new NameAndTypeConstant(Y, TYPE_F), + new NameAndTypeConstant(Y, TYPE_D), + + new Utf8Constant("I"), + new Utf8Constant("J"), + new Utf8Constant("F"), + new Utf8Constant("D"), + }; + + + public static final Instruction[][][] VARIABLE = new Instruction[][][] + { + { // nop = nothing + { + new SimpleInstruction(InstructionConstants.OP_NOP), + },{ + // Nothing. + }, + }, + { // iload/pop = nothing + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_POP), + },{ + // Nothing. + }, + }, + { // lload/pop2 = nothing + { + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new SimpleInstruction(InstructionConstants.OP_POP2), + },{ + // Nothing. + }, + }, + { // fload/pop = nothing + { + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_POP), + },{ + // Nothing. + }, + }, + { // dload/pop2 = nothing + { + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_POP2), + },{ + // Nothing. + }, + }, + { // aload/pop = nothing + { + new VariableInstruction(InstructionConstants.OP_ALOAD, X), + new SimpleInstruction(InstructionConstants.OP_POP), + },{ + // Nothing. + }, + }, + { // i = i = nothing + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + // Nothing. + }, + }, + { // l = l = nothing + { + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new VariableInstruction(InstructionConstants.OP_LSTORE, X), + },{ + // Nothing. + }, + }, + { // f = f = nothing + { + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new VariableInstruction(InstructionConstants.OP_FSTORE, X), + },{ + // Nothing. + }, + }, + { // d = d = nothing + { + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new VariableInstruction(InstructionConstants.OP_DSTORE, X), + },{ + // Nothing. + }, + }, + { // a = a = nothing + { + new VariableInstruction(InstructionConstants.OP_ALOAD, X), + new SimpleInstruction(InstructionConstants.OP_POP), + },{ + // Nothing. + }, + }, + { // istore/istore = pop/istore + { + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + }, + }, + { // lstore/lstore = pop2/lstore + { + new VariableInstruction(InstructionConstants.OP_LSTORE, X), + new VariableInstruction(InstructionConstants.OP_LSTORE, X), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new VariableInstruction(InstructionConstants.OP_LSTORE, X), + }, + }, + { // fstore/fstore = pop/fstore + { + new VariableInstruction(InstructionConstants.OP_FSTORE, X), + new VariableInstruction(InstructionConstants.OP_FSTORE, X), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new VariableInstruction(InstructionConstants.OP_FSTORE, X), + }, + }, + { // dstore/dstore = pop2/dstore + { + new VariableInstruction(InstructionConstants.OP_DSTORE, X), + new VariableInstruction(InstructionConstants.OP_DSTORE, X), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new VariableInstruction(InstructionConstants.OP_DSTORE, X), + }, + }, + { // astore/astore = pop/astore + { + new VariableInstruction(InstructionConstants.OP_ASTORE, X), + new VariableInstruction(InstructionConstants.OP_ASTORE, X), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new VariableInstruction(InstructionConstants.OP_ASTORE, X), + }, + }, + { // istore/iload = dup/istore + { + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + }, + }, + { // lstore/lload = dup2/lstore + { + new VariableInstruction(InstructionConstants.OP_LSTORE, X), + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP2), + new VariableInstruction(InstructionConstants.OP_LSTORE, X), + }, + }, + { // fstore/fload = dup/fstore + { + new VariableInstruction(InstructionConstants.OP_FSTORE, X), + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP), + new VariableInstruction(InstructionConstants.OP_FSTORE, X), + }, + }, + { // dstore/dload = dup2/dstore + { + new VariableInstruction(InstructionConstants.OP_DSTORE, X), + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP2), + new VariableInstruction(InstructionConstants.OP_DSTORE, X), + }, + }, + { // astore/aload = dup/astore + { + new VariableInstruction(InstructionConstants.OP_ASTORE, X), + new VariableInstruction(InstructionConstants.OP_ALOAD, X), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP), + new VariableInstruction(InstructionConstants.OP_ASTORE, X), + }, + }, + }; + + public static final Instruction[][][] ARITHMETIC = new Instruction[][][] + { + { // c + i = i + c + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IADD), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + }, + }, + { // b + i = i + b + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IADD), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + }, + }, + { // s + i = i + s + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IADD), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + }, + }, + { // c + i = i + c + { + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IADD), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + }, + }, + { // c * i = i * c + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new SimpleInstruction(InstructionConstants.OP_IMUL), + }, + }, + { // b * i = i * b + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new SimpleInstruction(InstructionConstants.OP_IMUL), + }, + }, + { // s * i = i * s + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new SimpleInstruction(InstructionConstants.OP_IMUL), + }, + }, + { // c * i = i * c + { + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_IMUL), + }, + }, + { // c + l = l + c + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0, A), + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new SimpleInstruction(InstructionConstants.OP_LADD), + },{ + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new SimpleInstruction(InstructionConstants.OP_LCONST_0, A), + new SimpleInstruction(InstructionConstants.OP_LADD), + }, + }, + { // c + l = l + c + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, A), + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new SimpleInstruction(InstructionConstants.OP_LADD), + },{ + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC2_W, A), + new SimpleInstruction(InstructionConstants.OP_LADD), + }, + }, + { // c * l = l * c + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0, A), + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new VariableInstruction(InstructionConstants.OP_LLOAD, X), + new SimpleInstruction(InstructionConstants.OP_LCONST_0, A), + new SimpleInstruction(InstructionConstants.OP_LMUL), + }, + }, + { // c + f = f + c + { + new SimpleInstruction(InstructionConstants.OP_FCONST_0, A), + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_FADD), + },{ + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_FCONST_0, A), + new SimpleInstruction(InstructionConstants.OP_FADD), + }, + }, + { // c + f = f + c + { + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_FADD), + },{ + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_FADD), + }, + }, + { // c * f = f * c + { + new SimpleInstruction(InstructionConstants.OP_FCONST_0, A), + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_FMUL), + },{ + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_FCONST_0, A), + new SimpleInstruction(InstructionConstants.OP_FMUL), + }, + }, + { // c * f = f * c + { + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new VariableInstruction(InstructionConstants.OP_FLOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC, A), + new SimpleInstruction(InstructionConstants.OP_LMUL), + }, + }, + { // c + d = d + c + { + new SimpleInstruction(InstructionConstants.OP_DCONST_0, A), + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_DADD), + },{ + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_DCONST_0, A), + new SimpleInstruction(InstructionConstants.OP_DADD), + }, + }, + { // c + d = d + c + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, A), + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_DADD), + },{ + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC2_W, A), + new SimpleInstruction(InstructionConstants.OP_DADD), + }, + }, + { // c * d = d * c + { + new SimpleInstruction(InstructionConstants.OP_DCONST_0, A), + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_DMUL), + },{ + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_DCONST_0, A), + new SimpleInstruction(InstructionConstants.OP_DMUL), + }, + }, + { // c * d = d * c + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, A), + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new SimpleInstruction(InstructionConstants.OP_DMUL), + },{ + new VariableInstruction(InstructionConstants.OP_DLOAD, X), + new ConstantInstruction(InstructionConstants.OP_LDC2_W, A), + new SimpleInstruction(InstructionConstants.OP_DMUL), + }, + }, + { // i = i + c = i += c + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, A), + }, + }, + { // i = i + b = i += b + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, A), + }, + }, + { // i = i + s = i += s + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new SimpleInstruction(InstructionConstants.OP_IADD), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, A), + }, + }, + { // i = i - -1 = i++ + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new SimpleInstruction(InstructionConstants.OP_ISUB), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, 1), + }, + }, + { // i = i - 1 = i-- + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new SimpleInstruction(InstructionConstants.OP_ISUB), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, -1), + }, + }, + { // i = i - 2 = i -= 2 + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_2), + new SimpleInstruction(InstructionConstants.OP_ISUB), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, -2), + }, + }, + { // i = i - 3 = i -= 3 + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_3), + new SimpleInstruction(InstructionConstants.OP_ISUB), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, -3), + }, + }, + { // i = i - 4 = i -= 4 + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_4), + new SimpleInstruction(InstructionConstants.OP_ISUB), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, -4), + }, + }, + { // i = i - 5 = i -= 5 + { + new VariableInstruction(InstructionConstants.OP_ILOAD, X), + new SimpleInstruction(InstructionConstants.OP_ICONST_5), + new SimpleInstruction(InstructionConstants.OP_ISUB), + new VariableInstruction(InstructionConstants.OP_ISTORE, X), + },{ + new VariableInstruction(InstructionConstants.OP_IINC, X, -5), + }, + }, + { // ... + 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_IADD), + },{ + // Nothing. + }, + }, + { // ... + 0L = ... + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + new SimpleInstruction(InstructionConstants.OP_LADD), + },{ + // Nothing. + }, + }, + { // ... + 0f = ... + { + new SimpleInstruction(InstructionConstants.OP_FCONST_0), + new SimpleInstruction(InstructionConstants.OP_FADD), + },{ + // Nothing. + }, + }, + { // ... + 0d = ... + { + new SimpleInstruction(InstructionConstants.OP_DCONST_0), + new SimpleInstruction(InstructionConstants.OP_DADD), + },{ + // Nothing. + }, + }, + { // ... - 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_ISUB), + },{ + // Nothing. + }, + }, + { // ... - 0L = ... + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + new SimpleInstruction(InstructionConstants.OP_LSUB), + },{ + // Nothing. + }, + }, + { // ... - 0f = ... + { + new SimpleInstruction(InstructionConstants.OP_FCONST_0), + new SimpleInstruction(InstructionConstants.OP_FSUB), + },{ + // Nothing. + }, + }, + { // ... - 0d = ... + { + new SimpleInstruction(InstructionConstants.OP_DCONST_0), + new SimpleInstruction(InstructionConstants.OP_DSUB), + },{ + // Nothing. + }, + }, + { // ... * -1 = -... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_INEG), + }, + }, + { // ... * 0 = 0 + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + }, + }, + { // ... * 1 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + // Nothing. + }, + }, + { // ... * 2 = ... << 1 + { + new SimpleInstruction(InstructionConstants.OP_ICONST_2), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 4 = ... << 2 + { + new SimpleInstruction(InstructionConstants.OP_ICONST_4), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_ICONST_2), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 8 = ... << 3 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_ICONST_3), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 16 = ... << 4 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 4), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 32 = ... << 5 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 5), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 64 = ... << 6 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 64), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 6), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 128 = ... << 7 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 128), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 7), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 256 = ... << 8 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 256), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 512 = ... << 9 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 512), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 9), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 1024 = ... << 10 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 1024), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 10), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 2048 = ... << 11 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 2048), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 11), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 4096 = ... << 12 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 4096), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 12), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 8192 = ... << 13 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 8192), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 13), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 16384 = ... << 14 + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 16384), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 14), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 32768 = ... << 15 + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_32768), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 15), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 65536 = ... << 16 + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_65536), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * 16777216 = ... << 24 + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_16777216), + new SimpleInstruction(InstructionConstants.OP_IMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHL), + }, + }, + { // ... * -1L = -... + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_M1), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_LNEG), + }, + }, + { // ... * 0L = 0L + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + }, + }, + { // ... * 1L = ... + { + new SimpleInstruction(InstructionConstants.OP_LCONST_1), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + // Nothing. + }, + }, + { // ... * 2L = ... << 1 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_2), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 4L = ... << 2 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_4), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_ICONST_2), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 8L = ... << 3 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_8), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_ICONST_3), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 16L = ... << 4 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_16), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 4), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 32L = ... << 5 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_32), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 5), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 64L = ... << 6 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_64), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 6), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 128L = ... << 7 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_128), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 7), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 256L = ... << 8 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_256), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 512L = ... << 9 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_512), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 9), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 1024L = ... << 10 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_1024), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 10), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 2048L = ... << 11 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_2048), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 11), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 4096L = ... << 12 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_4096), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 12), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 8192L = ... << 13 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_8192), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 13), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 16384L = ... << 14 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_16384), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 14), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 32768L = ... << 15 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_32768), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 15), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 65536LL = ... << 16 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_65536), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 16777216L = ... << 24 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_16777216), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * 4294967296L = ... << 32 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_4294967296), + new SimpleInstruction(InstructionConstants.OP_LMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LSHL), + }, + }, + { // ... * -1f = -... + { + new ConstantInstruction(InstructionConstants.OP_LDC, F_M1), + new SimpleInstruction(InstructionConstants.OP_FMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_FNEG), + }, + }, +// { // ... * 0f = 0f (or NaN) +// { +// new SimpleInstruction(InstructionConstants.OP_FCONST_0), +// new SimpleInstruction(InstructionConstants.OP_FMUL), +// },{ +// new SimpleInstruction(InstructionConstants.OP_POP), +// new SimpleInstruction(InstructionConstants.OP_FCONST_0), +// }, +// }, + { // ... * 1f = ... + { + new SimpleInstruction(InstructionConstants.OP_FCONST_1), + new SimpleInstruction(InstructionConstants.OP_FMUL), + },{ + // Nothing. + }, + }, + { // ... * -1d = -... + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, D_M1), + new SimpleInstruction(InstructionConstants.OP_DMUL), + },{ + new SimpleInstruction(InstructionConstants.OP_DNEG), + }, + }, +// { // ... * 0d = 0d (or NaN) +// { +// new SimpleInstruction(InstructionConstants.OP_DCONST_0), +// new SimpleInstruction(InstructionConstants.OP_DMUL), +// },{ +// new SimpleInstruction(InstructionConstants.OP_POP2), +// new SimpleInstruction(InstructionConstants.OP_DCONST_0), +// }, +// }, + { // ... * 1d = ... + { + new SimpleInstruction(InstructionConstants.OP_DCONST_1), + new SimpleInstruction(InstructionConstants.OP_DMUL), + },{ + // Nothing. + }, + }, + { // ... / -1 = -... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new SimpleInstruction(InstructionConstants.OP_IDIV), + },{ + new SimpleInstruction(InstructionConstants.OP_INEG), + }, + }, + { // ... / 1 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new SimpleInstruction(InstructionConstants.OP_IDIV), + },{ + // Nothing. + }, + }, + // Not valid for negative values. +// { // ... / 2 = ... >> 1 +// { +// new SimpleInstruction(InstructionConstants.OP_ICONST_2), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_1), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 4 = ... >> 2 +// { +// new SimpleInstruction(InstructionConstants.OP_ICONST_4), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_2), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 8 = ... >> 3 +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_3), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 16 = ... >> 4 +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 4), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 32 = ... >> 5 +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 5), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 64 = ... >> 6 +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 64), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 6), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 128 = ... >> 7 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 128), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 7), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 256 = ... >> 8 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 256), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 512 = ... >> 9 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 512), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 9), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 1024 = ... >> 10 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 1024), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 10), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 2048 = ... >> 11 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 2048), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 11), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 4096 = ... >> 12 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 4096), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 12), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 8192 = ... >> 13 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 8192), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 13), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 16384 = ... >> 14 +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 16384), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 14), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 32768 = ... >> 15 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC, I_32768), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 15), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 65536 = ... >> 16 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC, I_65536), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, +// { // ... / 16777216 = ... >> 24 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC, I_16777216), +// new SimpleInstruction(InstructionConstants.OP_IDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), +// new SimpleInstruction(InstructionConstants.OP_ISHR), +// }, +// }, + { // ... / -1L = -... + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_M1), + new SimpleInstruction(InstructionConstants.OP_LDIV), + },{ + new SimpleInstruction(InstructionConstants.OP_LNEG), + }, + }, + { // ... / 1L = ... + { + new SimpleInstruction(InstructionConstants.OP_LCONST_1), + new SimpleInstruction(InstructionConstants.OP_LDIV), + },{ + // Nothing. + }, + }, + // Not valid for negative values. +// { // ... / 2L = ... >> 1 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_2), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_1), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 4L = ... >> 2 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_4), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_2), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 8L = ... >> 3 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_8), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_3), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 16L = ... >> 4 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_16), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 4), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 32L = ... >> 5 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_32), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 5), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 64L = ... >> 6 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_64), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 6), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 128L = ... >> 7 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_128), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 7), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 256L = ... >> 8 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_256), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 512L = ... >> 9 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_512), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 9), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 1024L = ... >> 10 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_1024), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 10), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 2048L = ... >> 11 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_2048), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 11), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 4096L = ... >> 12 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_4096), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 12), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 8192L = ... >> 13 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_8192), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 13), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 16384L = ... >> 14 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_16384), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 14), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 32768L = ... >> 15 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_32768), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 15), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 65536LL = ... >> 16 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_65536), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 16777216L = ... >> 24 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_16777216), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, +// { // ... / 4294967296L = ... >> 32 +// { +// new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_4294967296), +// new SimpleInstruction(InstructionConstants.OP_LDIV), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), +// new SimpleInstruction(InstructionConstants.OP_LSHR), +// }, +// }, + { // ... / -1f = -... + { + new ConstantInstruction(InstructionConstants.OP_LDC, F_M1), + new SimpleInstruction(InstructionConstants.OP_FDIV), + },{ + new SimpleInstruction(InstructionConstants.OP_FNEG), + }, + }, + { // ... / 1f = ... + { + new SimpleInstruction(InstructionConstants.OP_FCONST_1), + new SimpleInstruction(InstructionConstants.OP_FDIV), + },{ + // Nothing. + }, + }, + { // ... / -1d = -... + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, D_M1), + new SimpleInstruction(InstructionConstants.OP_DDIV), + },{ + new SimpleInstruction(InstructionConstants.OP_DNEG), + }, + }, + { // ... / 1d = ... + { + new SimpleInstruction(InstructionConstants.OP_DCONST_1), + new SimpleInstruction(InstructionConstants.OP_DDIV), + },{ + // Nothing. + }, + }, + { // ... % 1 = 0 + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new SimpleInstruction(InstructionConstants.OP_IREM), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + }, + }, +// { // ... % 2 = ... & 0x1 +// { +// new SimpleInstruction(InstructionConstants.OP_ICONST_2), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_1), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 4 = ... & 0x3 +// { +// new SimpleInstruction(InstructionConstants.OP_ICONST_4), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_ICONST_3), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 8 = ... & 0x07 +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 0x07), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 16 = ... & 0x0f +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 0x0f), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 32 = ... & 0x1f +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 0x1f), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 64 = ... & 0x3f +// { +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 64), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 0x3f), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 128 = ... & 0x7f +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 128), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BIPUSH, 0x7f), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 256 = ... & 0x00ff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 256), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x00ff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 512 = ... & 0x01ff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 512), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x01ff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 1024 = ... & 0x03ff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 1024), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x03ff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 2048 = ... & 0x07ff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 2048), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x07ff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 4096 = ... & 0x0fff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 4096), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x0fff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 8192 = ... & 0x1fff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 8192), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x1fff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, +// { // ... % 16384 = ... & 0x3fff +// { +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 16384), +// new SimpleInstruction(InstructionConstants.OP_IREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0x3fff), +// new SimpleInstruction(InstructionConstants.OP_IAND), +// }, +// }, + { // ... % 1L = 0L + { + new SimpleInstruction(InstructionConstants.OP_LCONST_1), + new SimpleInstruction(InstructionConstants.OP_LREM), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + }, + }, +// { // ... % 1f = 0f +// { +// new SimpleInstruction(InstructionConstants.OP_FCONST_1), +// new SimpleInstruction(InstructionConstants.OP_FREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_POP), +// new SimpleInstruction(InstructionConstants.OP_FCONST_0), +// }, +// }, +// { // ... % 1d = 0d +// { +// new SimpleInstruction(InstructionConstants.OP_DCONST_1), +// new SimpleInstruction(InstructionConstants.OP_DREM), +// },{ +// new SimpleInstruction(InstructionConstants.OP_POP2), +// new SimpleInstruction(InstructionConstants.OP_DCONST_0), +// }, +// }, + { // -(-...) = ... + { + new SimpleInstruction(InstructionConstants.OP_INEG), + new SimpleInstruction(InstructionConstants.OP_INEG), + },{ + // Nothing. + }, + }, + { // -(-...) = ... + { + new SimpleInstruction(InstructionConstants.OP_LNEG), + new SimpleInstruction(InstructionConstants.OP_LNEG), + },{ + // Nothing. + }, + }, + { // -(-...) = ... + { + new SimpleInstruction(InstructionConstants.OP_FNEG), + new SimpleInstruction(InstructionConstants.OP_FNEG), + },{ + // Nothing. + }, + }, + { // -(-...) = ... + { + new SimpleInstruction(InstructionConstants.OP_DNEG), + new SimpleInstruction(InstructionConstants.OP_DNEG), + },{ + // Nothing. + }, + }, + { // +(-...) = -... + { + new SimpleInstruction(InstructionConstants.OP_INEG), + new SimpleInstruction(InstructionConstants.OP_IADD), + },{ + new SimpleInstruction(InstructionConstants.OP_ISUB), + }, + }, + { // +(-...) = -... + { + new SimpleInstruction(InstructionConstants.OP_LNEG), + new SimpleInstruction(InstructionConstants.OP_LADD), + },{ + new SimpleInstruction(InstructionConstants.OP_LSUB), + }, + }, + { // +(-...) = -... + { + new SimpleInstruction(InstructionConstants.OP_FNEG), + new SimpleInstruction(InstructionConstants.OP_FADD), + },{ + new SimpleInstruction(InstructionConstants.OP_FSUB), + }, + }, + { // +(-...) = -... + { + new SimpleInstruction(InstructionConstants.OP_DNEG), + new SimpleInstruction(InstructionConstants.OP_DADD), + },{ + new SimpleInstruction(InstructionConstants.OP_DSUB), + }, + }, + { // ... << 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_ISHL), + },{ + // Nothing. + }, + }, + { // ... << 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_LSHL), + },{ + // Nothing. + }, + }, + { // ... >> 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + // Nothing. + }, + }, + { // ... >> 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_LSHR), + },{ + // Nothing. + }, + }, + { // ... >>> 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + },{ + // Nothing. + }, + }, + { // ... >>> 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_LUSHR), + },{ + // Nothing. + }, + }, + { // ... & -1 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new SimpleInstruction(InstructionConstants.OP_IAND), + },{ + // Nothing. + }, + }, + { // ... & 0 = 0 + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_IAND), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + }, + }, + { // ... & -1L = ... + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_M1), + new SimpleInstruction(InstructionConstants.OP_LAND), + },{ + // Nothing. + }, + }, + { // ... & 0L = 0L + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + new SimpleInstruction(InstructionConstants.OP_LAND), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + }, + }, + { // ... | -1 = -1 + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new SimpleInstruction(InstructionConstants.OP_IOR), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + }, + }, + { // ... | 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_IOR), + },{ + // Nothing. + }, + }, + { // ... | -1L = -1L + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_M1), + new SimpleInstruction(InstructionConstants.OP_LAND), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_M1), + }, + }, + { // ... | 0L = ... + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + new SimpleInstruction(InstructionConstants.OP_LOR), + },{ + // Nothing. + }, + }, + { // ... ^ 0 = ... + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new SimpleInstruction(InstructionConstants.OP_IXOR), + },{ + // Nothing. + }, + }, + { // ... ^ 0L = ... + { + new SimpleInstruction(InstructionConstants.OP_LCONST_0), + new SimpleInstruction(InstructionConstants.OP_LXOR), + },{ + // Nothing. + }, + }, + { // (... & 0x0000ff00) >> 8 = (... >> 8) & 0xff + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0x0000ff00), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_ISHR), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + }, + }, + { // (... & 0x0000ff00) >>> 8 = (... >>> 8) & 0xff + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0x0000ff00), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 8), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + }, + }, + { // (... & 0x00ff0000) >> 16 = (... >> 16) & 0xff + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0x00ff0000), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + }, + }, + { // (... & 0x00ff0000) >>> 16 = (... >>> 16) & 0xff + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0x00ff0000), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + }, + }, + { // (... & 0xff000000) >> 24 = ... >> 24 + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0xff000000), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + }, + }, + { // (... & 0xffff0000) >> 16 = ... >> 16 + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0xffff0000), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + }, + }, + { // (... & 0xffff0000) >>> 16 = ... >>> 16 + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0xffff0000), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + }, + }, + { // (... >> 24) & 0xff = ... >>> 24 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + }, + }, + { // (... >>> 24) & 0xff = ... >>> 24 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + }, + }, + { // (byte)(... & 0x000000ff) = (byte)... + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, 0xff), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_I2B), + },{ + new SimpleInstruction(InstructionConstants.OP_I2B), + }, + }, + { // (char)(... & 0x0000ffff) = (char)... + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0x0000ffff), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_I2C), + },{ + new SimpleInstruction(InstructionConstants.OP_I2C), + }, + }, + { // (short)(... & 0x0000ffff) = (short)... + { + new ConstantInstruction(InstructionConstants.OP_LDC, I_0x0000ffff), + new SimpleInstruction(InstructionConstants.OP_IAND), + new SimpleInstruction(InstructionConstants.OP_I2S), + },{ + new SimpleInstruction(InstructionConstants.OP_I2S), + }, + }, + { // (byte)(... >> 24) = ... >> 24 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + new SimpleInstruction(InstructionConstants.OP_I2B), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + }, + }, + { // (byte)(... >>> 24) = ... >> 24 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + new SimpleInstruction(InstructionConstants.OP_I2B), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + }, + }, + { // (char)(... >> 16) = ... >>> 16 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + new SimpleInstruction(InstructionConstants.OP_I2C), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + }, + }, + { // (char)(... >>> 16) = ... >>> 16 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + new SimpleInstruction(InstructionConstants.OP_I2C), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + }, + }, + { // (short)(... >> 16) = ... >> 16 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + new SimpleInstruction(InstructionConstants.OP_I2S), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + }, + }, + { // (short)(... >>> 16) = ... >> 16 + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + new SimpleInstruction(InstructionConstants.OP_I2S), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + }, + }, + { // ... << 24 >> 24 = (byte)... + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHL), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 24), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + new SimpleInstruction(InstructionConstants.OP_I2B), + }, + }, + { // ... << 16 >>> 16 = (char)... + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHL), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_IUSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_I2C), + }, + }, + { // ... << 16 >> 16 = (short)... + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHL), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 16), + new SimpleInstruction(InstructionConstants.OP_ISHR), + },{ + new SimpleInstruction(InstructionConstants.OP_I2S), + }, + }, + { // ... << 32 >> 32 = (long)(int)... + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LSHL), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_L2I), + new SimpleInstruction(InstructionConstants.OP_I2L), + }, + }, + { // (int)(... & 0x00000000ffffffffL) = (int)... + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_0x00000000ffffffff), + new SimpleInstruction(InstructionConstants.OP_LAND), + new SimpleInstruction(InstructionConstants.OP_L2I), + },{ + new SimpleInstruction(InstructionConstants.OP_L2I), + }, + }, + { // (... & 0xffffffff00000000L) >> 32 = ... >> 32 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_0xffffffff00000000), + new SimpleInstruction(InstructionConstants.OP_LAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LSHR), + }, + }, + { // (... & 0xffffffff00000000L) >>> 32 = ... >>> 32 + { + new ConstantInstruction(InstructionConstants.OP_LDC2_W, L_0xffffffff00000000), + new SimpleInstruction(InstructionConstants.OP_LAND), + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LUSHR), + },{ + new SimpleInstruction(InstructionConstants.OP_BIPUSH, 32), + new SimpleInstruction(InstructionConstants.OP_LUSHR), + }, + }, + { // ... += 0 = nothing + { + new VariableInstruction(InstructionConstants.OP_IINC, X, 0), + },{ + // Nothing. + }, + }, + }; + + public static final Instruction[][][] FIELD = new Instruction[][][] + { + { // getfield/putfield = nothing + { + new VariableInstruction(InstructionConstants.OP_ALOAD, X), + new VariableInstruction(InstructionConstants.OP_ALOAD, X), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Y), + new ConstantInstruction(InstructionConstants.OP_PUTFIELD, Y), + },{ + // Nothing. + }, + }, +// { // putfield_L/putfield_L = pop2_x1/putfield +// { +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_L), +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_L), +// },{ +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new SimpleInstruction(InstructionConstants.OP_POP2), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_L), +// }, +// }, +// { // putfield_D/putfield_D = pop2_x1/putfield +// { +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_D), +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_D), +// },{ +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new SimpleInstruction(InstructionConstants.OP_POP2), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_D), +// }, +// }, +// { // putfield/putfield = pop_x1/putfield +// { +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, Y), +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, Y), +// },{ +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new SimpleInstruction(InstructionConstants.OP_POP), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, Y), +// }, +// }, +// { // putfield_L/getfield_L = dup2_x1/putfield +// { +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_L), +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// new ConstantInstruction(InstructionConstants.OP_GETFIELD, FIELD_L), +// },{ +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new SimpleInstruction(InstructionConstants.OP_DUP2_X1), +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_L), +// }, +// }, +// { // putfield_D/getfield_D = dup2_x1/putfield +// { +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_D), +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// new ConstantInstruction(InstructionConstants.OP_GETFIELD, FIELD_D), +// },{ +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new SimpleInstruction(InstructionConstants.OP_DUP2_X1), +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, FIELD_D), +// }, +// }, +// { // putfield/getfield = dup_x1/putfield +// { +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, Y), +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// new ConstantInstruction(InstructionConstants.OP_GETFIELD, Y), +// },{ +// new VariableInstruction(InstructionConstants.OP_ALOAD, X), +// // ... +// new SimpleInstruction(InstructionConstants.OP_DUP_X1), +// new ConstantInstruction(InstructionConstants.OP_PUTFIELD, Y), +// }, +// }, + { // getstatic/putstatic = nothing + { + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, X), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, X), + },{ + // Nothing. + }, + }, + { // putstatic_L/putstatic_L = pop2/putstatic + { + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_L), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_L), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_L), + }, + }, + { // putstatic_D/putstatic_D = pop2/putstatic + { + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_D), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_D), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_D), + }, + }, + { // putstatic/putstatic = pop/putstatic + { + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, X), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, X), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, X), + }, + }, + { // putstatic_L/getstatic_L = dup2/putstatic + { + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_L), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, FIELD_L), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP2), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_L), + }, + }, + { // putstatic_D/getstatic_D = dup2/putstatic + { + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_D), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, FIELD_D), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP2), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, FIELD_D), + }, + }, + { // putstatic/getstatic = dup/putstatic + { + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, X), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, X), + },{ + new SimpleInstruction(InstructionConstants.OP_DUP), + new ConstantInstruction(InstructionConstants.OP_PUTSTATIC, X), + }, + }, + }; + + public static final Instruction[][][] CAST = new Instruction[][][] + { + { // (byte)(byte)... = (byte)... + { + new SimpleInstruction(InstructionConstants.OP_I2B), + new SimpleInstruction(InstructionConstants.OP_I2B), + },{ + new SimpleInstruction(InstructionConstants.OP_I2B), + }, + }, + { // (byte)(char)... = (byte)... + { + new SimpleInstruction(InstructionConstants.OP_I2C), + new SimpleInstruction(InstructionConstants.OP_I2B), + },{ + new SimpleInstruction(InstructionConstants.OP_I2B), + }, + }, + { // (byte)(short)... = (byte)... + { + new SimpleInstruction(InstructionConstants.OP_I2S), + new SimpleInstruction(InstructionConstants.OP_I2B), + },{ + new SimpleInstruction(InstructionConstants.OP_I2B), + }, + }, + { // (char)(char)... = (char)... + { + new SimpleInstruction(InstructionConstants.OP_I2C), + new SimpleInstruction(InstructionConstants.OP_I2C), + },{ + new SimpleInstruction(InstructionConstants.OP_I2C), + }, + }, + { // (char)(short)... = (char)... + { + new SimpleInstruction(InstructionConstants.OP_I2S), + new SimpleInstruction(InstructionConstants.OP_I2C), + },{ + new SimpleInstruction(InstructionConstants.OP_I2C), + }, + }, + { // (short)(byte)... = (byte)... + { + new SimpleInstruction(InstructionConstants.OP_I2B), + new SimpleInstruction(InstructionConstants.OP_I2S), + },{ + new SimpleInstruction(InstructionConstants.OP_I2B), + }, + }, + { // (short)(char)... = (short)... + { + new SimpleInstruction(InstructionConstants.OP_I2C), + new SimpleInstruction(InstructionConstants.OP_I2S), + },{ + new SimpleInstruction(InstructionConstants.OP_I2S), + }, + }, + { // (short)(short)... = (short)... + { + new SimpleInstruction(InstructionConstants.OP_I2S), + new SimpleInstruction(InstructionConstants.OP_I2S), + },{ + new SimpleInstruction(InstructionConstants.OP_I2S), + }, + }, + { // (int)(long)... = ... + { + new SimpleInstruction(InstructionConstants.OP_I2L), + new SimpleInstruction(InstructionConstants.OP_L2I), + },{ + // Nothing. + }, + }, + { // (X)(X)... = (X)... + { + new ConstantInstruction(InstructionConstants.OP_CHECKCAST, X), + new ConstantInstruction(InstructionConstants.OP_CHECKCAST, X), + },{ + new ConstantInstruction(InstructionConstants.OP_CHECKCAST, X), + }, + }, + // Not handled correctly in all cases by VMs prior to Java 6... +// { // (byte)bytes[...] = bytes[...] +// { +// new SimpleInstruction(InstructionConstants.OP_BALOAD), +// new SimpleInstruction(InstructionConstants.OP_I2B), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BALOAD), +// }, +// }, +// { // (short)bytes[...] = bytes[...] +// { +// new SimpleInstruction(InstructionConstants.OP_BALOAD), +// new SimpleInstruction(InstructionConstants.OP_I2S), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BALOAD), +// }, +// }, +// { // (char)chars[...] = chars[...] +// { +// new SimpleInstruction(InstructionConstants.OP_CALOAD), +// new SimpleInstruction(InstructionConstants.OP_I2C), +// },{ +// new SimpleInstruction(InstructionConstants.OP_CALOAD), +// }, +// }, +// { // (short)shorts[...] = shorts[...] +// { +// new SimpleInstruction(InstructionConstants.OP_SALOAD), +// new SimpleInstruction(InstructionConstants.OP_I2S), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SALOAD), +// }, +// }, +// { // bytes[...] = (byte)... = bytes[...] = ... +// { +// new SimpleInstruction(InstructionConstants.OP_I2B), +// new SimpleInstruction(InstructionConstants.OP_BASTORE), +// },{ +// new SimpleInstruction(InstructionConstants.OP_BASTORE), +// }, +// }, +// { // chars[...] = (char)... = chars[...] = ... +// { +// new SimpleInstruction(InstructionConstants.OP_I2C), +// new SimpleInstruction(InstructionConstants.OP_CASTORE), +// },{ +// new SimpleInstruction(InstructionConstants.OP_CASTORE), +// }, +// }, +// { // shorts[...] = (short)... = shorts[...] = ... +// { +// new SimpleInstruction(InstructionConstants.OP_I2S), +// new SimpleInstruction(InstructionConstants.OP_SASTORE), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SASTORE), +// }, +// }, + }; + + public static final Instruction[][][] BRANCH = new Instruction[][][] + { + { // goto +3 = nothing + { + new BranchInstruction(InstructionConstants.OP_GOTO, 3), + },{ + // Nothing. + }, + }, + { // ifeq +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFEQ, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // ifne +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFNE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // iflt +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFLT, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // ifge +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFGE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // ifgt +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFGT, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // ifle +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFLE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // ificmpeq +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ificmpne +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFICMPNE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ificmplt +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFICMPLT, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ificmpge +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFICMPGE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ificmpgt +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFICMPGT, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ificmple +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFICMPLE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ifacmpeq +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ifacmpne +3 = pop2 + { + new BranchInstruction(InstructionConstants.OP_IFACMPNE, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP2), + }, + }, + { // ifnull +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFNULL, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // ifnonnull +3 = pop + { + new BranchInstruction(InstructionConstants.OP_IFNONNULL, 3), + },{ + new SimpleInstruction(InstructionConstants.OP_POP), + }, + }, + { // if (... == 0) = ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + }, + }, + { // if (0 == i) = iload/ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + }, + }, + { // if (0 == i) = getstatic/ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + }, + }, + { // if (0 == i) = getfield/ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + }, + }, + { // if (... != 0) = ifne + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFICMPNE, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFNE, X), + }, + }, + { // if (0 != i) = iload/ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPNE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + }, + }, + { // if (0 != i) = getstatic/ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPNE, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + }, + }, + { // if (0 != i) = getfield/ifeq + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPNE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + }, + }, + { // if (... < 0) = iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (... < 1) = ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (0 > i) = iload/iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (1 > i) = iload/ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (0 > i) = getstatic/iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (1 > i) = getstatic/ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (0 > i) = getfield/iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (1 > i) = getfield/ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (... >= 0) = ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (... >= 1) = ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (0 <= i) = iload/ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (1 <= i) = iload/ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (0 <= i) = getstatic/ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (1 <= i) = getstatic/ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (0 <= i) = getfield/ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (1 <= i) = getfield/ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_1), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (... > 0) = ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (... > -1) = ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (0 < i) = iload/ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (-1 < i) = iload/ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (0 < i) = getstatic/ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (-1 < i) = getstatic/ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (0 < i) = getfield/ifgt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // if (-1 < i) = getfield/ifge + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // if (... <= 0) = ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (... <= -1) = iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (0 >= i) = iload/ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (-1 >= i) = iload/iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ILOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (0 >= i) = getstatic/ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (-1 >= i) = getstatic/iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (0 >= i) = getfield/ifle + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // if (-1 >= i) = getfield/iflt + { + new SimpleInstruction(InstructionConstants.OP_ICONST_M1), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // if (... == null) = ifnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFNULL, X), + }, + }, + { // if (null == a) = aload/ifnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFNULL, X), + }, + }, + { // if (null == a) = getstatic/ifnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFNULL, X), + }, + }, + { // if (null == a) = getfield/ifnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFNULL, X), + }, + }, + { // if (... != null) = ifnonnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new BranchInstruction(InstructionConstants.OP_IFACMPNE, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFNONNULL, X), + }, + }, + { // if (null != a) = aload/ifnonnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFACMPNE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new BranchInstruction(InstructionConstants.OP_IFNONNULL, X), + }, + }, + { // if (null != a) = getstatic/ifnonnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFACMPNE, X), + },{ + new ConstantInstruction(InstructionConstants.OP_GETSTATIC, Y), + new BranchInstruction(InstructionConstants.OP_IFNONNULL, X), + }, + }, + { // if (null != a) = getfield/ifnonnull + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFACMPNE, X), + },{ + new VariableInstruction(InstructionConstants.OP_ALOAD, Y), + new ConstantInstruction(InstructionConstants.OP_GETFIELD, Z), + new BranchInstruction(InstructionConstants.OP_IFNONNULL, X), + }, + }, + { // iconst_0/ifeq = goto + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // iconst/ifeq = nothing + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + },{ + // Nothing. + }, + }, + { // bipush/ifeq = nothing + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + },{ + // Nothing. + }, + }, + { // sipush/ifeq = nothing + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + },{ + // Nothing. + }, + }, + { // iconst_0/ifne = nothing + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + },{ + // Nothing. + }, + }, + { // iconst/ifne = goto + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0, A), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // bipush/ifne = goto + { + new SimpleInstruction(InstructionConstants.OP_BIPUSH, A), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // sipush/ifne = goto + { + new SimpleInstruction(InstructionConstants.OP_SIPUSH, A), + new BranchInstruction(InstructionConstants.OP_IFNE, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // iconst_0/iflt = nothing + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFLT, X), + },{ + // Nothing. + }, + }, + { // iconst_0/ifge = goto + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFGE, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // iconst_0/ifgt = nothing + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFGT, X), + },{ + // Nothing. + }, + }, + { // iconst_0/ifle = goto + { + new SimpleInstruction(InstructionConstants.OP_ICONST_0), + new BranchInstruction(InstructionConstants.OP_IFLE, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // aconst_null/ifnull = goto + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new BranchInstruction(InstructionConstants.OP_IFNULL, X), + },{ + new BranchInstruction(InstructionConstants.OP_GOTO, X), + }, + }, + { // aconst_null/ifnonnul = nothing + { + new SimpleInstruction(InstructionConstants.OP_ACONST_NULL), + new BranchInstruction(InstructionConstants.OP_IFNONNULL, X), + },{ + // Nothing. + }, + }, + { // ifeq/goto = ifne + { + new BranchInstruction(InstructionConstants.OP_IFEQ, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFNE, X), + }, + }, + { // ifne/goto = ifeq + { + new BranchInstruction(InstructionConstants.OP_IFNE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFEQ, X), + }, + }, + { // iflt/goto = ifge + { + new BranchInstruction(InstructionConstants.OP_IFLT, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFGE, X), + }, + }, + { // ifge/goto = iflt + { + new BranchInstruction(InstructionConstants.OP_IFGE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFLT, X), + }, + }, + { // ifgt/goto = ifle + { + new BranchInstruction(InstructionConstants.OP_IFGT, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFLE, X), + }, + }, + { // ifle/goto = ifgt + { + new BranchInstruction(InstructionConstants.OP_IFLE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFGT, X), + }, + }, + { // ificmpeq/goto = ificmpne + { + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFICMPNE, X), + }, + }, + { // ificmpne/goto = ificmpeq + { + new BranchInstruction(InstructionConstants.OP_IFICMPNE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFICMPEQ, X), + }, + }, + { // ificmplt/goto = ificmpge + { + new BranchInstruction(InstructionConstants.OP_IFICMPLT, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFICMPGE, X), + }, + }, + { // ificmpge/goto = ificmplt + { + new BranchInstruction(InstructionConstants.OP_IFICMPGE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFICMPLT, X), + }, + }, + { // ificmpgt/goto = ificmple + { + new BranchInstruction(InstructionConstants.OP_IFICMPGT, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFICMPLE, X), + }, + }, + { // ificmple/goto = ificmpgt + { + new BranchInstruction(InstructionConstants.OP_IFICMPLE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFICMPGT, X), + }, + }, + { // ifacmpeq/goto = ifacmpne + { + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFACMPNE, X), + }, + }, + { // ifacmpne/goto = ifacmpeq + { + new BranchInstruction(InstructionConstants.OP_IFACMPNE, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFACMPEQ, X), + }, + }, + { // ifnull/goto = ifnonnull + { + new BranchInstruction(InstructionConstants.OP_IFNULL, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFNONNULL, X), + }, + }, + { // ifnonnull/goto = ifnull + { + new BranchInstruction(InstructionConstants.OP_IFNONNULL, 6), + new BranchInstruction(InstructionConstants.OP_GOTO, X), + },{ + new BranchInstruction(InstructionConstants.OP_IFNULL, X), + }, + }, +// { // switch (...) { default: ... } = pop/goto ... +// { +// new TableSwitchInstruction(InstructionConstants.OP_TABLESWITCH, A, X, Y, 0, new int[0]), +// },{ +// new SimpleInstruction(InstructionConstants.OP_POP), +// new BranchInstruction(InstructionConstants.OP_GOTO, A), +// }, +// }, +// { // switch (...) { default: ... } = pop/goto ... +// { +// new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, A, 0, new int[0], new int[0]), +// },{ +// new SimpleInstruction(InstructionConstants.OP_POP), +// new BranchInstruction(InstructionConstants.OP_GOTO, A), +// }, +// }, + { // switch (...) { case/case/default: ... } = switch (...) { case/default: ... } + { + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, A, new int[] { X, Y }, new int[] { A, B }), + },{ + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, A, new int[] { Y }, new int[] { B }), + }, + }, + { // switch (...) { case/case/default: ... } = switch (...) { case/default: ... } + { + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, B, new int[] { X, Y }, new int[] { A, B }), + },{ + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, B, new int[] { X }, new int[] { A }), + }, + }, + { // switch (...) { case/case/case/default: ... } = switch (...) { case/case/default: ... } + { + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, A, new int[] { X, Y, Z }, new int[] { A, B, C }), + },{ + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, A, new int[] { Y, Z }, new int[] { B, C }), + }, + }, + { // switch (...) { case/case/case/default: ... } = switch (...) { case/case/default: ... } + { + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, B, new int[] { X, Y, Z }, new int[] { A, B, C }), + },{ + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, B, new int[] { X, Z }, new int[] { A, C }), + }, + }, + { // switch (...) { case/case/case/default: ... } = switch (...) { case/case/default: ... } + { + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, C, new int[] { X, Y, Z }, new int[] { A, B, C }), + },{ + new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, C, new int[] { X, Y }, new int[] { A, B }), + }, + }, +// { // switch (...) { case ...: ... default: ... } +// // = if (... == ...) ... else ... +// { +// new TableSwitchInstruction(InstructionConstants.OP_TABLESWITCH, A, X, Y, 1, new int[] { B }), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, X), +// new BranchInstruction(InstructionConstants.OP_IFICMPNE, A), +// new BranchInstruction(InstructionConstants.OP_GOTO, B), +// }, +// }, +// { // switch (...) { case ...: ... default: ... } +// // = if (... == ...) ... else ... +// { +// new LookUpSwitchInstruction(InstructionConstants.OP_LOOKUPSWITCH, A, 1, new int[] { X }, new int[] { B }), +// },{ +// new SimpleInstruction(InstructionConstants.OP_SIPUSH, X), +// new BranchInstruction(InstructionConstants.OP_IFICMPNE, A), +// new BranchInstruction(InstructionConstants.OP_GOTO, B), +// }, +// } + }; +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/InstructionSequenceReplacer.java b/src/proguard/optimize/peephole/InstructionSequenceReplacer.java new file mode 100644 index 0000000..bce06e2 --- /dev/null +++ b/src/proguard/optimize/peephole/InstructionSequenceReplacer.java @@ -0,0 +1,278 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.constant.Constant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; + +/** + * This InstructionVisitor replaces a given pattern instruction sequence by + * another given replacement instruction sequence. The arguments of the + * instruction sequences can be wildcards that are matched and replaced. + * + * @see InstructionSequenceMatcher + * @author Eric Lafortune + */ +public class InstructionSequenceReplacer +extends SimplifiedVisitor +implements InstructionVisitor, + ConstantVisitor +{ + private static final boolean DEBUG = false; + + + private final InstructionSequenceMatcher instructionSequenceMatcher; + private final Instruction[] replacementInstructions; + private final BranchTargetFinder branchTargetFinder; + private final CodeAttributeEditor codeAttributeEditor; + private final InstructionVisitor extraInstructionVisitor; + + private final MyReplacementInstructionFactory replacementInstructionFactory = new MyReplacementInstructionFactory(); + + + /** + * Creates a new InstructionSequenceReplacer. + * @param patternConstants any constants referenced by the pattern + * instruction. + * @param patternInstructions the pattern instruction sequence. + * @param replacementInstructions the replacement instruction sequence. + * @param branchTargetFinder a branch target finder that has been + * initialized to indicate branch targets + * in the visited code. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + */ + public InstructionSequenceReplacer(Constant[] patternConstants, + Instruction[] patternInstructions, + Instruction[] replacementInstructions, + BranchTargetFinder branchTargetFinder, + CodeAttributeEditor codeAttributeEditor) + { + this(patternConstants, + patternInstructions, + replacementInstructions, + branchTargetFinder, + codeAttributeEditor, + null); + } + + + /** + * Creates a new InstructionSequenceReplacer. + * @param patternConstants any constants referenced by the pattern + * instruction. + * @param branchTargetFinder a branch target finder that has been + * initialized to indicate branch targets + * in the visited code. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + * @param extraInstructionVisitor an optional extra visitor for all deleted + * load instructions. + */ + public InstructionSequenceReplacer(Constant[] patternConstants, + Instruction[] patternInstructions, + Instruction[] replacementInstructions, + BranchTargetFinder branchTargetFinder, + CodeAttributeEditor codeAttributeEditor, + InstructionVisitor extraInstructionVisitor) + { + this.instructionSequenceMatcher = new InstructionSequenceMatcher(patternConstants, patternInstructions); + this.replacementInstructions = replacementInstructions; + this.branchTargetFinder = branchTargetFinder; + this.codeAttributeEditor = codeAttributeEditor; + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Reset the instruction sequence matcher if the instruction is a branch + // target or if it has already been modified. + if (branchTargetFinder.isTarget(offset) || + codeAttributeEditor.isModified(offset)) + { + instructionSequenceMatcher.reset(); + } + + // Try to match the instruction. + instruction.accept(clazz, method, codeAttribute, offset, instructionSequenceMatcher); + + // Did the instruction sequence match and is it still unmodified? + if (instructionSequenceMatcher.isMatching() && + matchedInstructionsUnmodified()) + { + if (DEBUG) + { + System.out.println("InstructionSequenceReplacer: ["+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.out.println(" Matched:"); + for (int index = 0; index < instructionSequenceMatcher.instructionCount(); index++) + { + int matchedOffset = instructionSequenceMatcher.matchedInstructionOffset(index); + System.out.println(" "+InstructionFactory.create(codeAttribute.code, matchedOffset).toString(matchedOffset)); + } + System.out.println(" Replacement:"); + for (int index = 0; index < replacementInstructions.length; index++) + { + int matchedOffset = instructionSequenceMatcher.matchedInstructionOffset(index); + System.out.println(" "+replacementInstructionFactory.create(index).shrink().toString(matchedOffset)); + } + } + + // Replace the instruction sequence. + for (int index = 0; index < replacementInstructions.length; index++) + { + codeAttributeEditor.replaceInstruction(instructionSequenceMatcher.matchedInstructionOffset(index), + replacementInstructionFactory.create(index).shrink()); + } + + // Delete any remaining instructions in the from sequence. + for (int index = replacementInstructions.length; index < instructionSequenceMatcher.instructionCount(); index++) + { + codeAttributeEditor.deleteInstruction(instructionSequenceMatcher.matchedInstructionOffset(index)); + } + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + instruction.accept(clazz, + method, + codeAttribute, + offset, + extraInstructionVisitor); + } + } + } + + + // Small utility methods. + + /** + * Returns whether the matched pattern instructions haven't been modified + * before. + */ + private boolean matchedInstructionsUnmodified() + { + for (int index = 0; index < instructionSequenceMatcher.instructionCount(); index++) + { + if (codeAttributeEditor.isModified(instructionSequenceMatcher.matchedInstructionOffset(index))) + { + return false; + } + } + + return true; + } + + + /** + * This class creates replacement instructions for matched sequences, with + * any matched arguments filled out. + */ + private class MyReplacementInstructionFactory + implements InstructionVisitor + { + private Instruction replacementInstruction; + + + /** + * Creates the replacement instruction for the given index in the + * instruction sequence. + */ + public Instruction create(int index) + { + // Create the instruction. + replacementInstructions[index].accept(null, + null, + null, + instructionSequenceMatcher.matchedInstructionOffset(index), + this); + + // Return it. + return replacementInstruction.shrink(); + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + replacementInstruction = + new SimpleInstruction(simpleInstruction.opcode, + instructionSequenceMatcher.matchedArgument(simpleInstruction.constant)); + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + replacementInstruction = + new VariableInstruction(variableInstruction.opcode, + instructionSequenceMatcher.matchedArgument(variableInstruction.variableIndex), + instructionSequenceMatcher.matchedArgument(variableInstruction.constant)); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + replacementInstruction = + new ConstantInstruction(constantInstruction.opcode, + instructionSequenceMatcher.matchedConstantIndex(constantInstruction.constantIndex), + instructionSequenceMatcher.matchedArgument(constantInstruction.constant)); + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + replacementInstruction = + new BranchInstruction(branchInstruction.opcode, + instructionSequenceMatcher.matchedBranchOffset(offset, branchInstruction.branchOffset)); + } + + + public void visitTableSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, TableSwitchInstruction tableSwitchInstruction) + { + replacementInstruction = + new TableSwitchInstruction(tableSwitchInstruction.opcode, + instructionSequenceMatcher.matchedBranchOffset(offset, tableSwitchInstruction.defaultOffset), + instructionSequenceMatcher.matchedArgument(tableSwitchInstruction.lowCase), + instructionSequenceMatcher.matchedArgument(tableSwitchInstruction.highCase), + instructionSequenceMatcher.matchedJumpOffsets(offset, tableSwitchInstruction.jumpOffsets)); + + } + + + public void visitLookUpSwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, LookUpSwitchInstruction lookUpSwitchInstruction) + { + replacementInstruction = + new LookUpSwitchInstruction(lookUpSwitchInstruction.opcode, + instructionSequenceMatcher.matchedBranchOffset(offset, lookUpSwitchInstruction.defaultOffset), + instructionSequenceMatcher.matchedArguments(lookUpSwitchInstruction.cases), + instructionSequenceMatcher.matchedJumpOffsets(offset, lookUpSwitchInstruction.jumpOffsets)); + } + } +} diff --git a/src/proguard/optimize/peephole/InstructionSequencesReplacer.java b/src/proguard/optimize/peephole/InstructionSequencesReplacer.java new file mode 100644 index 0000000..f12b51a --- /dev/null +++ b/src/proguard/optimize/peephole/InstructionSequencesReplacer.java @@ -0,0 +1,138 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.constant.Constant; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.Instruction; +import proguard.classfile.instruction.visitor.*; + +/** + * This InstructionVisitor replaces multiple instruction sequences at once. + * + * @see InstructionSequenceReplacer + * @author Eric Lafortune + */ +public class InstructionSequencesReplacer +extends MultiInstructionVisitor +implements InstructionVisitor +{ + private static final int PATTERN_INDEX = 0; + private static final int REPLACEMENT_INDEX = 1; + + + /** + * Creates a new InstructionSequencesReplacer. + * @param patternConstants any constants referenced by the pattern + * instruction. + * @param instructionSequences the instruction sequences to be replaced, + * with subsequently the sequence pair index, + * the patten/replacement index (0 or 1), + * and the instruction index in the sequence. + * @param branchTargetFinder a branch target finder that has been + * initialized to indicate branch targets + * in the visited code. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + */ + public InstructionSequencesReplacer(Constant[] patternConstants, + Instruction[][][] instructionSequences, + BranchTargetFinder branchTargetFinder, + CodeAttributeEditor codeAttributeEditor) + { + this(patternConstants, + instructionSequences, + branchTargetFinder, + codeAttributeEditor, + null); + } + + + /** + * Creates a new InstructionSequenceReplacer. + * @param patternConstants any constants referenced by the pattern + * instruction. + * @param instructionSequences the instruction sequences to be replaced, + * with subsequently the sequence pair index, + * the patten/replacement index (0 or 1), + * and the instruction index in the sequence. + * @param branchTargetFinder a branch target finder that has been + * initialized to indicate branch targets + * in the visited code. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + * @param extraInstructionVisitor an optional extra visitor for all deleted + * load instructions. + */ + public InstructionSequencesReplacer(Constant[] patternConstants, + Instruction[][][] instructionSequences, + BranchTargetFinder branchTargetFinder, + CodeAttributeEditor codeAttributeEditor, + InstructionVisitor extraInstructionVisitor) + { + super(createInstructionSequenceReplacers(patternConstants, + instructionSequences, + branchTargetFinder, + codeAttributeEditor, + extraInstructionVisitor)); + } + + + /** + * Creates an array of InstructionSequenceReplacer instances. + * @param patternConstants any constants referenced by the pattern + * instruction. + * @param instructionSequences the instruction sequences to be replaced, + * with subsequently the sequence pair index, + * the from/to index (0 or 1), and the + * instruction index in the sequence. + * @param branchTargetFinder a branch target finder that has been + * initialized to indicate branch targets + * in the visited code. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + * @param extraInstructionVisitor an optional extra visitor for all deleted + * load instructions. + */ + private static InstructionVisitor[] createInstructionSequenceReplacers(Constant[] patternConstants, + Instruction[][][] instructionSequences, + BranchTargetFinder branchTargetFinder, + CodeAttributeEditor codeAttributeEditor, + InstructionVisitor extraInstructionVisitor) + { + InstructionVisitor[] instructionSequenceReplacers = + new InstructionSequenceReplacer[instructionSequences.length]; + + for (int index = 0; index < instructionSequenceReplacers.length; index++) + { + Instruction[][] instructionSequencePair = instructionSequences[index]; + instructionSequenceReplacers[index] = + new InstructionSequenceReplacer(patternConstants, + instructionSequencePair[PATTERN_INDEX], + instructionSequencePair[REPLACEMENT_INDEX], + branchTargetFinder, + codeAttributeEditor, + extraInstructionVisitor); + } + + return instructionSequenceReplacers; + } +} diff --git a/src/proguard/optimize/peephole/MemberPrivatizer.java b/src/proguard/optimize/peephole/MemberPrivatizer.java new file mode 100644 index 0000000..55b2f31 --- /dev/null +++ b/src/proguard/optimize/peephole/MemberPrivatizer.java @@ -0,0 +1,103 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.editor.MethodInvocationFixer; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.NonPrivateMemberMarker; + +/** + * This MemberVisitor makes all class members that it visits private, unless + * they have been marked by a NonPrivateMemberMarker. The invocations of + * privatized methods still have to be fixed. + * + * @see NonPrivateMemberMarker + * @see MethodInvocationFixer + * @author Eric Lafortune + */ +public class MemberPrivatizer +extends SimplifiedVisitor +implements MemberVisitor +{ + private final MemberVisitor extraMemberVisitor; + + + /** + * Creates a new MemberPrivatizer. + */ + public MemberPrivatizer() + { + this(null); + } + + + /** + * Creates a new MemberPrivatizer. + * @param extraMemberVisitor an optional extra visitor for all privatized + * class members. + */ + public MemberPrivatizer(MemberVisitor extraMemberVisitor) + { + this.extraMemberVisitor = extraMemberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Is the field unmarked? + if (NonPrivateMemberMarker.canBeMadePrivate(programField)) + { + // Make the field private. + programField.u2accessFlags = + AccessUtil.replaceAccessFlags(programField.u2accessFlags, + ClassConstants.INTERNAL_ACC_PRIVATE); + + // Visit the field, if required. + if (extraMemberVisitor != null) + { + extraMemberVisitor.visitProgramField(programClass, programField); + } + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Is the method unmarked? + if (NonPrivateMemberMarker.canBeMadePrivate(programMethod)) + { + // Make the method private. + programMethod.u2accessFlags = + AccessUtil.replaceAccessFlags(programMethod.u2accessFlags, + ClassConstants.INTERNAL_ACC_PRIVATE); + + // Visit the method, if required. + if (extraMemberVisitor != null) + { + extraMemberVisitor.visitProgramMethod(programClass, programMethod); + } + } + } +} diff --git a/src/proguard/optimize/peephole/MethodFinalizer.java b/src/proguard/optimize/peephole/MethodFinalizer.java new file mode 100644 index 0000000..af1811b --- /dev/null +++ b/src/proguard/optimize/peephole/MethodFinalizer.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; +import proguard.optimize.KeepMarker; + +/** + * This MemberVisitor makes the program methods that it visits + * final, if possible. + * + * @author Eric Lafortune + */ +public class MethodFinalizer +extends SimplifiedVisitor +implements MemberVisitor +{ + private final MemberVisitor extraMemberVisitor; + + private final MemberFinder memberFinder = new MemberFinder(); + + + /** + * Creates a new ClassFinalizer. + */ + public MethodFinalizer() + { + this(null); + } + + + /** + * Creates a new ClassFinalizer. + * @param extraMemberVisitor an optional extra visitor for all finalized + * methods. + */ + public MethodFinalizer(MemberVisitor extraMemberVisitor) + { + this.extraMemberVisitor = extraMemberVisitor; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + String name = programMethod.getName(programClass); + + // If the method is not already private/static/final/abstract, + // and it is not a constructor, + // and its class is final, + // or it is not being kept and it is not overridden, + // then make it final. + if ((programMethod.u2accessFlags & (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC | + ClassConstants.INTERNAL_ACC_FINAL | + ClassConstants.INTERNAL_ACC_ABSTRACT)) == 0 && + !name.equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) && + ((programClass.u2accessFlags & ClassConstants.INTERNAL_ACC_FINAL) != 0 || + (!KeepMarker.isKept(programMethod) && + (programClass.subClasses == null || + !memberFinder.isOverriden(programClass, programMethod))))) + { + programMethod.u2accessFlags |= ClassConstants.INTERNAL_ACC_FINAL; + + // Visit the method, if required. + if (extraMemberVisitor != null) + { + extraMemberVisitor.visitProgramMethod(programClass, programMethod); + } + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/MethodInliner.java b/src/proguard/optimize/peephole/MethodInliner.java new file mode 100644 index 0000000..55f9ccb --- /dev/null +++ b/src/proguard/optimize/peephole/MethodInliner.java @@ -0,0 +1,567 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.editor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.info.*; + +import java.util.Stack; + +/** + * This AttributeVisitor inlines short methods or methods that are only invoked + * once, in the code attributes that it visits. + * + * @author Eric Lafortune + */ +public class MethodInliner +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ConstantVisitor, + MemberVisitor +{ + private static final int MAXIMUM_INLINED_CODE_LENGTH = Integer.parseInt(System.getProperty("maximum.inlined.code.length", "8")); + private static final int MAXIMUM_RESULTING_CODE_LENGTH_JSE = Integer.parseInt(System.getProperty("maximum.resulting.code.length", "8000")); + private static final int MAXIMUM_RESULTING_CODE_LENGTH_JME = Integer.parseInt(System.getProperty("maximum.resulting.code.length", "2000")); + private static final int MAXIMUM_CODE_EXPANSION = 2; + private static final int MAXIMUM_EXTRA_CODE_LENGTH = 128; + + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private final boolean microEdition; + private final boolean allowAccessModification; + private final boolean inlineSingleInvocations; + private final InstructionVisitor extraInlinedInvocationVisitor; + + private final CodeAttributeComposer codeAttributeComposer = new CodeAttributeComposer(); + private final AccessMethodMarker accessMethodMarker = new AccessMethodMarker(); + private final CatchExceptionMarker catchExceptionMarker = new CatchExceptionMarker(); + private final StackSizeComputer stackSizeComputer = new StackSizeComputer(); + + private ProgramClass targetClass; + private ProgramMethod targetMethod; + private ConstantAdder constantAdder; + private ExceptionInfoAdder exceptionInfoAdder; + private int estimatedResultingCodeLength; + private boolean inlining; + private Stack inliningMethods = new Stack(); + private boolean emptyInvokingStack; + private int uninitializedObjectCount; + private int variableOffset; + private boolean inlined; + private boolean inlinedAny; + + + /** + * Creates a new MethodInliner. + * @param microEdition indicates whether the resulting code is + * targeted at Java Micro Edition. + * @param allowAccessModification indicates whether the access modifiers of + * classes and class members can be changed + * in order to inline methods. + * @param inlineSingleInvocations indicates whether the single invocations + * should be inlined, or, alternatively, + * short methods. + */ + public MethodInliner(boolean microEdition, + boolean allowAccessModification, + boolean inlineSingleInvocations) + { + this(microEdition, + allowAccessModification, + inlineSingleInvocations, + null); + } + + + /** + * Creates a new MethodInliner. + * @param microEdition indicates whether the resulting code is + * targeted at Java Micro Edition. + * @param allowAccessModification indicates whether the access modifiers of + * classes and class members can be changed + * in order to inline methods. + * @param inlineSingleInvocations indicates whether the single invocations + * should be inlined, or, alternatively, + * short methods. + * @param extraInlinedInvocationVisitor an optional extra visitor for all + * inlined invocation instructions. + */ + public MethodInliner(boolean microEdition, + boolean allowAccessModification, + boolean inlineSingleInvocations, + InstructionVisitor extraInlinedInvocationVisitor) + { + this.microEdition = microEdition; + this.allowAccessModification = allowAccessModification; + this.inlineSingleInvocations = inlineSingleInvocations; + this.extraInlinedInvocationVisitor = extraInlinedInvocationVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (!inlining) + { +// codeAttributeComposer.DEBUG = DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + targetClass = (ProgramClass)clazz; + targetMethod = (ProgramMethod)method; + constantAdder = new ConstantAdder(targetClass); + exceptionInfoAdder = new ExceptionInfoAdder(targetClass, codeAttributeComposer); + estimatedResultingCodeLength = codeAttribute.u4codeLength; + inliningMethods.clear(); + uninitializedObjectCount = method.getName(clazz).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) ? 1 : 0; + inlinedAny = false; + codeAttributeComposer.reset(); + stackSizeComputer.visitCodeAttribute(clazz, method, codeAttribute); + + // Append the body of the code. + copyCode(clazz, method, codeAttribute); + + targetClass = null; + targetMethod = null; + constantAdder = null; + + // Update the code attribute if any code has been inlined. + if (inlinedAny) + { + codeAttributeComposer.visitCodeAttribute(clazz, method, codeAttribute); + + // Update the accessing flags. + codeAttribute.instructionsAccept(clazz, method, accessMethodMarker); + + // Update the exception catching flags. + catchExceptionMarker.visitCodeAttribute(clazz, method, codeAttribute); + } + } + + // Only inline the method if it is invoked once or if it is short. + else if ((inlineSingleInvocations ? + MethodInvocationMarker.getInvocationCount(method) == 1 : + codeAttribute.u4codeLength <= MAXIMUM_INLINED_CODE_LENGTH) && + estimatedResultingCodeLength + codeAttribute.u4codeLength < + (microEdition ? + MAXIMUM_RESULTING_CODE_LENGTH_JME : + MAXIMUM_RESULTING_CODE_LENGTH_JSE)) + { + if (DEBUG) + { + System.out.println("MethodInliner: inlining ["+ + clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"] in ["+ + targetClass.getName()+"."+targetMethod.getName(targetClass)+targetMethod.getDescriptor(targetClass)+"]"); + } + + // Ignore the removal of the original method invocation, + // the addition of the parameter setup, and + // the modification of a few inlined instructions. + estimatedResultingCodeLength += codeAttribute.u4codeLength; + + // Append instructions to store the parameters. + storeParameters(clazz, method); + + // Inline the body of the code. + copyCode(clazz, method, codeAttribute); + + inlined = true; + inlinedAny = true; + } + } + + + /** + * Appends instructions to pop the parameters for the given method, storing + * them in new local variables. + */ + private void storeParameters(Clazz clazz, Method method) + { + String descriptor = method.getDescriptor(clazz); + + boolean isStatic = + (method.getAccessFlags() & ClassConstants.INTERNAL_ACC_STATIC) != 0; + + // Count the number of parameters, taking into account their categories. + int parameterCount = ClassUtil.internalMethodParameterCount(descriptor); + int parameterSize = ClassUtil.internalMethodParameterSize(descriptor); + int parameterOffset = isStatic ? 0 : 1; + + // Store the parameter types. + String[] parameterTypes = new String[parameterSize]; + + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(descriptor); + + for (int parameterIndex = 0; parameterIndex < parameterSize; parameterIndex++) + { + String parameterType = internalTypeEnumeration.nextType(); + parameterTypes[parameterIndex] = parameterType; + if (ClassUtil.internalTypeSize(parameterType) == 2) + { + parameterIndex++; + } + } + + codeAttributeComposer.beginCodeFragment(parameterSize+1); + + // Go over the parameter types backward, storing the stack entries + // in their corresponding variables. + for (int parameterIndex = parameterSize-1; parameterIndex >= 0; parameterIndex--) + { + String parameterType = parameterTypes[parameterIndex]; + if (parameterType != null) + { + byte opcode; + switch (parameterType.charAt(0)) + { + case ClassConstants.INTERNAL_TYPE_BOOLEAN: + case ClassConstants.INTERNAL_TYPE_BYTE: + case ClassConstants.INTERNAL_TYPE_CHAR: + case ClassConstants.INTERNAL_TYPE_SHORT: + case ClassConstants.INTERNAL_TYPE_INT: + opcode = InstructionConstants.OP_ISTORE; + break; + + case ClassConstants.INTERNAL_TYPE_LONG: + opcode = InstructionConstants.OP_LSTORE; + break; + + case ClassConstants.INTERNAL_TYPE_FLOAT: + opcode = InstructionConstants.OP_FSTORE; + break; + + case ClassConstants.INTERNAL_TYPE_DOUBLE: + opcode = InstructionConstants.OP_DSTORE; + break; + + default: + opcode = InstructionConstants.OP_ASTORE; + break; + } + + codeAttributeComposer.appendInstruction(parameterSize-parameterIndex-1, + new VariableInstruction(opcode, variableOffset + parameterOffset + parameterIndex).shrink()); + } + } + + // Put the 'this' reference in variable 0 (plus offset). + if (!isStatic) + { + codeAttributeComposer.appendInstruction(parameterSize, + new VariableInstruction(InstructionConstants.OP_ASTORE, variableOffset).shrink()); + } + + codeAttributeComposer.endCodeFragment(); + } + + + /** + * Appends the code of the given code attribute. + */ + private void copyCode(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // The code may expand, due to expanding constant and variable + // instructions. + codeAttributeComposer.beginCodeFragment(codeAttribute.u4codeLength); + + // Copy the instructions. + codeAttribute.instructionsAccept(clazz, method, this); + + // Copy the exceptions. + codeAttribute.exceptionsAccept(clazz, method, exceptionInfoAdder); + + // Append a label just after the code. + codeAttributeComposer.appendLabel(codeAttribute.u4codeLength); + + codeAttributeComposer.endCodeFragment(); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + codeAttributeComposer.appendInstruction(offset, instruction.shrink()); + } + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + // Are we inlining this instruction? + if (inlining) + { + // Replace any return instructions by branches to the end of the code. + switch (simpleInstruction.opcode) + { + case InstructionConstants.OP_IRETURN: + case InstructionConstants.OP_LRETURN: + case InstructionConstants.OP_FRETURN: + case InstructionConstants.OP_DRETURN: + case InstructionConstants.OP_ARETURN: + case InstructionConstants.OP_RETURN: + // Are we not at the last instruction? + if (offset < codeAttribute.u4codeLength-1) + { + // Replace the return instruction by a branch instruction. + Instruction branchInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO_W, + codeAttribute.u4codeLength - offset); + + codeAttributeComposer.appendInstruction(offset, + branchInstruction.shrink()); + } + else + { + // Just leave out the instruction, but put in a label, + // for the sake of any other branch instructions. + codeAttributeComposer.appendLabel(offset); + } + + return; + } + } + + codeAttributeComposer.appendInstruction(offset, simpleInstruction.shrink()); + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + // Are we inlining this instruction? + if (inlining) + { + // Update the variable index. + variableInstruction.variableIndex += variableOffset; + } + + codeAttributeComposer.appendInstruction(offset, variableInstruction.shrink()); + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + // Is it a method invocation? + switch (constantInstruction.opcode) + { + case InstructionConstants.OP_NEW: + uninitializedObjectCount++; + break; + + case InstructionConstants.OP_INVOKEVIRTUAL: + case InstructionConstants.OP_INVOKESPECIAL: + case InstructionConstants.OP_INVOKESTATIC: + case InstructionConstants.OP_INVOKEINTERFACE: + // See if we can inline it. + inlined = false; + + // Append a label, in case the invocation will be inlined. + codeAttributeComposer.appendLabel(offset); + + emptyInvokingStack = + !inlining && + stackSizeComputer.isReachable(offset) && + stackSizeComputer.getStackSize(offset) == 0; + + variableOffset += codeAttribute.u2maxLocals; + + clazz.constantPoolEntryAccept(constantInstruction.constantIndex, this); + + variableOffset -= codeAttribute.u2maxLocals; + + // Was the method inlined? + if (inlined) + { + if (extraInlinedInvocationVisitor != null) + { + extraInlinedInvocationVisitor.visitConstantInstruction(clazz, method, codeAttribute, offset, constantInstruction); + } + + // The invocation itself is no longer necessary. + return; + } + + break; + } + + // Are we inlining this instruction? + if (inlining) + { + // Make sure the constant is present in the constant pool of the + // target class. + constantInstruction.constantIndex = + constantAdder.addConstant(clazz, constantInstruction.constantIndex); + } + + codeAttributeComposer.appendInstruction(offset, constantInstruction.shrink()); + } + + + // Implementations for ConstantVisitor. + + public void visitInterfaceMethodrefConstant(Clazz clazz, InterfaceMethodrefConstant interfaceMethodrefConstant) {} + + + public void visitMethodrefConstant(Clazz clazz, MethodrefConstant methodrefConstant) + { + methodrefConstant.referencedMemberAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitAnyMember(Clazz Clazz, Member member) {} + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + int accessFlags = programMethod.getAccessFlags(); + + if (// Only inline the method if it is private, static, or final. + (accessFlags & (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC | + ClassConstants.INTERNAL_ACC_FINAL)) != 0 && + + // Only inline the method if it is not synchronized, etc. + (accessFlags & (ClassConstants.INTERNAL_ACC_SYNCHRONIZED | + ClassConstants.INTERNAL_ACC_NATIVE | + ClassConstants.INTERNAL_ACC_INTERFACE | + ClassConstants.INTERNAL_ACC_ABSTRACT)) == 0 && + + // Don't inline an method, except in an method in the + // same class. +// (!programMethod.getName(programClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) || +// (programClass.equals(targetClass) && +// targetMethod.getName(targetClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT))) && + !programMethod.getName(programClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT) && + + // Don't inline a method into itself. + (!programMethod.equals(targetMethod) || + !programClass.equals(targetClass)) && + + // Only inline the method if it isn't recursing. + !inliningMethods.contains(programMethod) && + + // Only inline the method if its target class has at least the + // same version number as the source class, in order to avoid + // introducing incompatible constructs. + targetClass.u4version >= programClass.u4version && + + // Only inline the method if it doesn't invoke a super method, or if + // it is in the same class. + (!SuperInvocationMarker.invokesSuperMethods(programMethod) || + programClass.equals(targetClass)) && + + // Only inline the method if it doesn't branch backward while there + // are uninitialized objects. + (!BackwardBranchMarker.branchesBackward(programMethod) || + uninitializedObjectCount == 0) && + + // Only inline if the code access of the inlined method allows it. + (allowAccessModification || + ((!AccessMethodMarker.accessesPrivateCode(programMethod) || + programClass.equals(targetClass)) && + + (!AccessMethodMarker.accessesPackageCode(programMethod) || + ClassUtil.internalPackageName(programClass.getName()).equals( + ClassUtil.internalPackageName(targetClass.getName()))))) && + +// (!AccessMethodMarker.accessesProtectedCode(programMethod) || +// targetClass.extends_(programClass) || +// targetClass.implements_(programClass)) || + (!AccessMethodMarker.accessesProtectedCode(programMethod) || + programClass.equals(targetClass)) && + + // Only inline the method if it doesn't catch exceptions, or if it + // is invoked with an empty stack. + (!CatchExceptionMarker.catchesExceptions(programMethod) || + emptyInvokingStack) && + + // Only inline the method if it comes from the same class or from + // a class with a static initializer. + (programClass.equals(targetClass) || + programClass.findMethod(ClassConstants.INTERNAL_METHOD_NAME_CLINIT, + ClassConstants.INTERNAL_METHOD_TYPE_CLINIT) == null)) + { +// System.out.print("MethodInliner: inlining "); +// programMethod.accept(programClass, new SimpleClassPrinter(true)); +// System.out.print(" in "); +// targetMethod.accept(targetClass, new SimpleClassPrinter(true)); +// +// System.out.println(" Private: "+ +// (!AccessMethodMarker.accessesPrivateCode(programMethod) || +// programClass.equals(targetClass))); +// +// System.out.println(" Package: "+ +// (!AccessMethodMarker.accessesPackageCode(programMethod) || +// ClassUtil.internalPackageName(programClass.getName()).equals( +// ClassUtil.internalPackageName(targetClass.getName())))); +// +// System.out.println(" Protected: "+ +// ((!AccessMethodMarker.accessesProtectedCode(programMethod) || +// targetClass.extends_(programClass) || +// targetClass.implements_(programClass)) || +// ClassUtil.internalPackageName(programClass.getName()).equals( +// ClassUtil.internalPackageName(targetClass.getName())))); + + boolean oldInlining = inlining; + inlining = true; + inliningMethods.push(programMethod); + + // Inline the method body. + programMethod.attributesAccept(programClass, this); + + // Update the optimization information of the target method. + MethodOptimizationInfo info = + MethodOptimizationInfo.getMethodOptimizationInfo(targetMethod); + if (info != null) + { + info.merge(MethodOptimizationInfo.getMethodOptimizationInfo(programMethod)); + } + + inlining = oldInlining; + inliningMethods.pop(); + } + else if (programMethod.getName(programClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + uninitializedObjectCount--; + } + } +} diff --git a/src/proguard/optimize/peephole/NopRemover.java b/src/proguard/optimize/peephole/NopRemover.java new file mode 100644 index 0000000..69adb30 --- /dev/null +++ b/src/proguard/optimize/peephole/NopRemover.java @@ -0,0 +1,89 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.CodeAttribute; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor removes all nop instructions that it encounters. + * + * @author Eric Lafortune + */ +public class NopRemover +extends SimplifiedVisitor +implements InstructionVisitor +{ + private final CodeAttributeEditor codeAttributeEditor; + private final InstructionVisitor extraInstructionVisitor; + + + /** + * Creates a new NopRemover. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + */ + public NopRemover(CodeAttributeEditor codeAttributeEditor) + { + this(codeAttributeEditor, null); + } + + + /** + * Creates a new NopRemover. + * @param codeAttributeEditor a code editor that can be used for + * accumulating changes to the code. + * @param extraInstructionVisitor an optional extra visitor for all removed + * nop instructions. + */ + public NopRemover(CodeAttributeEditor codeAttributeEditor, + InstructionVisitor extraInstructionVisitor) + { + this.codeAttributeEditor = codeAttributeEditor; + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + // Check if the instruction is a nop instruction. + if (simpleInstruction.opcode == InstructionConstants.OP_NOP && + !codeAttributeEditor.isModified(offset)) + { + codeAttributeEditor.deleteInstruction(offset); + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + extraInstructionVisitor.visitSimpleInstruction(clazz, method, codeAttribute, offset, simpleInstruction); + } + } + } +} diff --git a/src/proguard/optimize/peephole/PeepholeOptimizer.java b/src/proguard/optimize/peephole/PeepholeOptimizer.java new file mode 100644 index 0000000..98f8e8d --- /dev/null +++ b/src/proguard/optimize/peephole/PeepholeOptimizer.java @@ -0,0 +1,103 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor sets up and applies the peephole optimizations of its + * instruction visitor. The instruction visitor should be using the same + * (optional) branch target finder and code attribute editor. + * + * @author Eric Lafortune + */ +public class PeepholeOptimizer +extends SimplifiedVisitor +implements AttributeVisitor +{ + private final BranchTargetFinder branchTargetFinder; + private final CodeAttributeEditor codeAttributeEditor; + private final InstructionVisitor instructionVisitor; + + + /** + * Creates a new PeepholeOptimizer. + * @param codeAttributeEditor the code attribute editor that will be reset + * and then executed. + * @param instructionVisitor the instruction visitor that performs + * peephole optimizations using the above code + * attribute editor. + */ + public PeepholeOptimizer(CodeAttributeEditor codeAttributeEditor, + InstructionVisitor instructionVisitor) + { + this(null, codeAttributeEditor, instructionVisitor); + } + + + /** + * Creates a new PeepholeOptimizer. + * @param branchTargetFinder branch target finder that will be initialized + * to indicate branch targets in the visited code. + * @param codeAttributeEditor the code attribute editor that will be reset + * and then executed. + * @param instructionVisitor the instruction visitor that performs + * peephole optimizations using the above code + * attribute editor. + */ + public PeepholeOptimizer(BranchTargetFinder branchTargetFinder, + CodeAttributeEditor codeAttributeEditor, + InstructionVisitor instructionVisitor) + { + this.branchTargetFinder = branchTargetFinder; + this.codeAttributeEditor = codeAttributeEditor; + this.instructionVisitor = instructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (branchTargetFinder != null) + { + // Set up the branch target finder. + branchTargetFinder.visitCodeAttribute(clazz, method, codeAttribute); + } + + // Set up the code attribute editor. + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + // Find the peephole optimizations. + codeAttribute.instructionsAccept(clazz, method, instructionVisitor); + + // Apply the peephole optimizations. + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } +} diff --git a/src/proguard/optimize/peephole/ReachableCodeMarker.java b/src/proguard/optimize/peephole/ReachableCodeMarker.java new file mode 100644 index 0000000..d9dbf2d --- /dev/null +++ b/src/proguard/optimize/peephole/ReachableCodeMarker.java @@ -0,0 +1,263 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This AttributeVisitor finds all instruction offsets, branch targets, and + * exception targets in the CodeAttribute objects that it visits. + * + * @author Eric Lafortune + */ +public class ReachableCodeMarker +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor +{ + private boolean[] isReachable = new boolean[ClassConstants.TYPICAL_CODE_LENGTH]; + + private boolean next; + private boolean evaluateExceptions; + + + /** + * Returns whether the instruction at the given offset is reachable in + * the CodeAttribute that was visited most recently. + */ + public boolean isReachable(int offset) + { + return isReachable[offset]; + } + + + /** + * Returns whether any of the instructions at the given offsets are + * reachable in the CodeAttribute that was visited most recently. + */ + public boolean isReachable(int startOffset, int endOffset) + { + // Check if any of the instructions is reachable. + for (int offset = startOffset; offset < endOffset; offset++) + { + if (isReachable[offset]) + { + return true; + } + } + + return false; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Make sure there is a sufficiently large array. + int codeLength = codeAttribute.u4codeLength; + if (isReachable.length < codeLength) + { + // Create a new array. + isReachable = new boolean[codeLength]; + } + else + { + // Reset the array. + for (int index = 0; index < codeLength; index++) + { + isReachable[index] = false; + } + } + + // Mark the code, starting at the entry point. + markCode(clazz, method, codeAttribute, 0); + + // Mark the exception handlers, iterating as long as necessary. + do + { + evaluateExceptions = false; + + codeAttribute.exceptionsAccept(clazz, method, this); + } + while (evaluateExceptions); + } + + + // Implementations for InstructionVisitor. + + public void visitSimpleInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SimpleInstruction simpleInstruction) + { + byte opcode = simpleInstruction.opcode; + if (opcode == InstructionConstants.OP_IRETURN || + opcode == InstructionConstants.OP_LRETURN || + opcode == InstructionConstants.OP_FRETURN || + opcode == InstructionConstants.OP_DRETURN || + opcode == InstructionConstants.OP_ARETURN || + opcode == InstructionConstants.OP_RETURN || + opcode == InstructionConstants.OP_ATHROW) + { + next = false; + } + } + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + if (variableInstruction.opcode == InstructionConstants.OP_RET) + { + next = false; + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + // Mark the branch target. + markBranchTarget(clazz, + method, + codeAttribute, + offset + branchInstruction.branchOffset); + + byte opcode = branchInstruction.opcode; + if (opcode == InstructionConstants.OP_GOTO || + opcode == InstructionConstants.OP_GOTO_W) + { + next = false; + } + } + + + public void visitAnySwitchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SwitchInstruction switchInstruction) + { + // Mark the branch targets of the default jump offset. + markBranchTarget(clazz, + method, + codeAttribute, + offset + switchInstruction.defaultOffset); + + // Mark the branch targets of the jump offsets. + markBranchTargets(clazz, + method, + codeAttribute, + offset, + switchInstruction.jumpOffsets); + + next = false; + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + // Mark the exception handler if it's relevant. + if (!isReachable(exceptionInfo.u2handlerPC) && + isReachable(exceptionInfo.u2startPC, exceptionInfo.u2endPC)) + { + markCode(clazz, method, codeAttribute, exceptionInfo.u2handlerPC); + + evaluateExceptions = true; + } + } + + + // Small utility methods. + + /** + * Marks the branch targets of the given jump offsets for the instruction + * at the given offset. + */ + private void markBranchTargets(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, int[] jumpOffsets) + { + for (int index = 0; index < jumpOffsets.length; index++) + { + markCode(clazz, method, codeAttribute, offset + jumpOffsets[index]); + } + } + + + /** + * Marks the branch target at the given offset. + */ + private void markBranchTarget(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset) + { + boolean oldNext = next; + + markCode(clazz, method, codeAttribute, offset); + + next = oldNext; + } + + + /** + * Marks the code starting at the given offset. + */ + private void markCode(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset) + { + boolean oldNext = next; + + byte[] code = codeAttribute.code; + + // Continue with the current instruction as long as we haven't marked it + // yet. + while (!isReachable[offset]) + { + // Get the current instruction. + Instruction instruction = InstructionFactory.create(code, offset); + + // Mark it as reachable. + isReachable[offset] = true; + + // By default, we'll assume we can continue with the next + // instruction in a moment. + next = true; + + // Mark the branch targets, if any. + instruction.accept(clazz, method, codeAttribute, offset, this); + + // Can we really continue with the next instruction? + if (!next) + { + break; + } + + // Go to the next instruction. + offset += instruction.length(offset); + } + + next = oldNext; + } +} diff --git a/src/proguard/optimize/peephole/RetargetedInnerClassAttributeRemover.java b/src/proguard/optimize/peephole/RetargetedInnerClassAttributeRemover.java new file mode 100644 index 0000000..6707a12 --- /dev/null +++ b/src/proguard/optimize/peephole/RetargetedInnerClassAttributeRemover.java @@ -0,0 +1,140 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.ClassConstant; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor removes InnerClasses and EnclosingMethod attributes in + * classes that are retargeted or that refer to classes that are retargeted. + * + * @see ClassMerger + * @author Eric Lafortune + */ +public class RetargetedInnerClassAttributeRemover +extends SimplifiedVisitor +implements ClassVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + ConstantVisitor +{ + private boolean retargeted; + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + int attributesCount = programClass.u2attributesCount; + Attribute[] attributes = programClass.attributes; + + int newAtributesCount = 0; + + // Copy over all non-retargeted attributes. + for (int index = 0; index < attributesCount; index++) + { + Attribute attribute = attributes[index]; + + // Check if it's an InnerClasses or EnclosingMethod attribute in + // a retargeted class or referring to a retargeted class. + retargeted = false; + attribute.accept(programClass, this); + if (!retargeted) + { + attributes[newAtributesCount++] = attribute; + } + } + + // Clean up any remaining array elements. + for (int index = newAtributesCount; index < attributesCount; index++) + { + attributes[index] = null; + } + + // Update the number of attribuets. + programClass.u2attributesCount = newAtributesCount; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Check whether the class itself is retargeted. + checkTarget(clazz); + + // Check whether the referenced classes are retargeted. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + // Check whether the class itself is retargeted. + checkTarget(clazz); + + // Check whether the referenced class is retargeted. + checkTarget(enclosingMethodAttribute.referencedClass); + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + // Check whether the inner class or the outer class are retargeted. + innerClassesInfo.innerClassConstantAccept(clazz, this); + innerClassesInfo.outerClassConstantAccept(clazz, this); + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Check whether the referenced class is retargeted. + checkTarget(classConstant.referencedClass); + } + + + // Small utility methods. + + /** + * Sets the global return value to true if the given class is retargeted. + */ + private void checkTarget(Clazz clazz) + { + if (clazz != null && + ClassMerger.getTargetClass(clazz) != null) + { + retargeted = true; + } + } +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/TargetClassChanger.java b/src/proguard/optimize/peephole/TargetClassChanger.java new file mode 100644 index 0000000..22fd83d --- /dev/null +++ b/src/proguard/optimize/peephole/TargetClassChanger.java @@ -0,0 +1,439 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.editor.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor replaces references to classes and class members if the + * classes have targets that are intended to replace them. + * + * @see VerticalClassMerger + * @see ClassReferenceFixer + * @see MemberReferenceFixer + * @author Eric Lafortune + */ +public class TargetClassChanger +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor, + MemberVisitor, + AttributeVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + Clazz superClass = null; + Clazz[] interfaceClasses = null; + + // Change the references of the constant pool. + programClass.constantPoolEntriesAccept(this); + + // Change the references of the class members. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + // Change the references of the attributes. + programClass.attributesAccept(this); + + // Is the class itself being retargeted? + Clazz targetClass = ClassMerger.getTargetClass(programClass); + if (targetClass != null) + { + // Restore the class name. We have to add a new class entry + // to avoid an existing entry with the same name being reused. The + // names have to be fixed later, based on their referenced classes. + programClass.u2thisClass = + addNewClassConstant(programClass, + programClass.getName(), + programClass); + + // This class will loose all its subclasses. + programClass.subClasses = null; + } + + // Remove interface classes that are pointing to this class. + int newInterfacesCount = 0; + for (int index = 0; index < programClass.u2interfacesCount; index++) + { + Clazz interfaceClass = programClass.getInterface(index); + if (!programClass.equals(interfaceClass)) + { + programClass.u2interfaces[newInterfacesCount++] = + programClass.u2interfaces[index]; + } + } + programClass.u2interfacesCount = newInterfacesCount; + + // Update the subclasses of the superclass and interfaces of the + // target class. + ConstantVisitor subclassAdder = + new ReferencedClassVisitor( + new SubclassFilter(programClass, + new SubclassAdder(programClass))); + + programClass.superClassConstantAccept(subclassAdder); + programClass.interfaceConstantsAccept(subclassAdder); + + // TODO: Maybe restore private method references. + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Change the references of the class members. + libraryClass.fieldsAccept(this); + libraryClass.methodsAccept(this); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Change the referenced class. + programField.referencedClass = + updateReferencedClass(programField.referencedClass); + + // Change the references of the attributes. + programField.attributesAccept(programClass, this); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Change the referenced classes. + updateReferencedClasses(programMethod.referencedClasses); + + // Change the references of the attributes. + programMethod.attributesAccept(programClass, this); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + // Change the referenced class. + libraryField.referencedClass = + updateReferencedClass(libraryField.referencedClass); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Change the referenced classes. + updateReferencedClasses(libraryMethod.referencedClasses); + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) {} + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + // Does the string refer to a class, due to a Class.forName construct? + Clazz referencedClass = stringConstant.referencedClass; + Clazz newReferencedClass = updateReferencedClass(referencedClass); + if (referencedClass != newReferencedClass) + { + // Change the referenced class. + stringConstant.referencedClass = newReferencedClass; + + // Change the referenced class member, if applicable. + stringConstant.referencedMember = + updateReferencedMember(stringConstant.referencedMember, + stringConstant.getString(clazz), + null, + newReferencedClass); + } + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + Clazz referencedClass = refConstant.referencedClass; + Clazz newReferencedClass = updateReferencedClass(referencedClass); + if (referencedClass != newReferencedClass) + { + // Change the referenced class. + refConstant.referencedClass = newReferencedClass; + + // Change the referenced class member. + refConstant.referencedMember = + updateReferencedMember(refConstant.referencedMember, + refConstant.getName(clazz), + refConstant.getType(clazz), + newReferencedClass); + } + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + // Change the referenced class. + classConstant.referencedClass = + updateReferencedClass(classConstant.referencedClass); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Change the references of the attributes. + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + // Change the references of the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + // Change the references of the local variables. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + // Change the referenced classes. + updateReferencedClasses(signatureAttribute.referencedClasses); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Change the references of the annotations. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Change the references of the annotations. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Change the references of the annotation. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + // Change the referenced class. + localVariableInfo.referencedClass = + updateReferencedClass(localVariableInfo.referencedClass); + } + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + // Change the referenced classes. + updateReferencedClasses(localVariableTypeInfo.referencedClasses); + } + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Change the referenced classes. + updateReferencedClasses(annotation.referencedClasses); + + // Change the references of the element values. + annotation.elementValuesAccept(clazz, this); + } + + + // Implementations for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) + { + Clazz referencedClass = elementValue.referencedClass; + Clazz newReferencedClass = updateReferencedClass(referencedClass); + if (referencedClass != newReferencedClass) + { + // Change the referenced annotation class. + elementValue.referencedClass = newReferencedClass; + + // Change the referenced method. + elementValue.referencedMethod = + (Method)updateReferencedMember(elementValue.referencedMethod, + elementValue.getMethodName(clazz), + null, + newReferencedClass); + } + } + + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + // Change the referenced annotation class and method. + visitAnyElementValue(clazz, annotation, constantElementValue); + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + // Change the referenced annotation class and method. + visitAnyElementValue(clazz, annotation, enumConstantElementValue); + + // Change the referenced classes. + updateReferencedClasses(enumConstantElementValue.referencedClasses); + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + // Change the referenced annotation class and method. + visitAnyElementValue(clazz, annotation, classElementValue); + + // Change the referenced classes. + updateReferencedClasses(classElementValue.referencedClasses); + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + // Change the referenced annotation class and method. + visitAnyElementValue(clazz, annotation, annotationElementValue); + + // Change the references of the annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Change the referenced annotation class and method. + visitAnyElementValue(clazz, annotation, arrayElementValue); + + // Change the references of the element values. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + // Small utility methods. + + /** + * Updates the retargeted classes in the given array of classes. + */ + private void updateReferencedClasses(Clazz[] referencedClasses) + { + if (referencedClasses == null) + { + return; + } + + for (int index = 0; index < referencedClasses.length; index++) + { + referencedClasses[index] = + updateReferencedClass(referencedClasses[index]); + } + } + + + /** + * Returns the retargeted class of the given class. + */ + private Clazz updateReferencedClass(Clazz referencedClass) + { + if (referencedClass == null) + { + return null; + } + + Clazz targetClazz = ClassMerger.getTargetClass(referencedClass); + return targetClazz != null ? + targetClazz : + referencedClass; + } + + + /** + * Returns the retargeted class member of the given class member. + */ + private Member updateReferencedMember(Member referencedMember, + String name, + String type, + Clazz newReferencedClass) + { + if (referencedMember == null) + { + return null; + } + + return referencedMember instanceof Field ? + (Member)newReferencedClass.findField(name, type) : + (Member)newReferencedClass.findMethod(name, type); + } + + + /** + * Explicitly adds a new class constant for the given class in the given + * program class. + */ + private int addNewClassConstant(ProgramClass programClass, + String className, + Clazz referencedClass) + { + ConstantPoolEditor constantPoolEditor = + new ConstantPoolEditor(programClass); + + int nameIndex = + constantPoolEditor.addUtf8Constant(className); + + int classConstantIndex = + constantPoolEditor.addConstant(new ClassConstant(nameIndex, + referencedClass)); + return classConstantIndex; + } +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/UnreachableCodeRemover.java b/src/proguard/optimize/peephole/UnreachableCodeRemover.java new file mode 100644 index 0000000..e8a99ab --- /dev/null +++ b/src/proguard/optimize/peephole/UnreachableCodeRemover.java @@ -0,0 +1,143 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.CodeAttributeEditor; +import proguard.classfile.instruction.Instruction; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; + +/** + * This InstructionVisitor deletes blocks of code that can never be reached by + * regular calls or branches. + * + * @author Eric Lafortune + */ +public class UnreachableCodeRemover +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + private final InstructionVisitor extraInstructionVisitor; + + private final ReachableCodeMarker reachableCodeMarker = new ReachableCodeMarker(); + private final CodeAttributeEditor codeAttributeEditor = new CodeAttributeEditor(); + + + /** + * Creates a new UnreachableCodeRemover. + */ + public UnreachableCodeRemover() + { + this(null); + } + + + /** + * Creates a new UnreachableCodeRemover. + * @param extraInstructionVisitor an optional extra visitor for all + * deleted instructions. + */ + public UnreachableCodeRemover(InstructionVisitor extraInstructionVisitor) + { + this.extraInstructionVisitor = extraInstructionVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the code has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while removing unreachable code:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + throw ex; + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if (DEBUG) + { + System.out.println("UnreachableCodeRemover: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + } + + reachableCodeMarker.visitCodeAttribute(clazz, method, codeAttribute); + + codeAttributeEditor.reset(codeAttribute.u4codeLength); + + codeAttribute.instructionsAccept(clazz, method, this); + + codeAttributeEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + if (DEBUG) + { + System.out.println(" "+(reachableCodeMarker.isReachable(offset) ? "+" : "-")+" "+instruction.toString(offset)); + } + + // Is this instruction unreachable? + if (!reachableCodeMarker.isReachable(offset)) + { + // Then delete it. + codeAttributeEditor.deleteInstruction(offset); + + // Visit the instruction, if required. + if (extraInstructionVisitor != null) + { + instruction.accept(clazz, method, codeAttribute, offset, extraInstructionVisitor); + } + } + } +} diff --git a/src/proguard/optimize/peephole/UnreachableExceptionRemover.java b/src/proguard/optimize/peephole/UnreachableExceptionRemover.java new file mode 100644 index 0000000..048f5e3 --- /dev/null +++ b/src/proguard/optimize/peephole/UnreachableExceptionRemover.java @@ -0,0 +1,163 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.optimize.info.ExceptionInstructionChecker; + +/** + * This AttributeVisitor removes exception handlers that are unreachable in the + * code attributes that it visits. + * + * @author Eric Lafortune + */ +public class UnreachableExceptionRemover +extends SimplifiedVisitor +implements AttributeVisitor, + ExceptionInfoVisitor +{ + private final ExceptionInfoVisitor extraExceptionInfoVisitor; + + + private final ExceptionInstructionChecker exceptionInstructionChecker = new ExceptionInstructionChecker(); + + + /** + * Creates a new UnreachableExceptionRemover. + */ + public UnreachableExceptionRemover() + { + this(null); + } + + + /** + * Creates a new UnreachableExceptionRemover. + * @param extraExceptionInfoVisitor an optional extra visitor for all + * removed exceptions. + */ + public UnreachableExceptionRemover(ExceptionInfoVisitor extraExceptionInfoVisitor) + { + this.extraExceptionInfoVisitor = extraExceptionInfoVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Go over the exception table. + codeAttribute.exceptionsAccept(clazz, method, this); + + // Remove exceptions with empty code blocks. + codeAttribute.u2exceptionTableLength = + removeEmptyExceptions(codeAttribute.exceptionTable, + codeAttribute.u2exceptionTableLength); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + if (!mayThrowExceptions(clazz, + method, + codeAttribute, + exceptionInfo.u2startPC, + exceptionInfo.u2endPC)) + { + // Make the code block empty. + exceptionInfo.u2endPC = exceptionInfo.u2startPC; + + if (extraExceptionInfoVisitor != null) + { + extraExceptionInfoVisitor.visitExceptionInfo(clazz, method, codeAttribute, exceptionInfo); + } + } + } + + + // Small utility methods. + + /** + * Returns whether the specified block of code may throw exceptions. + */ + private boolean mayThrowExceptions(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int startOffset, + int endOffset) + { + byte[] code = codeAttribute.code; + + // Go over all instructions. + int offset = startOffset; + while (offset < endOffset) + { + // Get the current instruction. + Instruction instruction = InstructionFactory.create(code, offset); + + // Check if it may be throwing exceptions. + if (exceptionInstructionChecker.mayThrowExceptions(clazz, + method, + codeAttribute, + offset, + instruction)) + { + return true; + } + + // Go to the next instruction. + offset += instruction.length(offset); + } + + return false; + } + + + /** + * Returns the given list of exceptions, without the ones that have empty + * code blocks. + */ + private int removeEmptyExceptions(ExceptionInfo[] exceptionInfos, + int exceptionInfoCount) + { + // Overwrite all empty exceptions. + int newIndex = 0; + for (int index = 0; index < exceptionInfoCount; index++) + { + ExceptionInfo exceptionInfo = exceptionInfos[index]; + if (exceptionInfo.u2startPC < exceptionInfo.u2endPC) + { + exceptionInfos[newIndex++] = exceptionInfo; + } + } + + return newIndex; + } +} diff --git a/src/proguard/optimize/peephole/VariableShrinker.java b/src/proguard/optimize/peephole/VariableShrinker.java new file mode 100644 index 0000000..45b694f --- /dev/null +++ b/src/proguard/optimize/peephole/VariableShrinker.java @@ -0,0 +1,129 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.VariableEditor; +import proguard.classfile.util.*; +import proguard.classfile.visitor.MemberVisitor; +import proguard.optimize.*; +import proguard.optimize.info.*; + +/** + * This MemberVisitor removes unused local variables from the code of the methods + * that it visits. + * + * @see ParameterUsageMarker + * @see MethodStaticizer + * @see MethodDescriptorShrinker + * @author Eric Lafortune + */ +public class VariableShrinker +extends SimplifiedVisitor +implements AttributeVisitor +{ + private static final boolean DEBUG = false; + + + private final MemberVisitor extraVariableMemberVisitor; + + private final VariableUsageMarker variableUsageMarker = new VariableUsageMarker(); + private final VariableEditor variableEditor = new VariableEditor(); + + + /** + * Creates a new VariableShrinker. + */ + public VariableShrinker() + { + this(null); + } + + + /** + * Creates a new VariableShrinker with an extra visitor. + * @param extraVariableMemberVisitor an optional extra visitor for all + * removed variables. + */ + public VariableShrinker(MemberVisitor extraVariableMemberVisitor) + { + this.extraVariableMemberVisitor = extraVariableMemberVisitor; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + if ((method.getAccessFlags() & ClassConstants.INTERNAL_ACC_ABSTRACT) == 0) + { + // Compute the parameter size. + int parameterSize = + ClassUtil.internalMethodParameterSize(method.getDescriptor(clazz), + method.getAccessFlags()); + + // Get the total size of the local variable frame. + int maxLocals = codeAttribute.u2maxLocals; + + if (DEBUG) + { + System.out.println("VariableShrinker: "+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)); + System.out.println(" Parameter size = " + parameterSize); + System.out.println(" Max locals = " + maxLocals); + } + + // Figure out the local variables that are used by the code. + variableUsageMarker.visitCodeAttribute(clazz, method, codeAttribute); + + // Delete unused local variables from the local variable frame. + variableEditor.reset(maxLocals); + + for (int variableIndex = parameterSize; variableIndex < maxLocals; variableIndex++) + { + // Is the variable not required? + if (!variableUsageMarker.isVariableUsed(variableIndex)) + { + if (DEBUG) + { + System.out.println(" Deleting local variable #"+variableIndex); + } + + // Delete the unused variable. + variableEditor.deleteVariable(variableIndex); + + // Visit the method, if required. + if (extraVariableMemberVisitor != null) + { + method.accept(clazz, extraVariableMemberVisitor); + } + } + } + + // Shift all remaining parameters and variables in the byte code. + variableEditor.visitCodeAttribute(clazz, method, codeAttribute); + } + } +} diff --git a/src/proguard/optimize/peephole/VerticalClassMerger.java b/src/proguard/optimize/peephole/VerticalClassMerger.java new file mode 100644 index 0000000..29ed6ff --- /dev/null +++ b/src/proguard/optimize/peephole/VerticalClassMerger.java @@ -0,0 +1,88 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.optimize.peephole; + +import proguard.classfile.ProgramClass; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor inlines the direct subclasses into the program classes + * that it visits, whenever possible. + * + * @see ClassMerger + * @author Eric Lafortune + */ +public class VerticalClassMerger +extends SimplifiedVisitor +implements ClassVisitor +{ + private final boolean allowAccessModification; + private final boolean mergeInterfacesAggressively; + private final ClassVisitor extraClassVisitor; + + + /** + * Creates a new VerticalClassMerger. + * @param allowAccessModification specifies whether the access modifiers + * of classes can be changed in order to + * merge them. + * @param mergeInterfacesAggressively specifies whether interfaces may + * be merged aggressively. + */ + public VerticalClassMerger(boolean allowAccessModification, + boolean mergeInterfacesAggressively) + { + this(allowAccessModification, mergeInterfacesAggressively, null); + } + + + /** + * Creates a new VerticalClassMerger. + * @param allowAccessModification specifies whether the access modifiers + * of classes can be changed in order to + * merge them. + * @param mergeInterfacesAggressively specifies whether interfaces may + * be merged aggressively. + * @param extraClassVisitor an optional extra visitor for all + * merged classes. + */ + public VerticalClassMerger(boolean allowAccessModification, + boolean mergeInterfacesAggressively, + ClassVisitor extraClassVisitor) + { + this.allowAccessModification = allowAccessModification; + this.mergeInterfacesAggressively = mergeInterfacesAggressively; + this.extraClassVisitor = extraClassVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + programClass.subclassesAccept(new ClassMerger(programClass, + allowAccessModification, + mergeInterfacesAggressively, + extraClassVisitor)); + } +} \ No newline at end of file diff --git a/src/proguard/optimize/peephole/package.html b/src/proguard/optimize/peephole/package.html new file mode 100644 index 0000000..e0eeb51 --- /dev/null +++ b/src/proguard/optimize/peephole/package.html @@ -0,0 +1,3 @@ + +This package contains visitors that perform various peephole optimizations. + diff --git a/src/proguard/package.html b/src/proguard/package.html new file mode 100644 index 0000000..986cad8 --- /dev/null +++ b/src/proguard/package.html @@ -0,0 +1,5 @@ + +This package contains the main ProGuard application. +ProGuard can read jar files, shrink and obfuscate them, and write out the +resulting jar file. + diff --git a/src/proguard/preverify/CodePreverifier.java b/src/proguard/preverify/CodePreverifier.java new file mode 100644 index 0000000..fa60b9a --- /dev/null +++ b/src/proguard/preverify/CodePreverifier.java @@ -0,0 +1,611 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.preverify; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.editor.*; +import proguard.classfile.instruction.*; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; +import proguard.evaluation.*; +import proguard.evaluation.value.*; +import proguard.optimize.evaluation.*; + +import java.util.*; + +/** + * This class can preverify methods in program class pools, according to a given + * specification. + * + * @author Eric Lafortune + */ +public class CodePreverifier +extends SimplifiedVisitor +implements MemberVisitor, + AttributeVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private final boolean microEdition; + + private final PartialEvaluator partialEvaluator = new PartialEvaluator(); + private final LivenessAnalyzer livenessAnalyzer = new LivenessAnalyzer(partialEvaluator); + + + /** + * Creates a new CodePreverifier. + */ + public CodePreverifier(boolean microEdition) + { + this.microEdition = microEdition; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // TODO: Remove this when the preverifier has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while preverifying:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + throw ex; + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + ProgramClass programClass = (ProgramClass)clazz; + ProgramMethod programMethod = (ProgramMethod)method; + + // Evaluate the method. + //partialEvaluator.visitCodeAttribute(clazz, method, codeAttribute); + livenessAnalyzer.visitCodeAttribute(clazz, method, codeAttribute); + + // Collect the stack map frames. + List stackMapFrameList = new ArrayList(); + + for (int offset = 0; offset < codeAttribute.u4codeLength; offset++) + { + // Only store frames at the beginning of code blocks. + if (partialEvaluator.isTraced(offset) && + partialEvaluator.isBranchOrExceptionTarget(offset)) + { + // Convert the variable values to types. + VerificationType[] variableTypes = + correspondingVerificationTypes(programClass, + programMethod, + codeAttribute, + offset, + partialEvaluator.getVariablesBefore(offset)); + + // Convert the stack values to types. + VerificationType[] stackTypes = + correspondingVerificationTypes(programClass, + programMethod, + codeAttribute, + offset, + partialEvaluator.getStackBefore(offset)); + // Create and store a new frame. + stackMapFrameList.add(new FullFrame(offset, + variableTypes, + stackTypes)); + } + } + + // Compress the stack map frames if the target is not Java Micro Edition. + if (!microEdition && !stackMapFrameList.isEmpty()) + { + // Convert the initial variable values to types. + VerificationType[] initialVariables = + correspondingVerificationTypes(programClass, + programMethod, + codeAttribute, + PartialEvaluator.AT_METHOD_ENTRY, + partialEvaluator.getVariablesBefore(0)); + + // Special case: the method. + if (method.getName(programClass).equals(ClassConstants.INTERNAL_METHOD_NAME_INIT)) + { + initialVariables[0] = VerificationTypeFactory.createUninitializedThisType(); + } + + compressStackMapFrames(initialVariables, + stackMapFrameList); + } + + // Get the proper name for the attribute to be added/replaced/deleted. + String stackMapAttributeName = microEdition ? + ClassConstants.ATTR_StackMap : + ClassConstants.ATTR_StackMapTable; + + int frameCount = stackMapFrameList.size(); + + if (DEBUG) + { + Attribute originalStackMapAttribute = codeAttribute.getAttribute(clazz, + stackMapAttributeName); + + if (originalStackMapAttribute != null) + { + int originalFrameCount = microEdition ? + ((StackMapAttribute)originalStackMapAttribute).u2stackMapFramesCount : + ((StackMapTableAttribute)originalStackMapAttribute).u2stackMapFramesCount; + + StackMapFrame[] originalFrames = microEdition ? + ((StackMapAttribute)originalStackMapAttribute).stackMapFrames : + ((StackMapTableAttribute)originalStackMapAttribute).stackMapFrames; + + if (frameCount != originalFrameCount || + !Arrays.equals(stackMapFrameList.toArray(), originalFrames)) + { + System.out.println("Original preverification ["+clazz.getName()+"]:"); + new ClassPrinter().visitProgramMethod(programClass, programMethod); + } + } + else if (frameCount != 0) + { + System.out.println("Original preverification empty ["+clazz.getName()+"."+method.getName(clazz)+"]"); + } + } + + if (frameCount == 0) + { + // Remove any stack map (table) attribute from the code attribute. + new AttributesEditor(programClass, programMethod, codeAttribute, true).deleteAttribute(stackMapAttributeName); + } + else + { + Attribute stackMapAttribute; + + // Create the appropriate attribute. + if (microEdition) + { + // Copy the frames into an array. + FullFrame[] stackMapFrames = new FullFrame[frameCount]; + stackMapFrameList.toArray(stackMapFrames); + + // Put the frames into a stack map attribute. + stackMapAttribute = new StackMapAttribute(stackMapFrames); + } + else + { + // Copy the frames into an array. + StackMapFrame[] stackMapFrames = new StackMapFrame[frameCount]; + stackMapFrameList.toArray(stackMapFrames); + + // Put the frames into a stack map table attribute. + stackMapAttribute = new StackMapTableAttribute(stackMapFrames); + } + + // Fill out the name of the stack map attribute. + stackMapAttribute.u2attributeNameIndex = + new ConstantPoolEditor(programClass).addUtf8Constant(stackMapAttributeName); + + // Add the new stack map (table) attribute to the code attribute. + new AttributesEditor(programClass, programMethod, codeAttribute, true).addAttribute(stackMapAttribute); + + if (DEBUG) + { + System.out.println("Preverifier ["+programClass.getName()+"."+programMethod.getName(programClass)+"]:"); + stackMapAttribute.accept(programClass, programMethod, codeAttribute, new ClassPrinter()); + } + } + } + + + // Small utility methods. + + /** + * Creates and returns the verification types corresponding to the given + * variables. If necessary, class constants are added to the constant pool + * of the given class. + */ + private VerificationType[] correspondingVerificationTypes(ProgramClass programClass, + ProgramMethod programMethod, + CodeAttribute codeAttribute, + int offset, + TracedVariables variables) + { + int maximumVariablesSize = variables.size(); + int typeCount = 0; + int typeIndex = 0; + + // Count the the number of verification types, ignoring any nulls at + // the end. + for (int index = 0; index < maximumVariablesSize; index++) + { + Value value = variables.getValue(index); + + typeIndex++; + + // Remember the maximum live type index. + if (value != null && + (offset == PartialEvaluator.AT_METHOD_ENTRY || + livenessAnalyzer.isAliveBefore(offset, index))) + { + typeCount = typeIndex; + + // Category 2 types that are alive are stored as single entries. + if (value.isCategory2()) + { + index++; + } + } + } + + // Create and fill out the verification types. + VerificationType[] types = new VerificationType[typeCount]; + + typeIndex = 0; + + // Note the slightly different terminating condition, because the + // types may have been truncated. + for (int index = 0; typeIndex < typeCount; index++) + { + Value value = variables.getValue(index); + Value producerValue = variables.getProducerValue(index); + + // Fill out the type. + VerificationType type; + + if (value != null && + (offset == PartialEvaluator.AT_METHOD_ENTRY || + livenessAnalyzer.isAliveBefore(offset, index))) + { + type = correspondingVerificationType(programClass, + programMethod, + codeAttribute, + offset, + index == 0, + value, + producerValue); + + // Category 2 types that are alive are stored as single entries. + if (value.isCategory2()) + { + index++; + } + } + else + { + type = VerificationTypeFactory.createTopType(); + } + + types[typeIndex++] = type; + } + + return types; + } + + + /** + * Creates and returns the verification types corresponding to the given + * stack. If necessary, class constants are added to the constant pool + * of the given class. + */ + private VerificationType[] correspondingVerificationTypes(ProgramClass programClass, + ProgramMethod programMethod, + CodeAttribute codeAttribute, + int offset, + TracedStack stack) + { + int maximumStackSize = stack.size(); + int typeCount = 0; + + // Count the the number of verification types. + for (int index = 0; index < maximumStackSize; index++) + { + // We have to work down from the top of the stack. + Value value = stack.getTop(index); + + typeCount++; + + // Category 2 types are stored as single entries. + if (value.isCategory2()) + { + index++; + } + } + + // Create and fill out the verification types. + VerificationType[] types = new VerificationType[typeCount]; + + int typeIndex = typeCount; + + for (int index = 0; index < maximumStackSize; index++) + { + // We have to work down from the top of the stack. + Value value = stack.getTop(index); + Value producerValue = stack.getTopProducerValue(index); + + // Fill out the type. + types[--typeIndex] = + correspondingVerificationType(programClass, + programMethod, + codeAttribute, + offset, + false, + value, + producerValue); + + // Category 2 types are stored as single entries. + if (value.isCategory2()) + { + index++; + } + } + + return types; + } + + + /** + * Creates and returns the verification type corresponding to the given + * value. If necessary, a class constant is added to the constant pool of + * the given class. + */ + private VerificationType correspondingVerificationType(ProgramClass programClass, + ProgramMethod programMethod, + CodeAttribute codeAttribute, + int offset, + boolean isVariable0, + Value value, + Value producerValue) + { + if (value == null) + { + return VerificationTypeFactory.createTopType(); + } + + int type = value.computationalType(); + + switch (type) + { + case Value.TYPE_INSTRUCTION_OFFSET: + case Value.TYPE_INTEGER: return VerificationTypeFactory.createIntegerType(); + case Value.TYPE_LONG: return VerificationTypeFactory.createLongType(); + case Value.TYPE_FLOAT: return VerificationTypeFactory.createFloatType(); + case Value.TYPE_DOUBLE: return VerificationTypeFactory.createDoubleType(); + case Value.TYPE_TOP: return VerificationTypeFactory.createTopType(); + case Value.TYPE_REFERENCE: + // Is it a Null type? + ReferenceValue referenceValue = value.referenceValue(); + if (referenceValue.isNull() == Value.ALWAYS) + { + return VerificationTypeFactory.createNullType(); + } + + // Does the reference type have a single producer? + if (offset != PartialEvaluator.AT_METHOD_ENTRY) + { + InstructionOffsetValue producers = producerValue.instructionOffsetValue(); + if (producers.instructionOffsetCount() == 1) + { + int producerOffset = producers.instructionOffset(0); + + // Follow any dup or swap instructions. + while (producerOffset != PartialEvaluator.AT_METHOD_ENTRY && + isDupOrSwap(codeAttribute.code[producerOffset])) + { + producers = partialEvaluator.getStackBefore(producerOffset).getTopProducerValue(0).instructionOffsetValue(); + producerOffset = producers.instructionOffset(0); + } + + // Are we in an instance initialization method, + // before the super initialization, loading "this"? + if (partialEvaluator.isInitializer() && + offset <= partialEvaluator.superInitializationOffset() && + (isVariable0 || + producerOffset > PartialEvaluator.AT_METHOD_ENTRY && + codeAttribute.code[producerOffset] == InstructionConstants.OP_ALOAD_0)) + { + // It's an UninitializedThis type. + return VerificationTypeFactory.createUninitializedThisType(); + } + + // Is the reference type newly created and still + // uninitialized? + if (producerOffset > PartialEvaluator.AT_METHOD_ENTRY && + offset <= partialEvaluator.initializationOffset(producerOffset)) + { + // It's an Uninitialized type. + return VerificationTypeFactory.createUninitializedType(producerOffset); + } + } + } + + // It's an ordinary Object type. + return VerificationTypeFactory.createObjectType(createClassConstant(programClass, referenceValue)); + } + + throw new IllegalArgumentException("Unknown computational type ["+type+"]"); + } + + + /** + * Finds or creates a class constant for the given reference value, and + * returns its index in the constant pool. + */ + private int createClassConstant(ProgramClass programClass, + ReferenceValue referenceValue) + { + return new ConstantPoolEditor(programClass).addClassConstant(referenceValue.getType(), + referenceValue.getReferencedClass()); + } + + + /** + * Compresses the given list of full frames, for use in a stack map table. + */ + private void compressStackMapFrames(VerificationType[] initialVariableTypes, + List stackMapFrameList) + { + int previousVariablesCount = initialVariableTypes.length; + VerificationType[] previousVariableTypes = initialVariableTypes; + + int previousOffset = -1; + + for (int index = 0; index < stackMapFrameList.size(); index++) + { + FullFrame fullFrame = (FullFrame)stackMapFrameList.get(index); + + int variablesCount = fullFrame.variablesCount; + VerificationType[] variables = fullFrame.variables; + int stackCount = fullFrame.stackCount; + VerificationType[] stack = fullFrame.stack; + + // Start computing the compressed frame. + // The default is the full frame. + StackMapFrame compressedFrame = fullFrame; + + // Are all variables equal? + if (variablesCount == previousVariablesCount && + equalVerificationTypes(variables, previousVariableTypes, variablesCount)) + { + // Are the stacks equal? + //if (stackCount == previousStackCount && + // equalVerificationTypes(stack, previousStack, stackCount)) + //{ + // // Remove the identical frame. + // stackMapFrameList.remove(index--); + // + // // Move on to the next frame (at the same index). + // continue; + //} + // Is the new stack empty? + //else + if (stackCount == 0) + { + compressedFrame = new SameZeroFrame(); + } + // Does the new stack contain a single element? + else if (stackCount == 1) + { + compressedFrame = new SameOneFrame(stack[0]); + } + } + // Is the stack empty? + else if (stackCount == 0) + { + int additionalVariablesCount = variablesCount - previousVariablesCount; + + // Are the variables chopped? + if (additionalVariablesCount < 0 && + additionalVariablesCount > -4 && + equalVerificationTypes(variables, previousVariableTypes, variablesCount)) + { + compressedFrame = new LessZeroFrame((byte)-additionalVariablesCount); + } + // Are the variables extended? + else if (//previousVariablesCount > 0 && + additionalVariablesCount > 0 && + additionalVariablesCount < 4 && + equalVerificationTypes(variables, previousVariableTypes, previousVariablesCount)) + { + // Copy the additional variables into an array. + VerificationType[] additionalVariables = new VerificationType[additionalVariablesCount]; + System.arraycopy(variables, variablesCount - additionalVariablesCount, + additionalVariables, 0, + additionalVariablesCount); + + compressedFrame = new MoreZeroFrame(additionalVariables); + } + } + + // Compress the instruction offset. + int offset = fullFrame.u2offsetDelta; + compressedFrame.u2offsetDelta = offset - previousOffset - 1; + previousOffset = offset; + + // Remember this frame. + previousVariablesCount = fullFrame.variablesCount; + previousVariableTypes = fullFrame.variables; + + // Replace the full frame. + stackMapFrameList.set(index, compressedFrame); + } + } + + + /** + * Returns whether the given arrays of verification types are equal, up to + * the given length. + */ + private boolean equalVerificationTypes(VerificationType[] types1, + VerificationType[] types2, + int length) + { + if (length > 0 && + (types1.length < length || + types2.length < length)) + { + return false; + } + + for (int index = 0; index < length; index++) + { + if (!types1[index].equals(types2[index])) + { + return false; + } + } + + return true; + } + + + /** + * Returns whether the given instruction opcode represents a dup or swap + * instruction (dup, dup_x1, dup_x2, dup2, dup2_x1, dup2_x2, swap). + */ + private boolean isDupOrSwap(int opcode) + { + return opcode >= InstructionConstants.OP_DUP && + opcode <= InstructionConstants.OP_SWAP; + } +} diff --git a/src/proguard/preverify/CodeSubroutineInliner.java b/src/proguard/preverify/CodeSubroutineInliner.java new file mode 100644 index 0000000..603eb75 --- /dev/null +++ b/src/proguard/preverify/CodeSubroutineInliner.java @@ -0,0 +1,405 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.preverify; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.editor.CodeAttributeComposer; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; +import proguard.optimize.peephole.BranchTargetFinder; + +/** + * This AttributeVisitor inlines local subroutines (jsr/ret) in the code + * attributes that it visits. + * + * @author Eric Lafortune + */ +public class CodeSubroutineInliner +extends SimplifiedVisitor +implements AttributeVisitor, + InstructionVisitor, + ExceptionInfoVisitor +{ + //* + private static final boolean DEBUG = false; + /*/ + private static boolean DEBUG = true; + //*/ + + + private final BranchTargetFinder branchTargetFinder = new BranchTargetFinder(); + private final CodeAttributeComposer codeAttributeComposer = new CodeAttributeComposer(true); + + private ExceptionInfoVisitor subroutineExceptionInliner = this; + private int clipStart = 0; + private int clipEnd = Integer.MAX_VALUE; + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { +// DEBUG = +// clazz.getName().equals("abc/Def") && +// method.getName(clazz).equals("abc"); + + // TODO: Remove this when the subroutine inliner has stabilized. + // Catch any unexpected exceptions from the actual visiting method. + try + { + // Process the code. + visitCodeAttribute0(clazz, method, codeAttribute); + } + catch (RuntimeException ex) + { + System.err.println("Unexpected error while inlining subroutines:"); + System.err.println(" Class = ["+clazz.getName()+"]"); + System.err.println(" Method = ["+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + System.err.println(" Exception = ["+ex.getClass().getName()+"] ("+ex.getMessage()+")"); + + if (DEBUG) + { + method.accept(clazz, new ClassPrinter()); + } + + throw ex; + } + } + + + public void visitCodeAttribute0(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + branchTargetFinder.visitCodeAttribute(clazz, method, codeAttribute); + + // Don't bother if there aren't any subroutines anyway. + if (!containsSubroutines(codeAttribute)) + { + return; + } + + if (DEBUG) + { + System.out.println("SubroutineInliner: processing ["+clazz.getName()+"."+method.getName(clazz)+method.getDescriptor(clazz)+"]"); + } + + // Append the body of the code. + codeAttributeComposer.reset(); + codeAttributeComposer.beginCodeFragment(codeAttribute.u4codeLength); + + // Copy the non-subroutine instructions. + int offset = 0; + while (offset < codeAttribute.u4codeLength) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, offset); + int instructionLength = instruction.length(offset); + + // Is this returning subroutine? + if (branchTargetFinder.isSubroutine(offset) && + branchTargetFinder.isSubroutineReturning(offset)) + { + // Skip the subroutine. + if (DEBUG) + { + System.out.println(" Skipping original subroutine instruction "+instruction.toString(offset)); + } + + // Append a label at this offset instead. + codeAttributeComposer.appendLabel(offset); + } + else + { + // Copy the instruction, inlining any subroutine call recursively. + instruction.accept(clazz, method, codeAttribute, offset, this); + } + + offset += instructionLength; + } + + // Copy the exceptions. Note that exceptions with empty try blocks + // are automatically removed. + codeAttribute.exceptionsAccept(clazz, + method, + subroutineExceptionInliner); + + if (DEBUG) + { + System.out.println(" Appending label after code at ["+offset+"]"); + } + + // Append a label just after the code. + codeAttributeComposer.appendLabel(codeAttribute.u4codeLength); + + // End and update the code attribute. + codeAttributeComposer.endCodeFragment(); + codeAttributeComposer.visitCodeAttribute(clazz, method, codeAttribute); + } + + + /** + * Returns whether the given code attribute contains any subroutines. + */ + private boolean containsSubroutines(CodeAttribute codeAttribute) + { + for (int offset = 0; offset < codeAttribute.u4codeLength; offset++) + { + if (branchTargetFinder.isSubroutineInvocation(offset)) + { + return true; + } + } + + return false; + } + + + /** + * Appends the specified subroutine. + */ + private void inlineSubroutine(Clazz clazz, + Method method, + CodeAttribute codeAttribute, + int subroutineInvocationOffset, + int subroutineStart) + { + int subroutineEnd = branchTargetFinder.subroutineEnd(subroutineStart); + + if (DEBUG) + { + System.out.println(" Inlining subroutine ["+subroutineStart+" -> "+subroutineEnd+"] at ["+subroutineInvocationOffset+"]"); + } + + // Don't go inlining exceptions that are already applicable to this + // subroutine invocation. + ExceptionInfoVisitor oldSubroutineExceptionInliner = subroutineExceptionInliner; + int oldClipStart = clipStart; + int oldClipEnd = clipEnd; + + subroutineExceptionInliner = + new ExceptionExcludedOffsetFilter(subroutineInvocationOffset, + subroutineExceptionInliner); + clipStart = subroutineStart; + clipEnd = subroutineEnd; + + codeAttributeComposer.beginCodeFragment(codeAttribute.u4codeLength); + + // Copy the subroutine instructions, inlining any subroutine calls + // recursively. + codeAttribute.instructionsAccept(clazz, + method, + subroutineStart, + subroutineEnd, + this); + + if (DEBUG) + { + System.out.println(" Appending label after inlined subroutine at ["+subroutineEnd+"]"); + } + + // Append a label just after the code. + codeAttributeComposer.appendLabel(subroutineEnd); + + // Inline the subroutine exceptions. + codeAttribute.exceptionsAccept(clazz, + method, + subroutineStart, + subroutineEnd, + subroutineExceptionInliner); + + // We can again inline exceptions that are applicable to this + // subroutine invocation. + subroutineExceptionInliner = oldSubroutineExceptionInliner; + clipStart = oldClipStart; + clipEnd = oldClipEnd; + + codeAttributeComposer.endCodeFragment(); + } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) + { + // Append the instruction. + codeAttributeComposer.appendInstruction(offset, instruction.shrink()); + } + + + public void visitVariableInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VariableInstruction variableInstruction) + { + byte opcode = variableInstruction.opcode; + if (opcode == InstructionConstants.OP_RET) + { + // Is the return instruction the last instruction of the subroutine? + if (branchTargetFinder.subroutineEnd(offset) == offset + variableInstruction.length(offset)) + { + if (DEBUG) + { + System.out.println(" Replacing subroutine return at ["+offset+"] by a label"); + } + + // Append a label at this offset instead of the subroutine return. + codeAttributeComposer.appendLabel(offset); + } + else + { + if (DEBUG) + { + System.out.println(" Replacing subroutine return at ["+offset+"] by a simple branch"); + } + + // Replace the instruction by a branch. + Instruction replacementInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO, + branchTargetFinder.subroutineEnd(offset) - offset).shrink(); + + codeAttributeComposer.appendInstruction(offset, replacementInstruction); + } + } + else if (branchTargetFinder.isSubroutineStart(offset)) + { + if (DEBUG) + { + System.out.println(" Replacing first subroutine instruction at ["+offset+"] by a label"); + } + + // Append a label at this offset instead of saving the subroutine + // return address. + codeAttributeComposer.appendLabel(offset); + } + else + { + // Append the instruction. + codeAttributeComposer.appendInstruction(offset, variableInstruction); + } + } + + + public void visitBranchInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, BranchInstruction branchInstruction) + { + byte opcode = branchInstruction.opcode; + if (opcode == InstructionConstants.OP_JSR || + opcode == InstructionConstants.OP_JSR_W) + { + int branchOffset = branchInstruction.branchOffset; + int branchTarget = offset + branchOffset; + + // Is the subroutine ever returning? + if (branchTargetFinder.isSubroutineReturning(branchTarget)) + { + // Append a label at this offset instead of the subroutine invocation. + codeAttributeComposer.appendLabel(offset); + + // Inline the invoked subroutine. + inlineSubroutine(clazz, + method, + codeAttribute, + offset, + branchTarget); + } + else + { + if (DEBUG) + { + System.out.println("Replacing subroutine invocation at ["+offset+"] by a simple branch"); + } + + // Replace the subroutine invocation by a simple branch. + Instruction replacementInstruction = + new BranchInstruction(InstructionConstants.OP_GOTO, + branchOffset).shrink(); + + codeAttributeComposer.appendInstruction(offset, replacementInstruction); + } + } + else + { + // Append the instruction. + codeAttributeComposer.appendInstruction(offset, branchInstruction); + } + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + int startPC = Math.max(exceptionInfo.u2startPC, clipStart); + int endPC = Math.min(exceptionInfo.u2endPC, clipEnd); + int handlerPC = exceptionInfo.u2handlerPC; + int catchType = exceptionInfo.u2catchType; + + // Exclude any subroutine invocations that jump out of the try block, + // by adding a try block before (and later on, after) each invocation. + for (int offset = startPC; offset < endPC; offset++) + { + if (branchTargetFinder.isSubroutineInvocation(offset)) + { + Instruction instruction = InstructionFactory.create(codeAttribute.code, offset); + int instructionLength = instruction.length(offset); + + // Is it a subroutine invocation? + if (!exceptionInfo.isApplicable(offset + ((BranchInstruction)instruction).branchOffset)) + { + if (DEBUG) + { + System.out.println(" Appending extra exception ["+startPC+" -> "+offset+"] -> "+handlerPC); + } + + // Append a try block that ends before the subroutine invocation. + codeAttributeComposer.appendException(new ExceptionInfo(startPC, + offset, + handlerPC, + catchType)); + + // The next try block will start after the subroutine invocation. + startPC = offset + instructionLength; + } + } + } + + if (DEBUG) + { + if (startPC == exceptionInfo.u2startPC && + endPC == exceptionInfo.u2endPC) + { + System.out.println(" Appending exception ["+startPC+" -> "+endPC+"] -> "+handlerPC); + } + else + { + System.out.println(" Appending clipped exception ["+exceptionInfo.u2startPC+" -> "+exceptionInfo.u2endPC+"] ~> ["+startPC+" -> "+endPC+"] -> "+handlerPC); + } + } + + // Append the exception. Note that exceptions with empty try blocks + // are automatically ignored. + codeAttributeComposer.appendException(new ExceptionInfo(startPC, + endPC, + handlerPC, + catchType)); + } +} diff --git a/src/proguard/preverify/Preverifier.java b/src/proguard/preverify/Preverifier.java new file mode 100644 index 0000000..e071c5c --- /dev/null +++ b/src/proguard/preverify/Preverifier.java @@ -0,0 +1,74 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.preverify; + +import proguard.Configuration; +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AllAttributeVisitor; +import proguard.classfile.visitor.*; + +/** + * This class can preverify methods in program class pools, according to a given + * configuration. + * + * @author Eric Lafortune + */ +public class Preverifier +{ + private final Configuration configuration; + + + /** + * Creates a new Preverifier. + */ + public Preverifier(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Performs preverification of the given program class pool. + */ + public void execute(ClassPool programClassPool) + { + // Clean up any old visitor info. + programClassPool.classesAccept(new ClassCleaner()); + + // Preverify all methods. + ClassVisitor preverifier = + new AllMethodVisitor( + new AllAttributeVisitor( + new CodePreverifier(configuration.microEdition))); + + // In Java Standard Edition, only class files from Java 6 or higher + // should be preverified. + if (!configuration.microEdition) + { + preverifier = + new ClassVersionFilter(ClassConstants.INTERNAL_CLASS_VERSION_1_6, + Integer.MAX_VALUE, + preverifier); + } + + programClassPool.classesAccept(preverifier); + } +} diff --git a/src/proguard/preverify/SubroutineInliner.java b/src/proguard/preverify/SubroutineInliner.java new file mode 100644 index 0000000..e28512f --- /dev/null +++ b/src/proguard/preverify/SubroutineInliner.java @@ -0,0 +1,74 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.preverify; + +import proguard.Configuration; +import proguard.classfile.*; +import proguard.classfile.attribute.visitor.AllAttributeVisitor; +import proguard.classfile.visitor.*; + +/** + * This class can inline subroutines in methods. This is generally useful (i.e. + * required) for preverifying code. + * + * @author Eric Lafortune + */ +public class SubroutineInliner +{ + private final Configuration configuration; + + + /** + * Creates a new SubroutineInliner. + */ + public SubroutineInliner(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Performs subroutine inlining of the given program class pool. + */ + public void execute(ClassPool programClassPool) + { + // Clean up any old visitor info. + programClassPool.classesAccept(new ClassCleaner()); + + // Inline all subroutines. + ClassVisitor inliner = + new AllMethodVisitor( + new AllAttributeVisitor( + new CodeSubroutineInliner())); + + // In Java Standard Edition, only class files from Java 6 or higher + // should be preverified. + if (!configuration.microEdition) + { + inliner = + new ClassVersionFilter(ClassConstants.INTERNAL_CLASS_VERSION_1_6, + Integer.MAX_VALUE, + inliner); + } + + programClassPool.classesAccept(inliner); + } +} diff --git a/src/proguard/retrace/MANIFEST.MF b/src/proguard/retrace/MANIFEST.MF new file mode 100644 index 0000000..42c9800 --- /dev/null +++ b/src/proguard/retrace/MANIFEST.MF @@ -0,0 +1,3 @@ +Manifest-Version: 1.0 +Main-Class: proguard.retrace.ReTrace +Class-Path: proguard.jar diff --git a/src/proguard/retrace/ReTrace.java b/src/proguard/retrace/ReTrace.java new file mode 100644 index 0000000..97ab27b --- /dev/null +++ b/src/proguard/retrace/ReTrace.java @@ -0,0 +1,749 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.retrace; + +import proguard.classfile.util.ClassUtil; +import proguard.obfuscate.*; + +import java.io.*; +import java.util.*; +import java.util.regex.*; + + +/** + * Tool for de-obfuscating stack traces of applications that were obfuscated + * with ProGuard. + * + * @author Eric Lafortune + */ +public class ReTrace +implements MappingProcessor +{ + private static final String REGEX_OPTION = "-regex"; + private static final String VERBOSE_OPTION = "-verbose"; + + + public static final String STACK_TRACE_EXPRESSION = "(?:\\s*%c:.*)|(?:\\s*at\\s+%c.%m\\s*\\(.*?(?::%l)?\\)\\s*)"; + + private static final String REGEX_CLASS = "\\b(?:[A-Za-z0-9_$]+\\.)*[A-Za-z0-9_$]+\\b"; + private static final String REGEX_CLASS_SLASH = "\\b(?:[A-Za-z0-9_$]+/)*[A-Za-z0-9_$]+\\b"; + private static final String REGEX_LINE_NUMBER = "\\b[0-9]+\\b"; + private static final String REGEX_TYPE = REGEX_CLASS + "(?:\\[\\])*"; + private static final String REGEX_MEMBER = "\\b[A-Za-z0-9_$]+\\b"; + private static final String REGEX_ARGUMENTS = "(?:" + REGEX_TYPE + "(?:\\s*,\\s*" + REGEX_TYPE + ")*)?"; + + // The class settings. + private final String regularExpression; + private final boolean verbose; + private final File mappingFile; + private final File stackTraceFile; + + private Map classMap = new HashMap(); + private Map classFieldMap = new HashMap(); + private Map classMethodMap = new HashMap(); + + + /** + * Creates a new ReTrace object to process stack traces on the standard + * input, based on the given mapping file name. + * @param regularExpression the regular expression for parsing the lines in + * the stack trace. + * @param verbose specifies whether the de-obfuscated stack trace + * should be verbose. + * @param mappingFile the mapping file that was written out by + * ProGuard. + */ + public ReTrace(String regularExpression, + boolean verbose, + File mappingFile) + { + this(regularExpression, verbose, mappingFile, null); + } + + + /** + * Creates a new ReTrace object to process a stack trace from the given file, + * based on the given mapping file name. + * @param regularExpression the regular expression for parsing the lines in + * the stack trace. + * @param verbose specifies whether the de-obfuscated stack trace + * should be verbose. + * @param mappingFile the mapping file that was written out by + * ProGuard. + * @param stackTraceFile the optional name of the file that contains the + * stack trace. + */ + public ReTrace(String regularExpression, + boolean verbose, + File mappingFile, + File stackTraceFile) + { + this.regularExpression = regularExpression; + this.verbose = verbose; + this.mappingFile = mappingFile; + this.stackTraceFile = stackTraceFile; + } + + + /** + * Performs the subsequent ReTrace operations. + */ + public void execute() throws IOException + { + // Read the mapping file. + MappingReader mappingReader = new MappingReader(mappingFile); + mappingReader.pump(this); + + + StringBuffer expressionBuffer = new StringBuffer(regularExpression.length() + 32); + char[] expressionTypes = new char[32]; + int expressionTypeCount = 0; + int index = 0; + while (true) + { + int nextIndex = regularExpression.indexOf('%', index); + if (nextIndex < 0 || + nextIndex == regularExpression.length()-1 || + expressionTypeCount == expressionTypes.length) + { + break; + } + + expressionBuffer.append(regularExpression.substring(index, nextIndex)); + expressionBuffer.append('('); + + char expressionType = regularExpression.charAt(nextIndex + 1); + switch(expressionType) + { + case 'c': + expressionBuffer.append(REGEX_CLASS); + break; + + case 'C': + expressionBuffer.append(REGEX_CLASS_SLASH); + break; + + case 'l': + expressionBuffer.append(REGEX_LINE_NUMBER); + break; + + case 't': + expressionBuffer.append(REGEX_TYPE); + break; + + case 'f': + expressionBuffer.append(REGEX_MEMBER); + break; + + case 'm': + expressionBuffer.append(REGEX_MEMBER); + break; + + case 'a': + expressionBuffer.append(REGEX_ARGUMENTS); + break; + } + + expressionBuffer.append(')'); + + expressionTypes[expressionTypeCount++] = expressionType; + + index = nextIndex + 2; + } + + expressionBuffer.append(regularExpression.substring(index)); + + Pattern pattern = Pattern.compile(expressionBuffer.toString()); + + // Read the stack trace file. + LineNumberReader reader = + new LineNumberReader(stackTraceFile == null ? + (Reader)new InputStreamReader(System.in) : + (Reader)new BufferedReader(new FileReader(stackTraceFile))); + + + try + { + StringBuffer outLine = new StringBuffer(256); + List extraOutLines = new ArrayList(); + + String className = null; + + // Read the line in the stack trace. + while (true) + { + String line = reader.readLine(); + if (line == null) + { + break; + } + + Matcher matcher = pattern.matcher(line); + + if (matcher.matches()) + { + int lineNumber = 0; + String type = null; + String arguments = null; + + // Figure out a class name, line number, type, and + // arguments beforehand. + for (int expressionTypeIndex = 0; expressionTypeIndex < expressionTypeCount; expressionTypeIndex++) + { + int startIndex = matcher.start(expressionTypeIndex + 1); + if (startIndex >= 0) + { + String match = matcher.group(expressionTypeIndex + 1); + + char expressionType = expressionTypes[expressionTypeIndex]; + switch (expressionType) + { + case 'c': + className = originalClassName(match); + break; + + case 'C': + className = originalClassName(ClassUtil.externalClassName(match)); + break; + + case 'l': + lineNumber = Integer.parseInt(match); + break; + + case 't': + type = originalType(match); + break; + + case 'a': + arguments = originalArguments(match); + break; + } + } + } + + // Actually construct the output line. + int lineIndex = 0; + + outLine.setLength(0); + extraOutLines.clear(); + + for (int expressionTypeIndex = 0; expressionTypeIndex < expressionTypeCount; expressionTypeIndex++) + { + int startIndex = matcher.start(expressionTypeIndex + 1); + if (startIndex >= 0) + { + int endIndex = matcher.end(expressionTypeIndex + 1); + String match = matcher.group(expressionTypeIndex + 1); + + // Copy a literal piece of input line. + outLine.append(line.substring(lineIndex, startIndex)); + + char expressionType = expressionTypes[expressionTypeIndex]; + switch (expressionType) + { + case 'c': + className = originalClassName(match); + outLine.append(className); + break; + + case 'C': + className = originalClassName(ClassUtil.externalClassName(match)); + outLine.append(ClassUtil.internalClassName(className)); + break; + + case 'l': + lineNumber = Integer.parseInt(match); + outLine.append(match); + break; + + case 't': + type = originalType(match); + outLine.append(type); + break; + + case 'f': + originalFieldName(className, + match, + type, + outLine, + extraOutLines); + break; + + case 'm': + originalMethodName(className, + match, + lineNumber, + type, + arguments, + outLine, + extraOutLines); + break; + + case 'a': + arguments = originalArguments(match); + outLine.append(arguments); + break; + } + + // Skip the original element whose processed version + // has just been appended. + lineIndex = endIndex; + } + } + + // Copy the last literal piece of input line. + outLine.append(line.substring(lineIndex)); + + // Print out the main line. + System.out.println(outLine); + + // Print out any additional lines. + for (int extraLineIndex = 0; extraLineIndex < extraOutLines.size(); extraLineIndex++) + { + System.out.println(extraOutLines.get(extraLineIndex)); + } + } + else + { + // Print out the original line. + System.out.println(line); + } + } + } + catch (IOException ex) + { + throw new IOException("Can't read stack trace (" + ex.getMessage() + ")"); + } + finally + { + if (stackTraceFile != null) + { + try + { + reader.close(); + } + catch (IOException ex) + { + // This shouldn't happen. + } + } + } + } + + + /** + * Finds the original field name(s), appending the first one to the out + * line, and any additional alternatives to the extra lines. + */ + private void originalFieldName(String className, + String obfuscatedFieldName, + String type, + StringBuffer outLine, + List extraOutLines) + { + int extraIndent = -1; + + // Class name -> obfuscated field names. + Map fieldMap = (Map)classFieldMap.get(className); + if (fieldMap != null) + { + // Obfuscated field names -> fields. + Set fieldSet = (Set)fieldMap.get(obfuscatedFieldName); + if (fieldSet != null) + { + // Find all matching fields. + Iterator fieldInfoIterator = fieldSet.iterator(); + while (fieldInfoIterator.hasNext()) + { + FieldInfo fieldInfo = (FieldInfo)fieldInfoIterator.next(); + if (fieldInfo.matches(type)) + { + // Is this the first matching field? + if (extraIndent < 0) + { + extraIndent = outLine.length(); + + // Append the first original name. + if (verbose) + { + outLine.append(fieldInfo.type).append(' '); + } + outLine.append(fieldInfo.originalName); + } + else + { + // Create an additional line with the proper + // indentation. + StringBuffer extraBuffer = new StringBuffer(); + for (int counter = 0; counter < extraIndent; counter++) + { + extraBuffer.append(' '); + } + + // Append the alternative name. + if (verbose) + { + extraBuffer.append(fieldInfo.type).append(' '); + } + extraBuffer.append(fieldInfo.originalName); + + // Store the additional line. + extraOutLines.add(extraBuffer); + } + } + } + } + } + + // Just append the obfuscated name if we haven't found any matching + // fields. + if (extraIndent < 0) + { + outLine.append(obfuscatedFieldName); + } + } + + + /** + * Finds the original method name(s), appending the first one to the out + * line, and any additional alternatives to the extra lines. + */ + private void originalMethodName(String className, + String obfuscatedMethodName, + int lineNumber, + String type, + String arguments, + StringBuffer outLine, + List extraOutLines) + { + int extraIndent = -1; + + // Class name -> obfuscated method names. + Map methodMap = (Map)classMethodMap.get(className); + if (methodMap != null) + { + // Obfuscated method names -> methods. + Set methodSet = (Set)methodMap.get(obfuscatedMethodName); + if (methodSet != null) + { + // Find all matching methods. + Iterator methodInfoIterator = methodSet.iterator(); + while (methodInfoIterator.hasNext()) + { + MethodInfo methodInfo = (MethodInfo)methodInfoIterator.next(); + if (methodInfo.matches(lineNumber, type, arguments)) + { + // Is this the first matching method? + if (extraIndent < 0) + { + extraIndent = outLine.length(); + + // Append the first original name. + if (verbose) + { + outLine.append(methodInfo.type).append(' '); + } + outLine.append(methodInfo.originalName); + if (verbose) + { + outLine.append('(').append(methodInfo.arguments).append(')'); + } + } + else + { + // Create an additional line with the proper + // indentation. + StringBuffer extraBuffer = new StringBuffer(); + for (int counter = 0; counter < extraIndent; counter++) + { + extraBuffer.append(' '); + } + + // Append the alternative name. + if (verbose) + { + extraBuffer.append(methodInfo.type).append(' '); + } + extraBuffer.append(methodInfo.originalName); + if (verbose) + { + extraBuffer.append('(').append(methodInfo.arguments).append(')'); + } + + // Store the additional line. + extraOutLines.add(extraBuffer); + } + } + } + } + } + + // Just append the obfuscated name if we haven't found any matching + // methods. + if (extraIndent < 0) + { + outLine.append(obfuscatedMethodName); + } + } + + + /** + * Returns the original argument types. + */ + private String originalArguments(String obfuscatedArguments) + { + StringBuffer originalArguments = new StringBuffer(); + + int startIndex = 0; + while (true) + { + int endIndex = obfuscatedArguments.indexOf(',', startIndex); + if (endIndex < 0) + { + break; + } + + originalArguments.append(originalType(obfuscatedArguments.substring(startIndex, endIndex).trim())).append(','); + + startIndex = endIndex + 1; + } + + originalArguments.append(originalType(obfuscatedArguments.substring(startIndex).trim())); + + return originalArguments.toString(); + } + + + /** + * Returns the original type. + */ + private String originalType(String obfuscatedType) + { + int index = obfuscatedType.indexOf('['); + + return index >= 0 ? + originalClassName(obfuscatedType.substring(0, index)) + obfuscatedType.substring(index) : + originalClassName(obfuscatedType); + } + + + /** + * Returns the original class name. + */ + private String originalClassName(String obfuscatedClassName) + { + String originalClassName = (String)classMap.get(obfuscatedClassName); + + return originalClassName != null ? + originalClassName : + obfuscatedClassName; + } + + + // Implementations for MappingProcessor. + + public boolean processClassMapping(String className, String newClassName) + { + // Obfuscated class name -> original class name. + classMap.put(newClassName, className); + + return true; + } + + + public void processFieldMapping(String className, String fieldType, String fieldName, String newFieldName) + { + // Original class name -> obfuscated field names. + Map fieldMap = (Map)classFieldMap.get(className); + if (fieldMap == null) + { + fieldMap = new HashMap(); + classFieldMap.put(className, fieldMap); + } + + // Obfuscated field name -> fields. + Set fieldSet = (Set)fieldMap.get(newFieldName); + if (fieldSet == null) + { + fieldSet = new LinkedHashSet(); + fieldMap.put(newFieldName, fieldSet); + } + + // Add the field information. + fieldSet.add(new FieldInfo(fieldType, + fieldName)); + } + + + public void processMethodMapping(String className, int firstLineNumber, int lastLineNumber, String methodReturnType, String methodName, String methodArguments, String newMethodName) + { + // Original class name -> obfuscated method names. + Map methodMap = (Map)classMethodMap.get(className); + if (methodMap == null) + { + methodMap = new HashMap(); + classMethodMap.put(className, methodMap); + } + + // Obfuscated method name -> methods. + Set methodSet = (Set)methodMap.get(newMethodName); + if (methodSet == null) + { + methodSet = new LinkedHashSet(); + methodMap.put(newMethodName, methodSet); + } + + // Add the method information. + methodSet.add(new MethodInfo(firstLineNumber, + lastLineNumber, + methodReturnType, + methodArguments, + methodName)); + } + + + /** + * A field record. + */ + private static class FieldInfo + { + private String type; + private String originalName; + + + private FieldInfo(String type, String originalName) + { + this.type = type; + this.originalName = originalName; + } + + + private boolean matches(String type) + { + return + type == null || type.equals(this.type); + } + } + + + /** + * A method record. + */ + private static class MethodInfo + { + private int firstLineNumber; + private int lastLineNumber; + private String type; + private String arguments; + private String originalName; + + + private MethodInfo(int firstLineNumber, int lastLineNumber, String type, String arguments, String originalName) + { + this.firstLineNumber = firstLineNumber; + this.lastLineNumber = lastLineNumber; + this.type = type; + this.arguments = arguments; + this.originalName = originalName; + } + + + private boolean matches(int lineNumber, String type, String arguments) + { + return + (lineNumber == 0 || (firstLineNumber <= lineNumber && lineNumber <= lastLineNumber) || lastLineNumber == 0) && + (type == null || type.equals(this.type)) && + (arguments == null || arguments.equals(this.arguments)); + } + } + + + /** + * The main program for ReTrace. + */ + public static void main(String[] args) + { + if (args.length < 1) + { + System.err.println("Usage: java proguard.ReTrace [-verbose] []"); + System.exit(-1); + } + + String regularExpresssion = STACK_TRACE_EXPRESSION; + boolean verbose = false; + + int argumentIndex = 0; + while (argumentIndex < args.length) + { + String arg = args[argumentIndex]; + if (arg.equals(REGEX_OPTION)) + { + regularExpresssion = args[++argumentIndex]; + } + else if (arg.equals(VERBOSE_OPTION)) + { + verbose = true; + } + else + { + break; + } + + argumentIndex++; + } + + if (argumentIndex >= args.length) + { + System.err.println("Usage: java proguard.ReTrace [-regex ] [-verbose] []"); + System.exit(-1); + } + + File mappingFile = new File(args[argumentIndex++]); + File stackTraceFile = argumentIndex < args.length ? + new File(args[argumentIndex]) : + null; + + ReTrace reTrace = new ReTrace(regularExpresssion, verbose, mappingFile, stackTraceFile); + + try + { + // Execute ReTrace with its given settings. + reTrace.execute(); + } + catch (IOException ex) + { + if (verbose) + { + // Print a verbose stack trace. + ex.printStackTrace(); + } + else + { + // Print just the stack trace message. + System.err.println("Error: "+ex.getMessage()); + } + + System.exit(1); + } + + System.exit(0); + } +} diff --git a/src/proguard/retrace/package.html b/src/proguard/retrace/package.html new file mode 100644 index 0000000..a35ce21 --- /dev/null +++ b/src/proguard/retrace/package.html @@ -0,0 +1,4 @@ + +This package contains the main ReTrace application. +ReTrace can de-obfuscate stack traces of obfuscated programs. + diff --git a/src/proguard/shrink/AnnotationUsageMarker.java b/src/proguard/shrink/AnnotationUsageMarker.java new file mode 100644 index 0000000..9aaae34 --- /dev/null +++ b/src/proguard/shrink/AnnotationUsageMarker.java @@ -0,0 +1,359 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.attribute.Attribute; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + +/** + * This AttributeVisitor recursively marks all necessary annotation information + * in the attributes that it visits. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class AnnotationUsageMarker +extends SimplifiedVisitor +implements AttributeVisitor, + AnnotationVisitor, + ElementValueVisitor, + ConstantVisitor, + ClassVisitor, + MemberVisitor +{ + private final UsageMarker usageMarker; + + // Fields acting as a return parameters for several methods. + private boolean attributeUsed; + private boolean annotationUsed; + private boolean elementValueUsed; + private boolean classUsed; + private boolean methodUsed; + + + /** + * Creates a new AnnotationUsageMarker. + * @param usageMarker the usage marker that is used to mark the classes + * and class members. + */ + public AnnotationUsageMarker(UsageMarker usageMarker) + { + this.usageMarker = usageMarker; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Mark the necessary annotation information. + attributeUsed = false; + annotationsAttribute.annotationsAccept(clazz, this); + + if (attributeUsed) + { + // We got a positive used flag, so some annotation is being used. + // Mark this attribute as being used as well. + usageMarker.markAsUsed(annotationsAttribute); + + markConstant(clazz, annotationsAttribute.u2attributeNameIndex); + } + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Mark the necessary annotation information. + attributeUsed = false; + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + + if (attributeUsed) + { + // We got a positive used flag, so some annotation is being used. + // Mark this attribute as being used as well. + usageMarker.markAsUsed(parameterAnnotationsAttribute); + + markConstant(clazz, parameterAnnotationsAttribute.u2attributeNameIndex); + } + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Mark the necessary annotation information in any annotation elements. + annotationDefaultAttribute.defaultValueAccept(clazz, this); + + // Always mark annotation defaults. + usageMarker.markAsUsed(annotationDefaultAttribute); + + markConstant(clazz, annotationDefaultAttribute.u2attributeNameIndex); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + if (isReferencedClassUsed(annotation)) + { + // Mark the annotation as being used. + usageMarker.markAsUsed(annotation); + + markConstant(clazz, annotation.u2typeIndex); + + // Mark the necessary element values. + annotation.elementValuesAccept(clazz, this); + + // The return values. + annotationUsed = true; + attributeUsed = true; + } + } + + + // Implementations for ElementValueVisitor. + + public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) + { + if (isReferencedMethodUsed(constantElementValue)) + { + // Mark the element value as being used. + usageMarker.markAsUsed(constantElementValue); + + markConstant(clazz, constantElementValue.u2elementNameIndex); + markConstant(clazz, constantElementValue.u2constantValueIndex); + + // The return value. + elementValueUsed = true; + } + } + + + public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) + { + if (isReferencedMethodUsed(enumConstantElementValue)) + { + // Check the referenced classes. + classUsed = true; + enumConstantElementValue.referencedClassesAccept(usageMarker); + + if (classUsed) + { + // Mark the element value as being used. + usageMarker.markAsUsed(enumConstantElementValue); + + markConstant(clazz, enumConstantElementValue.u2elementNameIndex); + markConstant(clazz, enumConstantElementValue.u2typeNameIndex); + markConstant(clazz, enumConstantElementValue.u2constantNameIndex); + + // The return value. + elementValueUsed = true; + } + } + } + + + public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) + { + if (isReferencedMethodUsed(classElementValue)) + { + // Check the referenced classes. + classUsed = true; + classElementValue.referencedClassesAccept(usageMarker); + + if (classUsed) + { + // Mark the element value as being used. + usageMarker.markAsUsed(classElementValue); + + markConstant(clazz, classElementValue.u2elementNameIndex); + markConstant(clazz, classElementValue.u2classInfoIndex); + + // The return value. + elementValueUsed = true; + } + } + } + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + if (isReferencedMethodUsed(annotationElementValue)) + { + boolean oldAnnotationUsed = annotationUsed; + + // Check and mark the contained annotation. + annotationUsed = false; + annotationElementValue.annotationAccept(clazz, this); + + if (annotationUsed) + { + // Mark the element value as being used. + usageMarker.markAsUsed(annotationElementValue); + + markConstant(clazz, annotationElementValue.u2elementNameIndex); + + // The return value. + elementValueUsed = true; + } + + annotationUsed = oldAnnotationUsed; + } + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + if (isReferencedMethodUsed(arrayElementValue)) + { + boolean oldelementValueUsed = elementValueUsed; + + // Check and mark the contained element values. + elementValueUsed = false; + arrayElementValue.elementValuesAccept(clazz, annotation, this); + + if (elementValueUsed) + { + // Mark the element value as being used. + usageMarker.markAsUsed(arrayElementValue); + + markConstant(clazz, arrayElementValue.u2elementNameIndex); + + // The return value. + //elementValueUsed = true; + } + else + { + elementValueUsed = oldelementValueUsed; + } + } + } + + + // Implementations for ConstantVisitor. + + public void visitAnyConstant(Clazz clazz, Constant constant) + { + usageMarker.markAsUsed(constant); + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classUsed = usageMarker.isUsed(classConstant); + + // Is the class constant marked as being used? + if (!classUsed) + { + // Check the referenced class. + classUsed = true; + classConstant.referencedClassAccept(this); + + // Is the referenced class marked as being used? + if (classUsed) + { + // Mark the class constant and its Utf8 constant. + usageMarker.markAsUsed(classConstant); + + markConstant(clazz, classConstant.u2nameIndex); + } + } + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + classUsed = usageMarker.isUsed(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + classUsed = true; + } + + + // Implementations for MemberVisitor. + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + methodUsed = usageMarker.isUsed(programMethod); + } + + + public void visitLibraryMethod(LibraryClass LibraryClass, LibraryMethod libraryMethod) + { + classUsed = true; + } + + + // Small utility methods. + + /** + * Returns whether the annotation class has been marked as being used. + */ + private boolean isReferencedClassUsed(Annotation annotation) + { + // Check if the referenced class is being used. + classUsed = true; + annotation.referencedClassAccept(this); + + return classUsed; + } + + + /** + * Returns whether the annotation method has been marked as being used. + */ + private boolean isReferencedMethodUsed(ElementValue elementValue) + { + // Check if the referenced method is being used. + methodUsed = true; + elementValue.referencedMethodAccept(this); + + return methodUsed; + } + + + /** + * Marks the specified constant pool entry. + */ + private void markConstant(Clazz clazz, int index) + { + if (index > 0) + { + clazz.constantPoolEntryAccept(index, this); + } + } +} diff --git a/src/proguard/shrink/ClassShrinker.java b/src/proguard/shrink/ClassShrinker.java new file mode 100644 index 0000000..0b5c5b7 --- /dev/null +++ b/src/proguard/shrink/ClassShrinker.java @@ -0,0 +1,448 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.annotation.visitor.*; +import proguard.classfile.attribute.visitor.AttributeVisitor; +import proguard.classfile.constant.*; +import proguard.classfile.editor.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +/** + * This ClassVisitor removes constant pool entries and class members that + * are not marked as being used. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class ClassShrinker +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + AttributeVisitor, + AnnotationVisitor, + ElementValueVisitor +{ + private final UsageMarker usageMarker; + + private int[] constantIndexMap = new int[ClassConstants.TYPICAL_CONSTANT_POOL_SIZE]; + + private final ConstantPoolRemapper constantPoolRemapper = new ConstantPoolRemapper(); + + + /** + * Creates a new ClassShrinker. + * @param usageMarker the usage marker that is used to mark the classes + * and class members. + */ + public ClassShrinker(UsageMarker usageMarker) + { + this.usageMarker = usageMarker; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Shrink the arrays for constant pool, interfaces, fields, methods, + // and class attributes. + programClass.u2interfacesCount = + shrinkConstantIndexArray(programClass.constantPool, + programClass.u2interfaces, + programClass.u2interfacesCount); + + // Shrinking the constant pool also sets up an index map. + programClass.u2constantPoolCount = + shrinkConstantPool(programClass.constantPool, + programClass.u2constantPoolCount); + + programClass.u2fieldsCount = + shrinkArray(programClass.fields, + programClass.u2fieldsCount); + + programClass.u2methodsCount = + shrinkArray(programClass.methods, + programClass.u2methodsCount); + + programClass.u2attributesCount = + shrinkArray(programClass.attributes, + programClass.u2attributesCount); + + // Compact the remaining fields, methods, and attributes, + // and remap their references to the constant pool. + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + programClass.attributesAccept(this); + + // Remap all constant pool references. + constantPoolRemapper.setConstantIndexMap(constantIndexMap); + constantPoolRemapper.visitProgramClass(programClass); + + // Remove the unused interfaces from the class signature. + programClass.attributesAccept(new SignatureShrinker()); + + // Compact the extra field pointing to the subclasses of this class. + programClass.subClasses = + shrinkToNewArray(programClass.subClasses); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Library classes are left unchanged. + + // Compact the extra field pointing to the subclasses of this class. + libraryClass.subClasses = + shrinkToNewArray(libraryClass.subClasses); + } + + + // Implementations for MemberVisitor. + + public void visitProgramMember(ProgramClass programClass, ProgramMember programMember) + { + // Shrink the attributes array. + programMember.u2attributesCount = + shrinkArray(programMember.attributes, + programMember.u2attributesCount); + + // Shrink any attributes. + programMember.attributesAccept(programClass, this); + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Shrink the array of InnerClassesInfo objects. + innerClassesAttribute.u2classesCount = + shrinkArray(innerClassesAttribute.classes, + innerClassesAttribute.u2classesCount); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + // Sometimes, a class is still referenced (apparently as a dummy class), + // but its enclosing method is not. Then remove the reference to + // the enclosing method. + // E.g. the anonymous inner class javax.swing.JList$1 is defined inside + // a constructor of javax.swing.JList, but it is also referenced as a + // dummy argument in a constructor of javax.swing.JList$ListSelectionHandler. + if (enclosingMethodAttribute.referencedMethod != null && + !usageMarker.isUsed(enclosingMethodAttribute.referencedMethod)) + { + enclosingMethodAttribute.u2nameAndTypeIndex = 0; + + enclosingMethodAttribute.referencedMethod = null; + } + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + // Shrink the attributes array. + codeAttribute.u2attributesCount = + shrinkArray(codeAttribute.attributes, + codeAttribute.u2attributesCount); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Shrink the annotations array. + annotationsAttribute.u2annotationsCount = + shrinkArray(annotationsAttribute.annotations, + annotationsAttribute.u2annotationsCount); + + // Shrink the annotations themselves. + annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Loop over all parameters. + for (int parameterIndex = 0; parameterIndex < parameterAnnotationsAttribute.u2parametersCount; parameterIndex++) + { + // Shrink the parameter annotations array. + parameterAnnotationsAttribute.u2parameterAnnotationsCount[parameterIndex] = + shrinkArray(parameterAnnotationsAttribute.parameterAnnotations[parameterIndex], + parameterAnnotationsAttribute.u2parameterAnnotationsCount[parameterIndex]); + } + + // Shrink the annotations themselves. + parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + // Implementations for AnnotationVisitor. + + public void visitAnnotation(Clazz clazz, Annotation annotation) + { + // Shrink the element values array. + annotation.u2elementValuesCount = + shrinkArray(annotation.elementValues, + annotation.u2elementValuesCount); + + // Shrink the element values themselves. + annotation.elementValuesAccept(clazz, this); + } + + + /** + * This AttributeVisitor updates the Utf8 constants of class signatures, + * removing any unused interfaces. + */ + private class SignatureShrinker + extends SimplifiedVisitor + implements AttributeVisitor + { + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + Clazz[] referencedClasses = signatureAttribute.referencedClasses; + if (referencedClasses != null) + { + // Go over the generic definitions, superclass and implemented interfaces. + String signature = clazz.getString(signatureAttribute.u2signatureIndex); + + InternalTypeEnumeration internalTypeEnumeration = + new InternalTypeEnumeration(signature); + + StringBuffer newSignatureBuffer = new StringBuffer(); + + int referencedClassIndex = 0; + int newReferencedClassIndex = 0; + + while (internalTypeEnumeration.hasMoreTypes()) + { + // Consider the classes referenced by this signature. + String type = internalTypeEnumeration.nextType(); + int classCount = new DescriptorClassEnumeration(type).classCount(); + + Clazz referencedClass = referencedClasses[referencedClassIndex]; + if (referencedClass == null || + usageMarker.isUsed(referencedClass)) + { + // Append the superclass or interface. + newSignatureBuffer.append(type); + + // Copy the referenced classes. + for (int counter = 0; counter < classCount; counter++) + { + referencedClasses[newReferencedClassIndex++] = + referencedClasses[referencedClassIndex++]; + } + } + else + { + // Skip the referenced classes. + referencedClassIndex += classCount; + } + } + + if (newReferencedClassIndex < referencedClassIndex) + { + // Update the signature. + ((Utf8Constant)((ProgramClass)clazz).constantPool[signatureAttribute.u2signatureIndex]).setString(newSignatureBuffer.toString()); + + // Clear the unused entries. + while (newReferencedClassIndex < referencedClassIndex) + { + referencedClasses[newReferencedClassIndex++] = null; + } + } + } + } + } + + + // Implementations for ElementValueVisitor. + + public void visitAnyElementValue(Clazz clazz, Annotation annotation, ElementValue elementValue) {} + + + public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) + { + // Shrink the contained annotation. + annotationElementValue.annotationAccept(clazz, this); + } + + + public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) + { + // Shrink the element values array. + arrayElementValue.u2elementValuesCount = + shrinkArray(arrayElementValue.elementValues, + arrayElementValue.u2elementValuesCount); + + // Shrink the element values themselves. + arrayElementValue.elementValuesAccept(clazz, annotation, this); + } + + + // Small utility methods. + + /** + * Removes all entries that are not marked as being used from the given + * constant pool. + * @return the new number of entries. + */ + private int shrinkConstantPool(Constant[] constantPool, int length) + { + if (constantIndexMap.length < length) + { + constantIndexMap = new int[length]; + } + + int counter = 1; + boolean isUsed = false; + + // Shift the used constant pool entries together. + for (int index = 1; index < length; index++) + { + constantIndexMap[index] = counter; + + Constant constant = constantPool[index]; + + // Don't update the flag if this is the second half of a long entry. + if (constant != null) + { + isUsed = usageMarker.isUsed(constant); + } + + if (isUsed) + { + constantPool[counter++] = constant; + } + } + + // Clear the remaining constant pool elements. + for (int index = counter; index < length; index++) + { + constantPool[index] = null; + } + + return counter; + } + + + /** + * Removes all indices that point to unused constant pool entries + * from the given array. + * @return the new number of indices. + */ + private int shrinkConstantIndexArray(Constant[] constantPool, int[] array, int length) + { + int counter = 0; + + // Shift the used objects together. + for (int index = 0; index < length; index++) + { + if (usageMarker.isUsed(constantPool[array[index]])) + { + array[counter++] = array[index]; + } + } + + // Clear the remaining array elements. + for (int index = counter; index < length; index++) + { + array[index] = 0; + } + + return counter; + } + + + /** + * Removes all Clazz objects that are not marked as being used + * from the given array and returns the remaining objects in a an array + * of the right size. + * @return the new array. + */ + private Clazz[] shrinkToNewArray(Clazz[] array) + { + if (array == null) + { + return null; + } + + // Shrink the given array in-place. + int length = shrinkArray(array, array.length); + if (length == 0) + { + return null; + } + + // Return immediately if the array is of right size already. + if (length == array.length) + { + return array; + } + + // Copy the remaining elements into a new array of the right size. + Clazz[] newArray = new Clazz[length]; + System.arraycopy(array, 0, newArray, 0, length); + return newArray; + } + + + /** + * Removes all VisitorAccepter objects that are not marked as being used + * from the given array. + * @return the new number of VisitorAccepter objects. + */ + private int shrinkArray(VisitorAccepter[] array, int length) + { + int counter = 0; + + // Shift the used objects together. + for (int index = 0; index < length; index++) + { + if (usageMarker.isUsed(array[index])) + { + array[counter++] = array[index]; + } + } + + // Clear the remaining array elements. + for (int index = counter; index < length; index++) + { + array[index] = null; + } + + return counter; + } +} diff --git a/src/proguard/shrink/InnerUsageMarker.java b/src/proguard/shrink/InnerUsageMarker.java new file mode 100644 index 0000000..b8ca801 --- /dev/null +++ b/src/proguard/shrink/InnerUsageMarker.java @@ -0,0 +1,174 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This AttributeVisitor recursively marks all necessary inner class information + * in the attributes that it visits. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class InnerUsageMarker +extends SimplifiedVisitor +implements AttributeVisitor, + InnerClassesInfoVisitor, + ConstantVisitor, + ClassVisitor +{ + private final UsageMarker usageMarker; + + // Fields acting as a return parameters for several methods. + private boolean attributeUsed; + private boolean classUsed; + + + /** + * Creates a new InnerUsageMarker. + * @param usageMarker the usage marker that is used to mark the classes + * and class members. + */ + public InnerUsageMarker(UsageMarker usageMarker) + { + this.usageMarker = usageMarker; + } + + + // Implementations for AttributeVisitor. + + public void visitAnyAttribute(Clazz clazz, Attribute attribute) {} + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Mark the necessary inner classes information. + attributeUsed = false; + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + + if (attributeUsed) + { + // We got a positive used flag, so some inner class is being used. + // Mark this attribute as being used as well. + usageMarker.markAsUsed(innerClassesAttribute); + + markConstant(clazz, innerClassesAttribute.u2attributeNameIndex); + } + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + boolean innerClassesInfoUsed = usageMarker.isUsed(innerClassesInfo); + + if (!innerClassesInfoUsed) + { + // Check if the inner class (if any) is marked as being used. + classUsed = true; + innerClassesInfo.innerClassConstantAccept(clazz, this); + innerClassesInfoUsed = classUsed; + + // Check if the outer class (if any) is marked as being used. + classUsed = true; + innerClassesInfo.outerClassConstantAccept(clazz, this); + innerClassesInfoUsed &= classUsed; + + // If both the inner class and the outer class are marked as being + // used, then mark this InnerClassesInfo as well. + if (innerClassesInfoUsed) + { + usageMarker.markAsUsed(innerClassesInfo); + + innerClassesInfo.innerNameConstantAccept(clazz, this); + } + } + + // The return value. + attributeUsed |= innerClassesInfoUsed; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + classUsed = usageMarker.isUsed(classConstant); + + // Is the class constant marked as being used? + if (!classUsed) + { + // Check the referenced class. + classUsed = true; + classConstant.referencedClassAccept(this); + + // Is the referenced class marked as being used? + if (classUsed) + { + // Mark the class constant and its Utf8 constant. + usageMarker.markAsUsed(classConstant); + + markConstant(clazz, classConstant.u2nameIndex); + } + } + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + usageMarker.markAsUsed(utf8Constant); + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + classUsed = usageMarker.isUsed(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + classUsed = true; + } + + + // Small utility methods. + + /** + * Marks the given constant pool entry of the given class. This includes + * visiting any other referenced constant pool entries. + */ + private void markConstant(Clazz clazz, int index) + { + clazz.constantPoolEntryAccept(index, this); + } +} diff --git a/src/proguard/shrink/InterfaceUsageMarker.java b/src/proguard/shrink/InterfaceUsageMarker.java new file mode 100644 index 0000000..7599898 --- /dev/null +++ b/src/proguard/shrink/InterfaceUsageMarker.java @@ -0,0 +1,152 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.ClassVisitor; + + +/** + * This ClassVisitor recursively marks all interface + * classes that are being used in the visited class. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class InterfaceUsageMarker +extends SimplifiedVisitor +implements ClassVisitor, + ConstantVisitor +{ + private final UsageMarker usageMarker; + + // Fields acting as a return parameters for several methods. + private boolean used; + private boolean anyUsed; + + + /** + * Creates a new InterfaceUsageMarker. + * @param usageMarker the usage marker that is used to mark the classes + * and class members. + */ + public InterfaceUsageMarker(UsageMarker usageMarker) + { + this.usageMarker = usageMarker; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + boolean classUsed = usageMarker.isUsed(programClass); + boolean classPossiblyUsed = usageMarker.isPossiblyUsed(programClass); + + if (classUsed || classPossiblyUsed) + { + // Check if any interfaces are being used. + boolean oldAnyUsed = anyUsed; + anyUsed = false; + + programClass.interfaceConstantsAccept(this); + + classUsed |= anyUsed; + anyUsed = oldAnyUsed; + + // Is this an interface with a preliminary mark? + if (classPossiblyUsed) + { + // Should it be included now? + if (classUsed) + { + // At least one if this interface's interfaces is being used. + // Mark this interface as well. + usageMarker.markAsUsed(programClass); + + // Mark this interface's name. + programClass.thisClassConstantAccept(this); + + // Mark the superclass (java/lang/Object). + programClass.superClassConstantAccept(this); + } + else + { + // Unmark this interface, so we don't bother looking at it again. + usageMarker.markAsUnused(programClass); + } + } + } + + // The return value. + used = classUsed; + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // The return values. + used = true; + anyUsed = true; + } + + + // Implementations for ConstantVisitor. + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + boolean classUsed = usageMarker.isUsed(classConstant); + + if (!classUsed) + { + // The ClassConstant isn't marked as being used yet. But maybe it + // should be included as an interface, so check the actual class. + classConstant.referencedClassAccept(this); + classUsed = used; + + if (classUsed) + { + // The class is being used. Mark the ClassConstant as being used + // as well. + usageMarker.markAsUsed(classConstant); + + clazz.constantPoolEntryAccept(classConstant.u2nameIndex, this); + } + } + + // The return values. + used = classUsed; + anyUsed |= classUsed; + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + if (!usageMarker.isUsed(utf8Constant)) + { + usageMarker.markAsUsed(utf8Constant); + } + } +} diff --git a/src/proguard/shrink/ShortestUsageMark.java b/src/proguard/shrink/ShortestUsageMark.java new file mode 100644 index 0000000..757c713 --- /dev/null +++ b/src/proguard/shrink/ShortestUsageMark.java @@ -0,0 +1,183 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.visitor.*; + + +/** + * This class can be used as a mark when keeping classes, class members, and + * other elements. It can be certain or preliminary. It also contains additional + * information about the reasons why an element is being kept. + * + * @see ClassShrinker + * + * @author Eric Lafortune + */ +final class ShortestUsageMark +{ + private final boolean certain; + private final String reason; + private final int depth; + private Clazz clazz; + private Member member; + + + /** + * Creates a new certain ShortestUsageMark. + * @param reason the reason for this mark. + */ + public ShortestUsageMark(String reason) + { + this.certain = true; + this.reason = reason; + this.depth = 0; + } + + + /** + * Creates a new certain ShortestUsageMark. + * @param previousUsageMark the previous mark to which this one is linked. + * @param reason the reason for this mark. + * @param clazz the class causing this mark. + */ + public ShortestUsageMark(ShortestUsageMark previousUsageMark, + String reason, + int cost, + Clazz clazz) + { + this(previousUsageMark, reason, cost, clazz, null); + } + + + /** + * Creates a new certain ShortestUsageMark. + * @param previousUsageMark the previous mark to which this one is linked. + * @param reason the reason for this mark. + * @param clazz the class causing this mark. + * @param member the member in the above class causing this mark. + * @param cost the added cost of following this path. + */ + public ShortestUsageMark(ShortestUsageMark previousUsageMark, + String reason, + int cost, + Clazz clazz, + Member member) + { + this.certain = true; + this.reason = reason; + this.depth = previousUsageMark.depth + cost; + this.clazz = clazz; + this.member = member; + } + + + /** + * Creates a new ShortestUsageMark, based on another mark. + * @param otherUsageMark the other mark, whose properties will be copied. + * @param certain specifies whether this is a certain mark. + */ + public ShortestUsageMark(ShortestUsageMark otherUsageMark, + boolean certain) + { + this.certain = certain; + this.reason = otherUsageMark.reason; + this.depth = otherUsageMark.depth; + this.clazz = otherUsageMark.clazz; + this.member = otherUsageMark.member; + } + + + /** + * Returns whether this is a certain mark. + */ + public boolean isCertain() + { + return certain; + } + + + /** + * Returns the reason for this mark. + */ + public String getReason() + { + return reason; + } + + + /** + * Returns whether this mark has a shorter chain of reasons than the + * given mark. + */ + public boolean isShorter(ShortestUsageMark otherUsageMark) + { + return this.depth < otherUsageMark.depth; + } + + + /** + * Returns whether this is mark is caused by the given class. + */ + public boolean isCausedBy(Clazz clazz) + { + return clazz.equals(this.clazz); + } + + + /** + * Applies the given class visitor to this mark's class, if any, + * and if this mark doesn't have a member. + */ + public void acceptClassVisitor(ClassVisitor classVisitor) + { + if (clazz != null && + member == null) + { + clazz.accept(classVisitor); + } + } + + + /** + * Applies the given class visitor to this mark's member, if any. + */ + public void acceptMemberVisitor(MemberVisitor memberVisitor) + { + if (clazz != null && + member != null) + { + member.accept(clazz, memberVisitor); + } + } + + + // Implementations for Object. + + public String toString() + { + return "certain=" + certain + ", depth="+depth+": " + + reason + + (clazz != null ? clazz.getName() : "(none)") + ": " + + (member != null ? member.getName(clazz) : "(none)"); + } +} diff --git a/src/proguard/shrink/ShortestUsageMarker.java b/src/proguard/shrink/ShortestUsageMarker.java new file mode 100644 index 0000000..da8fad3 --- /dev/null +++ b/src/proguard/shrink/ShortestUsageMarker.java @@ -0,0 +1,277 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.visitor.*; + + +/** + * This ClassVisitor and MemberVisitor recursively marks all classes + * and class elements that are being used. For each element, it finds the + * shortest chain of dependencies. + * + * @see ClassShrinker + * + * @author Eric Lafortune + */ +public class ShortestUsageMarker extends UsageMarker +{ + private static final ShortestUsageMark INITIAL_MARK = + new ShortestUsageMark("is kept by a directive in the configuration.\n\n"); + + + // A field acting as a parameter to the visitor methods. + private ShortestUsageMark currentUsageMark = INITIAL_MARK; + + // A utility object to check for recursive causes. + private final MyRecursiveCauseChecker recursiveCauseChecker = new MyRecursiveCauseChecker(); + + + // Overriding implementations for UsageMarker. + + protected void markProgramClassBody(ProgramClass programClass) + { + ShortestUsageMark previousUsageMark = currentUsageMark; + + currentUsageMark = new ShortestUsageMark(getShortestUsageMark(programClass), + "is extended by ", + 10000, + programClass); + + super.markProgramClassBody(programClass); + + currentUsageMark = previousUsageMark; + } + + + protected void markProgramFieldBody(ProgramClass programClass, ProgramField programField) + { + ShortestUsageMark previousUsageMark = currentUsageMark; + + currentUsageMark = new ShortestUsageMark(getShortestUsageMark(programField), + "is referenced by ", + 1, + programClass, + programField); + + super.markProgramFieldBody(programClass, programField); + + currentUsageMark = previousUsageMark; + } + + + protected void markProgramMethodBody(ProgramClass programClass, ProgramMethod programMethod) + { + ShortestUsageMark previousUsageMark = currentUsageMark; + + currentUsageMark = new ShortestUsageMark(getShortestUsageMark(programMethod), + "is invoked by ", + 1, + programClass, + programMethod); + + super.markProgramMethodBody(programClass, programMethod); + + currentUsageMark = previousUsageMark; + } + + + protected void markMethodHierarchy(Clazz clazz, Method method) + { + ShortestUsageMark previousUsageMark = currentUsageMark; + + currentUsageMark = new ShortestUsageMark(getShortestUsageMark(method), + "implements ", + 100, + clazz, + method); + + super.markMethodHierarchy(clazz, method); + + currentUsageMark = previousUsageMark; + } + + + // Small utility methods. + + protected void markAsUsed(VisitorAccepter visitorAccepter) + { + Object visitorInfo = visitorAccepter.getVisitorInfo(); + + ShortestUsageMark shortestUsageMark = + visitorInfo != null && + visitorInfo instanceof ShortestUsageMark && + !((ShortestUsageMark)visitorInfo).isCertain() && + !currentUsageMark.isShorter((ShortestUsageMark)visitorInfo) ? + new ShortestUsageMark((ShortestUsageMark)visitorInfo, true): + currentUsageMark; + + visitorAccepter.setVisitorInfo(shortestUsageMark); + } + + + protected boolean shouldBeMarkedAsUsed(VisitorAccepter visitorAccepter) + { + Object visitorInfo = visitorAccepter.getVisitorInfo(); + + return //!(visitorAccepter instanceof Clazz && + // isCausedBy(currentUsageMark, (Clazz)visitorAccepter)) && + (visitorInfo == null || + !(visitorInfo instanceof ShortestUsageMark) || + !((ShortestUsageMark)visitorInfo).isCertain() || + currentUsageMark.isShorter((ShortestUsageMark)visitorInfo)); + } + + + protected boolean isUsed(VisitorAccepter visitorAccepter) + { + Object visitorInfo = visitorAccepter.getVisitorInfo(); + + return visitorInfo != null && + visitorInfo instanceof ShortestUsageMark && + ((ShortestUsageMark)visitorInfo).isCertain(); + } + + + protected void markAsPossiblyUsed(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(new ShortestUsageMark(currentUsageMark, false)); + } + + + protected boolean shouldBeMarkedAsPossiblyUsed(VisitorAccepter visitorAccepter) + { + Object visitorInfo = visitorAccepter.getVisitorInfo(); + + return visitorInfo == null || + !(visitorInfo instanceof ShortestUsageMark) || + (!((ShortestUsageMark)visitorInfo).isCertain() && + currentUsageMark.isShorter((ShortestUsageMark)visitorInfo)); + } + + + protected boolean isPossiblyUsed(VisitorAccepter visitorAccepter) + { + Object visitorInfo = visitorAccepter.getVisitorInfo(); + + return visitorInfo != null && + visitorInfo instanceof ShortestUsageMark && + !((ShortestUsageMark)visitorInfo).isCertain(); + } + + + protected ShortestUsageMark getShortestUsageMark(VisitorAccepter visitorAccepter) + { + Object visitorInfo = visitorAccepter.getVisitorInfo(); + + return (ShortestUsageMark)visitorInfo; + } + + + // Small utility methods. + + private boolean isCausedBy(ShortestUsageMark shortestUsageMark, + Clazz clazz) + { + return recursiveCauseChecker.check(shortestUsageMark, clazz); + } + + + private class MyRecursiveCauseChecker implements ClassVisitor, MemberVisitor + { + private Clazz checkClass; + private boolean isRecursing; + + + public boolean check(ShortestUsageMark shortestUsageMark, + Clazz clazz) + { + checkClass = clazz; + isRecursing = false; + + shortestUsageMark.acceptClassVisitor(this); + shortestUsageMark.acceptMemberVisitor(this); + + return isRecursing; + } + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + checkCause(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + checkCause(libraryClass); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + checkCause(programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + checkCause(programMethod); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + checkCause(libraryField); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + checkCause(libraryMethod); + } + + + // Small utility methods. + + private void checkCause(VisitorAccepter visitorAccepter) + { + if (ShortestUsageMarker.this.isUsed(visitorAccepter)) + { + ShortestUsageMark shortestUsageMark = ShortestUsageMarker.this.getShortestUsageMark(visitorAccepter); + + // Check the class of this mark, if any + isRecursing = shortestUsageMark.isCausedBy(checkClass); + + // Check the causing class or method, if still necessary. + if (!isRecursing) + { + shortestUsageMark.acceptClassVisitor(this); + shortestUsageMark.acceptMemberVisitor(this); + } + } + } + } +} diff --git a/src/proguard/shrink/ShortestUsagePrinter.java b/src/proguard/shrink/ShortestUsagePrinter.java new file mode 100644 index 0000000..db42fe1 --- /dev/null +++ b/src/proguard/shrink/ShortestUsagePrinter.java @@ -0,0 +1,210 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.util.ClassUtil; +import proguard.classfile.visitor.*; + +import java.io.PrintStream; + + +/** + * This ClassVisitor and MemberVisitor prints out the reasons why + * classes and class members have been marked as being used. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class ShortestUsagePrinter +implements ClassVisitor, + MemberVisitor +{ + private final ShortestUsageMarker shortestUsageMarker; + private final boolean verbose; + private final PrintStream ps; + + + /** + * Creates a new UsagePrinter that prints verbosely to System.out. + * @param shortestUsageMarker the usage marker that was used to mark the + * classes and class members. + */ + public ShortestUsagePrinter(ShortestUsageMarker shortestUsageMarker) + { + this(shortestUsageMarker, true); + } + + + /** + * Creates a new UsagePrinter that prints to the given stream. + * @param shortestUsageMarker the usage marker that was used to mark the + * classes and class members. + * @param verbose specifies whether the output should be verbose. + */ + public ShortestUsagePrinter(ShortestUsageMarker shortestUsageMarker, + boolean verbose) + { + this(shortestUsageMarker, verbose, System.out); + } + + /** + * Creates a new UsagePrinter that prints to the given stream. + * @param shortestUsageMarker the usage marker that was used to mark the + * classes and class members. + * @param verbose specifies whether the output should be verbose. + * @param printStream the stream to which to print. + */ + public ShortestUsagePrinter(ShortestUsageMarker shortestUsageMarker, + boolean verbose, + PrintStream printStream) + { + this.shortestUsageMarker = shortestUsageMarker; + this.verbose = verbose; + this.ps = printStream; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + // Print the name of this class. + ps.println(ClassUtil.externalClassName(programClass.getName())); + + // Print the reason for keeping this class. + printReason(programClass); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Print the name of this class. + ps.println(ClassUtil.externalClassName(libraryClass.getName())); + + // Print the reason for keeping this class. + ps.println(" is a library class.\n"); + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Print the name of this field. + String name = programField.getName(programClass); + String type = programField.getDescriptor(programClass); + + ps.println(ClassUtil.externalClassName(programClass.getName()) + + (verbose ? + ": " + ClassUtil.externalFullFieldDescription(0, name, type): + "." + name) + + lineNumberRange(programClass, programField)); + + // Print the reason for keeping this method. + printReason(programField); + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Print the name of this method. + String name = programMethod.getName(programClass); + String type = programMethod.getDescriptor(programClass); + + ps.println(ClassUtil.externalClassName(programClass.getName()) + + (verbose ? + ": " + ClassUtil.externalFullMethodDescription(programClass.getName(), 0, name, type): + "." + name) + + lineNumberRange(programClass, programMethod)); + + // Print the reason for keeping this method. + printReason(programMethod); + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + // Print the name of this field. + String name = libraryField.getName(libraryClass); + String type = libraryField.getDescriptor(libraryClass); + + ps.println(ClassUtil.externalClassName(libraryClass.getName()) + + (verbose ? + ": " + ClassUtil.externalFullFieldDescription(0, name, type): + "." + name)); + + // Print the reason for keeping this field. + ps.println(" is a library field.\n"); + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + // Print the name of this method. + String name = libraryMethod.getName(libraryClass); + String type = libraryMethod.getDescriptor(libraryClass); + + ps.println(ClassUtil.externalClassName(libraryClass.getName()) + + (verbose ? + ": " + ClassUtil.externalFullMethodDescription(libraryClass.getName(), 0, name, type): + "." + name)); + + // Print the reason for keeping this method. + ps.println(" is a library method.\n"); + } + + + // Small utility methods. + + private void printReason(VisitorAccepter visitorAccepter) + { + if (shortestUsageMarker.isUsed(visitorAccepter)) + { + ShortestUsageMark shortestUsageMark = shortestUsageMarker.getShortestUsageMark(visitorAccepter); + + // Print the reason for keeping this class. + ps.print(" " + shortestUsageMark.getReason()); + + // Print the class or method that is responsible, with its reasons. + shortestUsageMark.acceptClassVisitor(this); + shortestUsageMark.acceptMemberVisitor(this); + } + else + { + ps.println(" is not being kept.\n"); + } + } + + + /** + * Returns the line number range of the given class member, followed by a + * colon, or just an empty String if no range is available. + */ + private static String lineNumberRange(ProgramClass programClass, ProgramMember programMember) + { + String range = programMember.getLineNumberRange(programClass); + return range != null ? + (" (" + range + ")") : + ""; + } +} diff --git a/src/proguard/shrink/Shrinker.java b/src/proguard/shrink/Shrinker.java new file mode 100644 index 0000000..edbc27f --- /dev/null +++ b/src/proguard/shrink/Shrinker.java @@ -0,0 +1,170 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.*; +import proguard.classfile.ClassPool; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.visitor.*; + +import java.io.*; + +/** + * This class shrinks class pools according to a given configuration. + * + * @author Eric Lafortune + */ +public class Shrinker +{ + private final Configuration configuration; + + + /** + * Creates a new Shrinker. + */ + public Shrinker(Configuration configuration) + { + this.configuration = configuration; + } + + + /** + * Performs shrinking of the given program class pool. + */ + public ClassPool execute(ClassPool programClassPool, + ClassPool libraryClassPool) throws IOException + { + // Check if we have at least some keep commands. + if (configuration.keep == null) + { + throw new IOException("You have to specify '-keep' options for the shrinking step."); + } + + // Clean up any old visitor info. + programClassPool.classesAccept(new ClassCleaner()); + libraryClassPool.classesAccept(new ClassCleaner()); + + // Create a visitor for marking the seeds. + UsageMarker usageMarker = configuration.whyAreYouKeeping == null ? + new UsageMarker() : + new ShortestUsageMarker(); + + ClassPoolVisitor classPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(configuration.keep, + usageMarker, + usageMarker, + true, + false, + false); + // Mark the seeds. + programClassPool.accept(classPoolvisitor); + libraryClassPool.accept(classPoolvisitor); + + // Mark interfaces that have to be kept. + programClassPool.classesAccept(new InterfaceUsageMarker(usageMarker)); + + // Mark the inner class and annotation information that has to be kept. + programClassPool.classesAccept( + new UsedClassFilter(usageMarker, + new AllAttributeVisitor(true, + new MultiAttributeVisitor(new AttributeVisitor[] + { + new InnerUsageMarker(usageMarker), + new AnnotationUsageMarker(usageMarker), + })))); + + // Should we explain ourselves? + if (configuration.whyAreYouKeeping != null) + { + System.out.println(); + + // Create a visitor for explaining classes and class members. + ShortestUsagePrinter shortestUsagePrinter = + new ShortestUsagePrinter((ShortestUsageMarker)usageMarker, + configuration.verbose); + + ClassPoolVisitor whyClassPoolvisitor = + ClassSpecificationVisitorFactory.createClassPoolVisitor(configuration.whyAreYouKeeping, + shortestUsagePrinter, + shortestUsagePrinter); + + // Mark the seeds. + programClassPool.accept(whyClassPoolvisitor); + libraryClassPool.accept(whyClassPoolvisitor); + } + + if (configuration.printUsage != null) + { + PrintStream ps = isFile(configuration.printUsage) ? + new PrintStream(new BufferedOutputStream(new FileOutputStream(configuration.printUsage))) : + System.out; + + // Print out items that will be removed. + programClassPool.classesAcceptAlphabetically( + new UsagePrinter(usageMarker, true, ps)); + + if (ps != System.out) + { + ps.close(); + } + } + + // Discard unused program classes. + int originalProgramClassPoolSize = programClassPool.size(); + + ClassPool newProgramClassPool = new ClassPool(); + programClassPool.classesAccept( + new UsedClassFilter(usageMarker, + new MultiClassVisitor( + new ClassVisitor[] { + new ClassShrinker(usageMarker), + new ClassPoolFiller(newProgramClassPool) + }))); + + programClassPool.clear(); + + // Check if we have at least some output classes. + int newProgramClassPoolSize = newProgramClassPool.size(); + if (newProgramClassPoolSize == 0) + { + throw new IOException("The output jar is empty. Did you specify the proper '-keep' options?"); + } + + if (configuration.verbose) + { + System.out.println("Removing unused program classes and class elements..."); + System.out.println(" Original number of program classes: " + originalProgramClassPoolSize); + System.out.println(" Final number of program classes: " + newProgramClassPoolSize); + } + + return newProgramClassPool; + } + + + /** + * Returns whether the given file is actually a file, or just a placeholder + * for the standard output. + */ + private boolean isFile(File file) + { + return file.getPath().length() > 0; + } +} diff --git a/src/proguard/shrink/UsageMarker.java b/src/proguard/shrink/UsageMarker.java new file mode 100644 index 0000000..e913046 --- /dev/null +++ b/src/proguard/shrink/UsageMarker.java @@ -0,0 +1,920 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.attribute.*; +import proguard.classfile.attribute.annotation.*; +import proguard.classfile.attribute.preverification.*; +import proguard.classfile.attribute.preverification.visitor.*; +import proguard.classfile.attribute.visitor.*; +import proguard.classfile.constant.*; +import proguard.classfile.constant.visitor.ConstantVisitor; +import proguard.classfile.instruction.*; +import proguard.classfile.instruction.visitor.InstructionVisitor; +import proguard.classfile.util.SimplifiedVisitor; +import proguard.classfile.visitor.*; + + +/** + * This ClassVisitor and MemberVisitor recursively marks all classes and class + * elements that are being used. + * + * @see ClassShrinker + * + * @author Eric Lafortune + */ +class UsageMarker +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor, + ConstantVisitor, + AttributeVisitor, + InnerClassesInfoVisitor, + ExceptionInfoVisitor, + StackMapFrameVisitor, + VerificationTypeVisitor, + LocalVariableInfoVisitor, + LocalVariableTypeInfoVisitor, +// AnnotationVisitor, +// ElementValueVisitor, + InstructionVisitor +{ + // A visitor info flag to indicate the ProgramMember object is being used, + // if its Clazz can be determined as being used as well. + private static final Object POSSIBLY_USED = new Object(); + // A visitor info flag to indicate the visitor accepter is being used. + private static final Object USED = new Object(); + + + private final MyInterfaceUsageMarker interfaceUsageMarker = new MyInterfaceUsageMarker(); + private final MyPossiblyUsedMemberUsageMarker possiblyUsedMemberUsageMarker = new MyPossiblyUsedMemberUsageMarker(); +// private ClassVisitor dynamicClassMarker = +// new MultiClassVisitor( +// new ClassVisitor[] +// { +// this, +// new NamedMethodVisitor(ClassConstants.INTERNAL_METHOD_NAME_INIT, +// ClassConstants.INTERNAL_METHOD_TYPE_INIT, +// this) +// }); + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (shouldBeMarkedAsUsed(programClass)) + { + // Mark this class. + markAsUsed(programClass); + + markProgramClassBody(programClass); + } + } + + + protected void markProgramClassBody(ProgramClass programClass) + { + // Mark this class's name. + markConstant(programClass, programClass.u2thisClass); + + // Mark the superclass. + if (programClass.u2superClass != 0) + { + markConstant(programClass, programClass.u2superClass); + } + + // Give the interfaces preliminary marks. + programClass.hierarchyAccept(false, false, true, false, + interfaceUsageMarker); + + // Explicitly mark the method. + programClass.methodAccept(ClassConstants.INTERNAL_METHOD_NAME_CLINIT, + ClassConstants.INTERNAL_METHOD_TYPE_CLINIT, + this); + + // Explicitly mark the parameterless method. + programClass.methodAccept(ClassConstants.INTERNAL_METHOD_NAME_INIT, + ClassConstants.INTERNAL_METHOD_TYPE_INIT, + this); + + // Process all class members that have already been marked as possibly used. + programClass.fieldsAccept(possiblyUsedMemberUsageMarker); + programClass.methodsAccept(possiblyUsedMemberUsageMarker); + + // Mark the attributes. + programClass.attributesAccept(this); + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (shouldBeMarkedAsUsed(libraryClass)) + { + markAsUsed(libraryClass); + + // We're not going to analyze all library code. We're assuming that + // if this class is being used, all of its methods will be used as + // well. We'll mark them as such (here and in all subclasses). + + // Mark the superclass. + Clazz superClass = libraryClass.superClass; + if (superClass != null) + { + superClass.accept(this); + } + + // Mark the interfaces. + Clazz[] interfaceClasses = libraryClass.interfaceClasses; + if (interfaceClasses != null) + { + for (int index = 0; index < interfaceClasses.length; index++) + { + if (interfaceClasses[index] != null) + { + interfaceClasses[index].accept(this); + } + } + } + + // Mark all methods. + libraryClass.methodsAccept(this); + } + } + + + /** + * This ClassVisitor marks ProgramClass objects as possibly used, + * and it visits LibraryClass objects with its outer UsageMarker. + */ + private class MyInterfaceUsageMarker + implements ClassVisitor + { + public void visitProgramClass(ProgramClass programClass) + { + if (shouldBeMarkedAsPossiblyUsed(programClass)) + { + // We can't process the interface yet, because it might not + // be required. Give it a preliminary mark. + markAsPossiblyUsed(programClass); + } + } + + public void visitLibraryClass(LibraryClass libraryClass) + { + // Make sure all library interface methods are marked. + UsageMarker.this.visitLibraryClass(libraryClass); + } + } + + + private class MyPossiblyUsedMemberUsageMarker + extends SimplifiedVisitor + implements MemberVisitor + { + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + // Has the method already been referenced? + if (isPossiblyUsed(programField)) + { + markAsUsed(programField); + + // Mark the name and descriptor. + markConstant(programClass, programField.u2nameIndex); + markConstant(programClass, programField.u2descriptorIndex); + + // Mark the attributes. + programField.attributesAccept(programClass, UsageMarker.this); + + // Mark the classes referenced in the descriptor string. + programField.referencedClassesAccept(UsageMarker.this); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + // Has the method already been referenced? + if (isPossiblyUsed(programMethod)) + { + markAsUsed(programMethod); + + // Mark the method body. + markProgramMethodBody(programClass, programMethod); + + // Note that, if the method has been marked as possibly used, + // the method hierarchy has already been marked (cfr. below). + } + } + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (shouldBeMarkedAsUsed(programField)) + { + // Is the field's class used? + if (isUsed(programClass)) + { + markAsUsed(programField); + + // Mark the field body. + markProgramFieldBody(programClass, programField); + } + + // Hasn't the field been marked as possibly being used yet? + else if (shouldBeMarkedAsPossiblyUsed(programField)) + { + // We can't process the field yet, because the class isn't + // marked as being used (yet). Give it a preliminary mark. + markAsPossiblyUsed(programField); + } + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (shouldBeMarkedAsUsed(programMethod)) + { + // Is the method's class used? + if (isUsed(programClass)) + { + markAsUsed(programMethod); + + // Mark the method body. + markProgramMethodBody(programClass, programMethod); + + // Mark the method hierarchy. + markMethodHierarchy(programClass, programMethod); + } + + // Hasn't the method been marked as possibly being used yet? + else if (shouldBeMarkedAsPossiblyUsed(programMethod)) + { + // We can't process the method yet, because the class isn't + // marked as being used (yet). Give it a preliminary mark. + markAsPossiblyUsed(programMethod); + + // Mark the method hierarchy. + markMethodHierarchy(programClass, programMethod); + } + } + } + + + public void visitLibraryField(LibraryClass programClass, LibraryField programField) {} + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (shouldBeMarkedAsUsed(libraryMethod)) + { + markAsUsed(libraryMethod); + + // Mark the method hierarchy. + markMethodHierarchy(libraryClass, libraryMethod); + } + } + + + protected void markProgramFieldBody(ProgramClass programClass, ProgramField programField) + { + // Mark the name and descriptor. + markConstant(programClass, programField.u2nameIndex); + markConstant(programClass, programField.u2descriptorIndex); + + // Mark the attributes. + programField.attributesAccept(programClass, this); + + // Mark the classes referenced in the descriptor string. + programField.referencedClassesAccept(this); + } + + + protected void markProgramMethodBody(ProgramClass programClass, ProgramMethod programMethod) + { + // Mark the name and descriptor. + markConstant(programClass, programMethod.u2nameIndex); + markConstant(programClass, programMethod.u2descriptorIndex); + + // Mark the attributes. + programMethod.attributesAccept(programClass, this); + + // Mark the classes referenced in the descriptor string. + programMethod.referencedClassesAccept(this); + } + + + /** + * Marks the hierarchy of implementing or overriding methods corresponding + * to the given method, if any. + */ + protected void markMethodHierarchy(Clazz clazz, Method method) + { + if ((method.getAccessFlags() & + (ClassConstants.INTERNAL_ACC_PRIVATE | + ClassConstants.INTERNAL_ACC_STATIC)) == 0) + { + clazz.accept(new ConcreteClassDownTraveler( + new ClassHierarchyTraveler(true, true, false, true, + new NamedMethodVisitor(method.getName(clazz), + method.getDescriptor(clazz), + new MemberAccessFilter(0, ClassConstants.INTERNAL_ACC_PRIVATE | ClassConstants.INTERNAL_ACC_STATIC | ClassConstants.INTERNAL_ACC_ABSTRACT, + this))))); + } + } + + + // Implementations for ConstantVisitor. + + public void visitIntegerConstant(Clazz clazz, IntegerConstant integerConstant) + { + if (shouldBeMarkedAsUsed(integerConstant)) + { + markAsUsed(integerConstant); + } + } + + + public void visitLongConstant(Clazz clazz, LongConstant longConstant) + { + if (shouldBeMarkedAsUsed(longConstant)) + { + markAsUsed(longConstant); + } + } + + + public void visitFloatConstant(Clazz clazz, FloatConstant floatConstant) + { + if (shouldBeMarkedAsUsed(floatConstant)) + { + markAsUsed(floatConstant); + } + } + + + public void visitDoubleConstant(Clazz clazz, DoubleConstant doubleConstant) + { + if (shouldBeMarkedAsUsed(doubleConstant)) + { + markAsUsed(doubleConstant); + } + } + + + public void visitStringConstant(Clazz clazz, StringConstant stringConstant) + { + if (shouldBeMarkedAsUsed(stringConstant)) + { + markAsUsed(stringConstant); + + markConstant(clazz, stringConstant.u2stringIndex); + + // Mark the referenced class and its parameterless constructor, + // if the string is being used in a Class.forName construct. + //stringConstant.referencedClassAccept(dynamicClassMarker); + + // Mark the referenced class or class member, if any. + stringConstant.referencedClassAccept(this); + stringConstant.referencedMemberAccept(this); + } + } + + + public void visitUtf8Constant(Clazz clazz, Utf8Constant utf8Constant) + { + if (shouldBeMarkedAsUsed(utf8Constant)) + { + markAsUsed(utf8Constant); + } + } + + + public void visitAnyRefConstant(Clazz clazz, RefConstant refConstant) + { + if (shouldBeMarkedAsUsed(refConstant)) + { + markAsUsed(refConstant); + + markConstant(clazz, refConstant.u2classIndex); + markConstant(clazz, refConstant.u2nameAndTypeIndex); + + // When compiled with "-target 1.2" or higher, the class or + // interface actually containing the referenced class member may + // be higher up the hierarchy. Make sure it's marked, in case it + // isn't used elsewhere. + refConstant.referencedClassAccept(this); + + // Mark the referenced class member itself. + refConstant.referencedMemberAccept(this); + } + } + + + public void visitClassConstant(Clazz clazz, ClassConstant classConstant) + { + if (shouldBeMarkedAsUsed(classConstant)) + { + markAsUsed(classConstant); + + markConstant(clazz, classConstant.u2nameIndex); + + // Mark the referenced class itself. + classConstant.referencedClassAccept(this); + } + } + + + public void visitNameAndTypeConstant(Clazz clazz, NameAndTypeConstant nameAndTypeConstant) + { + if (shouldBeMarkedAsUsed(nameAndTypeConstant)) + { + markAsUsed(nameAndTypeConstant); + + markConstant(clazz, nameAndTypeConstant.u2nameIndex); + markConstant(clazz, nameAndTypeConstant.u2descriptorIndex); + } + } + + + // Implementations for AttributeVisitor. + // Note that attributes are typically only referenced once, so we don't + // test if they have been marked already. + + public void visitUnknownAttribute(Clazz clazz, UnknownAttribute unknownAttribute) + { + // This is the best we can do for unknown attributes. + markAsUsed(unknownAttribute); + + markConstant(clazz, unknownAttribute.u2attributeNameIndex); + } + + + public void visitSourceFileAttribute(Clazz clazz, SourceFileAttribute sourceFileAttribute) + { + markAsUsed(sourceFileAttribute); + + markConstant(clazz, sourceFileAttribute.u2attributeNameIndex); + markConstant(clazz, sourceFileAttribute.u2sourceFileIndex); + } + + + public void visitSourceDirAttribute(Clazz clazz, SourceDirAttribute sourceDirAttribute) + { + markAsUsed(sourceDirAttribute); + + markConstant(clazz, sourceDirAttribute.u2attributeNameIndex); + markConstant(clazz, sourceDirAttribute.u2sourceDirIndex); + } + + + public void visitInnerClassesAttribute(Clazz clazz, InnerClassesAttribute innerClassesAttribute) + { + // Don't mark the attribute and its name yet. We may mark it later, in + // InnerUsageMarker. + //markAsUsed(innerClassesAttribute); + + //markConstant(clazz, innerClassesAttribute.u2attrNameIndex); + + // Do mark the outer class entries. + innerClassesAttribute.innerClassEntriesAccept(clazz, this); + } + + + public void visitEnclosingMethodAttribute(Clazz clazz, EnclosingMethodAttribute enclosingMethodAttribute) + { + markAsUsed(enclosingMethodAttribute); + + markConstant(clazz, enclosingMethodAttribute.u2attributeNameIndex); + markConstant(clazz, enclosingMethodAttribute.u2classIndex); + + if (enclosingMethodAttribute.u2nameAndTypeIndex != 0) + { + markConstant(clazz, enclosingMethodAttribute.u2nameAndTypeIndex); + } + } + + + public void visitDeprecatedAttribute(Clazz clazz, DeprecatedAttribute deprecatedAttribute) + { + markAsUsed(deprecatedAttribute); + + markConstant(clazz, deprecatedAttribute.u2attributeNameIndex); + } + + + public void visitSyntheticAttribute(Clazz clazz, SyntheticAttribute syntheticAttribute) + { + markAsUsed(syntheticAttribute); + + markConstant(clazz, syntheticAttribute.u2attributeNameIndex); + } + + + public void visitSignatureAttribute(Clazz clazz, SignatureAttribute signatureAttribute) + { + markAsUsed(signatureAttribute); + + markConstant(clazz, signatureAttribute.u2attributeNameIndex); + markConstant(clazz, signatureAttribute.u2signatureIndex); + } + + + public void visitConstantValueAttribute(Clazz clazz, Field field, ConstantValueAttribute constantValueAttribute) + { + markAsUsed(constantValueAttribute); + + markConstant(clazz, constantValueAttribute.u2attributeNameIndex); + markConstant(clazz, constantValueAttribute.u2constantValueIndex); + } + + + public void visitExceptionsAttribute(Clazz clazz, Method method, ExceptionsAttribute exceptionsAttribute) + { + markAsUsed(exceptionsAttribute); + + markConstant(clazz, exceptionsAttribute.u2attributeNameIndex); + + // Mark the constant pool entries referenced by the exceptions. + exceptionsAttribute.exceptionEntriesAccept((ProgramClass)clazz, this); + } + + + public void visitCodeAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute) + { + markAsUsed(codeAttribute); + + markConstant(clazz, codeAttribute.u2attributeNameIndex); + + // Mark the constant pool entries referenced by the instructions, + // by the exceptions, and by the attributes. + codeAttribute.instructionsAccept(clazz, method, this); + codeAttribute.exceptionsAccept(clazz, method, this); + codeAttribute.attributesAccept(clazz, method, this); + } + + + public void visitStackMapAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapAttribute stackMapAttribute) + { + markAsUsed(stackMapAttribute); + + markConstant(clazz, stackMapAttribute.u2attributeNameIndex); + + // Mark the constant pool entries referenced by the stack map frames. + stackMapAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitStackMapTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, StackMapTableAttribute stackMapTableAttribute) + { + markAsUsed(stackMapTableAttribute); + + markConstant(clazz, stackMapTableAttribute.u2attributeNameIndex); + + // Mark the constant pool entries referenced by the stack map frames. + stackMapTableAttribute.stackMapFramesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLineNumberTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LineNumberTableAttribute lineNumberTableAttribute) + { + markAsUsed(lineNumberTableAttribute); + + markConstant(clazz, lineNumberTableAttribute.u2attributeNameIndex); + } + + + public void visitLocalVariableTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTableAttribute localVariableTableAttribute) + { + markAsUsed(localVariableTableAttribute); + + markConstant(clazz, localVariableTableAttribute.u2attributeNameIndex); + + // Mark the constant pool entries referenced by the local variables. + localVariableTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitLocalVariableTypeTableAttribute(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeTableAttribute localVariableTypeTableAttribute) + { + markAsUsed(localVariableTypeTableAttribute); + + markConstant(clazz, localVariableTypeTableAttribute.u2attributeNameIndex); + + // Mark the constant pool entries referenced by the local variable types. + localVariableTypeTableAttribute.localVariablesAccept(clazz, method, codeAttribute, this); + } + + + public void visitAnyAnnotationsAttribute(Clazz clazz, AnnotationsAttribute annotationsAttribute) + { + // Don't mark the attribute and its contents yet. We may mark them later, + // in AnnotationUsageMarker. +// markAsUsed(annotationsAttribute); +// +// markConstant(clazz, annotationsAttribute.u2attributeNameIndex); +// +// // Mark the constant pool entries referenced by the annotations. +// annotationsAttribute.annotationsAccept(clazz, this); + } + + + public void visitAnyParameterAnnotationsAttribute(Clazz clazz, Method method, ParameterAnnotationsAttribute parameterAnnotationsAttribute) + { + // Don't mark the attribute and its contents yet. We may mark them later, + // in AnnotationUsageMarker. +// markAsUsed(parameterAnnotationsAttribute); +// +// markConstant(clazz, parameterAnnotationsAttribute.u2attributeNameIndex); +// +// // Mark the constant pool entries referenced by the annotations. +// parameterAnnotationsAttribute.annotationsAccept(clazz, method, this); + } + + + public void visitAnnotationDefaultAttribute(Clazz clazz, Method method, AnnotationDefaultAttribute annotationDefaultAttribute) + { + // Don't mark the attribute and its contents yet. We may mark them later, + // in AnnotationUsageMarker. +// markAsUsed(annotationDefaultAttribute); +// +// markConstant(clazz, annotationDefaultAttribute.u2attributeNameIndex); +// +// // Mark the constant pool entries referenced by the element value. +// annotationDefaultAttribute.defaultValueAccept(clazz, this); + } + + + // Implementations for ExceptionInfoVisitor. + + public void visitExceptionInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, ExceptionInfo exceptionInfo) + { + markAsUsed(exceptionInfo); + + if (exceptionInfo.u2catchType != 0) + { + markConstant(clazz, exceptionInfo.u2catchType); + } + } + + + // Implementations for InnerClassesInfoVisitor. + + public void visitInnerClassesInfo(Clazz clazz, InnerClassesInfo innerClassesInfo) + { + // At this point, we only mark outer classes of this class. + // Inner class can be marked later, by InnerUsageMarker. + if (innerClassesInfo.u2innerClassIndex != 0 && + clazz.getName().equals(clazz.getClassName(innerClassesInfo.u2innerClassIndex))) + { + markAsUsed(innerClassesInfo); + + innerClassesInfo.innerClassConstantAccept(clazz, this); + innerClassesInfo.outerClassConstantAccept(clazz, this); + innerClassesInfo.innerNameConstantAccept(clazz, this); + } + } + + + // Implementations for StackMapFrameVisitor. + + public void visitAnyStackMapFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, StackMapFrame stackMapFrame) {} + + + public void visitSameOneFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, SameOneFrame sameOneFrame) + { + // Mark the constant pool entries referenced by the verification types. + sameOneFrame.stackItemAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitMoreZeroFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, MoreZeroFrame moreZeroFrame) + { + // Mark the constant pool entries referenced by the verification types. + moreZeroFrame.additionalVariablesAccept(clazz, method, codeAttribute, offset, this); + } + + + public void visitFullFrame(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, FullFrame fullFrame) + { + // Mark the constant pool entries referenced by the verification types. + fullFrame.variablesAccept(clazz, method, codeAttribute, offset, this); + fullFrame.stackAccept(clazz, method, codeAttribute, offset, this); + } + + + // Implementations for VerificationTypeVisitor. + + public void visitAnyVerificationType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, VerificationType verificationType) {} + + + public void visitObjectType(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ObjectType objectType) + { + markConstant(clazz, objectType.u2classIndex); + } + + + // Implementations for LocalVariableInfoVisitor. + + public void visitLocalVariableInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableInfo localVariableInfo) + { + markConstant(clazz, localVariableInfo.u2nameIndex); + markConstant(clazz, localVariableInfo.u2descriptorIndex); + } + + + // Implementations for LocalVariableTypeInfoVisitor. + + public void visitLocalVariableTypeInfo(Clazz clazz, Method method, CodeAttribute codeAttribute, LocalVariableTypeInfo localVariableTypeInfo) + { + markConstant(clazz, localVariableTypeInfo.u2nameIndex); + markConstant(clazz, localVariableTypeInfo.u2signatureIndex); + } + + +// // Implementations for AnnotationVisitor. +// +// public void visitAnnotation(Clazz clazz, Annotation annotation) +// { +// markConstant(clazz, annotation.u2typeIndex); +// +// // Mark the constant pool entries referenced by the element values. +// annotation.elementValuesAccept(clazz, this); +// } +// +// +// // Implementations for ElementValueVisitor. +// +// public void visitConstantElementValue(Clazz clazz, Annotation annotation, ConstantElementValue constantElementValue) +// { +// if (constantElementValue.u2elementNameIndex != 0) +// { +// markConstant(clazz, constantElementValue.u2elementNameIndex); +// } +// +// markConstant(clazz, constantElementValue.u2constantValueIndex); +// } +// +// +// public void visitEnumConstantElementValue(Clazz clazz, Annotation annotation, EnumConstantElementValue enumConstantElementValue) +// { +// if (enumConstantElementValue.u2elementNameIndex != 0) +// { +// markConstant(clazz, enumConstantElementValue.u2elementNameIndex); +// } +// +// markConstant(clazz, enumConstantElementValue.u2typeNameIndex); +// markConstant(clazz, enumConstantElementValue.u2constantNameIndex); +// } +// +// +// public void visitClassElementValue(Clazz clazz, Annotation annotation, ClassElementValue classElementValue) +// { +// if (classElementValue.u2elementNameIndex != 0) +// { +// markConstant(clazz, classElementValue.u2elementNameIndex); +// } +// +// // Mark the referenced class constant pool entry. +// markConstant(clazz, classElementValue.u2classInfoIndex); +// } +// +// +// public void visitAnnotationElementValue(Clazz clazz, Annotation annotation, AnnotationElementValue annotationElementValue) +// { +// if (annotationElementValue.u2elementNameIndex != 0) +// { +// markConstant(clazz, annotationElementValue.u2elementNameIndex); +// } +// +// // Mark the constant pool entries referenced by the annotation. +// annotationElementValue.annotationAccept(clazz, this); +// } +// +// +// public void visitArrayElementValue(Clazz clazz, Annotation annotation, ArrayElementValue arrayElementValue) +// { +// if (arrayElementValue.u2elementNameIndex != 0) +// { +// markConstant(clazz, arrayElementValue.u2elementNameIndex); +// } +// +// // Mark the constant pool entries referenced by the element values. +// arrayElementValue.elementValuesAccept(clazz, annotation, this); +// } + + + // Implementations for InstructionVisitor. + + public void visitAnyInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, Instruction instruction) {} + + + public void visitConstantInstruction(Clazz clazz, Method method, CodeAttribute codeAttribute, int offset, ConstantInstruction constantInstruction) + { + markConstant(clazz, constantInstruction.constantIndex); + } + + + // Small utility methods. + + /** + * Marks the given visitor accepter as being used. + */ + protected void markAsUsed(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(USED); + } + + + /** + * Returns whether the given visitor accepter should still be marked as + * being used. + */ + protected boolean shouldBeMarkedAsUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() != USED; + } + + + /** + * Returns whether the given visitor accepter has been marked as being used. + */ + protected boolean isUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() == USED; + } + + + /** + * Marks the given visitor accepter as possibly being used. + */ + protected void markAsPossiblyUsed(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(POSSIBLY_USED); + } + + + /** + * Returns whether the given visitor accepter should still be marked as + * possibly being used. + */ + protected boolean shouldBeMarkedAsPossiblyUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() != USED && + visitorAccepter.getVisitorInfo() != POSSIBLY_USED; + } + + + /** + * Returns whether the given visitor accepter has been marked as possibly + * being used. + */ + protected boolean isPossiblyUsed(VisitorAccepter visitorAccepter) + { + return visitorAccepter.getVisitorInfo() == POSSIBLY_USED; + } + + + /** + * Clears any usage marks from the given visitor accepter. + */ + protected void markAsUnused(VisitorAccepter visitorAccepter) + { + visitorAccepter.setVisitorInfo(null); + } + + + /** + * Marks the given constant pool entry of the given class. This includes + * visiting any referenced objects. + */ + private void markConstant(Clazz clazz, int index) + { + clazz.constantPoolEntryAccept(index, this); + } +} diff --git a/src/proguard/shrink/UsagePrinter.java b/src/proguard/shrink/UsagePrinter.java new file mode 100644 index 0000000..294b9e1 --- /dev/null +++ b/src/proguard/shrink/UsagePrinter.java @@ -0,0 +1,177 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.util.*; +import proguard.classfile.visitor.*; + +import java.io.PrintStream; + + +/** + * This ClassVisitor prints out the classes and class members that have been + * marked as being used (or not used). + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class UsagePrinter +extends SimplifiedVisitor +implements ClassVisitor, + MemberVisitor +{ + private final UsageMarker usageMarker; + private final boolean printUnusedItems; + private final PrintStream ps; + + // A field to remember the class name, if a header is needed for class members. + private String className; + + + /** + * Creates a new UsagePrinter that prints to System.out. + * @param usageMarker the usage marker that was used to mark the + * classes and class members. + * @param printUnusedItems a flag that indicates whether only unused items + * should be printed, or alternatively, only used + * items. + */ + public UsagePrinter(UsageMarker usageMarker, + boolean printUnusedItems) + { + this(usageMarker, printUnusedItems, System.out); + } + + + /** + * Creates a new UsagePrinter that prints to the given stream. + * @param usageMarker the usage marker that was used to mark the + * classes and class members. + * @param printUnusedItems a flag that indicates whether only unused items + * should be printed, or alternatively, only used + * items. + * @param printStream the stream to which to print. + */ + public UsagePrinter(UsageMarker usageMarker, + boolean printUnusedItems, + PrintStream printStream) + { + this.usageMarker = usageMarker; + this.printUnusedItems = printUnusedItems; + this.ps = printStream; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (usageMarker.isUsed(programClass)) + { + if (printUnusedItems) + { + className = programClass.getName(); + + programClass.fieldsAccept(this); + programClass.methodsAccept(this); + + className = null; + } + else + { + ps.println(ClassUtil.externalClassName(programClass.getName())); + } + } + else + { + if (printUnusedItems) + { + ps.println(ClassUtil.externalClassName(programClass.getName())); + } + } + } + + + // Implementations for MemberVisitor. + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (usageMarker.isUsed(programField) ^ printUnusedItems) + { + printClassNameHeader(); + + ps.println(" " + + lineNumberRange(programClass, programField) + + ClassUtil.externalFullFieldDescription( + programField.getAccessFlags(), + programField.getName(programClass), + programField.getDescriptor(programClass))); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (usageMarker.isUsed(programMethod) ^ printUnusedItems) + { + printClassNameHeader(); + + ps.println(" " + + lineNumberRange(programClass, programMethod) + + ClassUtil.externalFullMethodDescription( + programClass.getName(), + programMethod.getAccessFlags(), + programMethod.getName(programClass), + programMethod.getDescriptor(programClass))); + } + } + + + // Small utility methods. + + /** + * Prints the class name field. The field is then cleared, so it is not + * printed again. + */ + private void printClassNameHeader() + { + if (className != null) + { + ps.println(ClassUtil.externalClassName(className) + ":"); + className = null; + } + } + + + /** + * Returns the line number range of the given class member, followed by a + * colon, or just an empty String if no range is available. + */ + private static String lineNumberRange(ProgramClass programClass, ProgramMember programMember) + { + String range = programMember.getLineNumberRange(programClass); + return range != null ? + (range + ":") : + ""; + } +} diff --git a/src/proguard/shrink/UsedClassFilter.java b/src/proguard/shrink/UsedClassFilter.java new file mode 100644 index 0000000..ec180bd --- /dev/null +++ b/src/proguard/shrink/UsedClassFilter.java @@ -0,0 +1,74 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.visitor.ClassVisitor; + +/** + * This ClassVisitor delegates all its method calls to another ClassVisitor, + * but only for Clazz objects that are marked as used. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class UsedClassFilter +implements ClassVisitor +{ + private final UsageMarker usageMarker; + private final ClassVisitor classVisitor; + + + /** + * Creates a new UsedClassFilter. + * @param usageMarker the usage marker that is used to mark the classes + * and class members. + * @param classVisitor the class visitor to which the visiting will be + * delegated. + */ + public UsedClassFilter(UsageMarker usageMarker, + ClassVisitor classVisitor) + { + this.usageMarker = usageMarker; + this.classVisitor = classVisitor; + } + + + // Implementations for ClassVisitor. + + public void visitProgramClass(ProgramClass programClass) + { + if (usageMarker.isUsed(programClass)) + { + classVisitor.visitProgramClass(programClass); + } + } + + + public void visitLibraryClass(LibraryClass libraryClass) + { + if (usageMarker.isUsed(libraryClass)) + { + classVisitor.visitLibraryClass(libraryClass); + } + } +} diff --git a/src/proguard/shrink/UsedMemberFilter.java b/src/proguard/shrink/UsedMemberFilter.java new file mode 100644 index 0000000..755cfd1 --- /dev/null +++ b/src/proguard/shrink/UsedMemberFilter.java @@ -0,0 +1,93 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.shrink; + +import proguard.classfile.*; +import proguard.classfile.visitor.MemberVisitor; + +/** + * This MemberVisitor delegates all its method calls to another MemberVisitor, + * but only for Member objects that are marked as used. + * + * @see UsageMarker + * + * @author Eric Lafortune + */ +public class UsedMemberFilter +implements MemberVisitor +{ + private final UsageMarker usageMarker; + private final MemberVisitor memberVisitor; + + + /** + * Creates a new UsedClassFilter. + * @param usageMarker the usage marker that is used to mark the classes + * and class members. + * @param memberVisitor the member visitor to which the visiting will be + * delegated. + */ + public UsedMemberFilter(UsageMarker usageMarker, + MemberVisitor memberVisitor) + { + this.usageMarker = usageMarker; + this.memberVisitor = memberVisitor; + } + + + // Implementations for MemberVisitor. + + + public void visitProgramField(ProgramClass programClass, ProgramField programField) + { + if (usageMarker.isUsed(programField)) + { + memberVisitor.visitProgramField(programClass, programField); + } + } + + + public void visitProgramMethod(ProgramClass programClass, ProgramMethod programMethod) + { + if (usageMarker.isUsed(programMethod)) + { + memberVisitor.visitProgramMethod(programClass, programMethod); + } + } + + + public void visitLibraryField(LibraryClass libraryClass, LibraryField libraryField) + { + if (usageMarker.isUsed(libraryField)) + { + memberVisitor.visitLibraryField(libraryClass, libraryField); + } + } + + + public void visitLibraryMethod(LibraryClass libraryClass, LibraryMethod libraryMethod) + { + if (usageMarker.isUsed(libraryMethod)) + { + memberVisitor.visitLibraryMethod(libraryClass, libraryMethod); + } + } +} diff --git a/src/proguard/shrink/package.html b/src/proguard/shrink/package.html new file mode 100644 index 0000000..8973198 --- /dev/null +++ b/src/proguard/shrink/package.html @@ -0,0 +1,3 @@ + +This package contains classes to perform shrinking of class files. + diff --git a/src/proguard/util/AndMatcher.java b/src/proguard/util/AndMatcher.java new file mode 100644 index 0000000..94a37e5 --- /dev/null +++ b/src/proguard/util/AndMatcher.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings matches both given StringMatcher + * instances. + * + * @author Eric Lafortune + */ +public class AndMatcher implements StringMatcher +{ + private final StringMatcher matcher1; + private final StringMatcher matcher2; + + + public AndMatcher(StringMatcher matcher1, StringMatcher matcher2) + { + this.matcher1 = matcher1; + this.matcher2 = matcher2; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return matcher1.matches(string) && + matcher2.matches(string); + } +} diff --git a/src/proguard/util/ClassNameParser.java b/src/proguard/util/ClassNameParser.java new file mode 100644 index 0000000..ee972f0 --- /dev/null +++ b/src/proguard/util/ClassNameParser.java @@ -0,0 +1,216 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +import proguard.classfile.ClassConstants; + +/** + * This StringParser can create StringMatcher instances for regular expressions + * matching internal class names (or descriptors containing class names). + * The regular expressions can contain the following wildcards: + * '%' for a single internal primitive type character (V, Z, B, C, S, I, F, + * J, or D), + * '?' for a single regular class name character, + * '*' for any number of regular class name characters, + * '**' for any number of regular class name characters or package separator + * characters ('/'), + * 'L***;' for a single internal type (class name or primitive type, + * array or non-array), and + * 'L///;' for any number of internal types (class names and primitive + * types). + * + * @author Eric Lafortune + */ +public class ClassNameParser implements StringParser +{ + private static final char[] INTERNAL_PRIMITIVE_TYPES = new char[] + { + ClassConstants.INTERNAL_TYPE_VOID, + ClassConstants.INTERNAL_TYPE_BOOLEAN, + ClassConstants.INTERNAL_TYPE_BYTE, + ClassConstants.INTERNAL_TYPE_CHAR, + ClassConstants.INTERNAL_TYPE_SHORT, + ClassConstants.INTERNAL_TYPE_INT, + ClassConstants.INTERNAL_TYPE_LONG, + ClassConstants.INTERNAL_TYPE_FLOAT, + ClassConstants.INTERNAL_TYPE_DOUBLE, + }; + + + // Implementations for StringParser. + + public StringMatcher parse(String regularExpression) + { + int index; + StringMatcher nextMatcher = new EmptyStringMatcher(); + + // Look for wildcards. + for (index = 0; index < regularExpression.length(); index++) + { + // Is there an 'L///;' wildcard? + if (regularExpression.regionMatches(index, "L///;", 0, 5)) + { + SettableMatcher settableMatcher = new SettableMatcher(); + + // Create a matcher, recursively, for the remainder of the + // string, optionally preceded by any type. + nextMatcher = + new OrMatcher(parse(regularExpression.substring(index + 5)), + createAnyTypeMatcher(settableMatcher)); + + settableMatcher.setMatcher(nextMatcher); + + break; + } + + // Is there an 'L***;' wildcard? + if (regularExpression.regionMatches(index, "L***;", 0, 5)) + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + createAnyTypeMatcher(parse(regularExpression.substring(index + 5))); + break; + } + + // Is there a '**' wildcard? + if (regularExpression.regionMatches(index, "**", 0, 2)) + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + new char[] { ClassConstants.INTERNAL_TYPE_CLASS_END }, + 0, + Integer.MAX_VALUE, + parse(regularExpression.substring(index + 2))); + break; + } + + // Is there a '*' wildcard? + else if (regularExpression.charAt(index) == '*') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + new char[] { ClassConstants.INTERNAL_TYPE_CLASS_END, ClassConstants.INTERNAL_PACKAGE_SEPARATOR }, + 0, + Integer.MAX_VALUE, + parse(regularExpression.substring(index + 1))); + break; + } + + // Is there a '?' wildcard? + else if (regularExpression.charAt(index) == '?') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + new char[] { ClassConstants.INTERNAL_TYPE_CLASS_END, ClassConstants.INTERNAL_PACKAGE_SEPARATOR }, + 1, + 1, + parse(regularExpression.substring(index + 1))); + break; + } + + // Is there a '%' wildcard? + else if (regularExpression.charAt(index) == '%') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(INTERNAL_PRIMITIVE_TYPES, + null, + 1, + 1, + parse(regularExpression.substring(index + 1))); + break; + } + } + + // Return a matcher for the fixed first part of the regular expression, + // if any, and the remainder. + return index != 0 ? + (StringMatcher)new FixedStringMatcher(regularExpression.substring(0, index), nextMatcher) : + (StringMatcher)nextMatcher; + } + + + // Small utility methods. + + + /** + * Creates a StringMatcher that matches any type (class or primitive type, + * array or non-array) and then the given matcher. + */ + private VariableStringMatcher createAnyTypeMatcher(StringMatcher nextMatcher) + { + return new VariableStringMatcher(new char[] { ClassConstants.INTERNAL_TYPE_ARRAY }, + null, + 0, + 255, + new OrMatcher( + new VariableStringMatcher(INTERNAL_PRIMITIVE_TYPES, + null, + 1, + 1, + nextMatcher), + new VariableStringMatcher(new char[] { ClassConstants.INTERNAL_TYPE_CLASS_START }, + null, + 1, + 1, + new VariableStringMatcher(null, + new char[] { ClassConstants.INTERNAL_TYPE_CLASS_END }, + 0, + Integer.MAX_VALUE, + new VariableStringMatcher(new char[] { ClassConstants.INTERNAL_TYPE_CLASS_END }, + null, + 1, + 1, + nextMatcher))))); + } + + + /** + * A main method for testing class name matching. + */ + public static void main(String[] args) + { + try + { + System.out.println("Regular expression ["+args[0]+"]"); + ClassNameParser parser = new ClassNameParser(); + StringMatcher matcher = parser.parse(args[0]); + for (int index = 1; index < args.length; index++) + { + String string = args[index]; + System.out.print("String ["+string+"]"); + System.out.println(" -> match = "+matcher.matches(args[index])); + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/util/ConstantMatcher.java b/src/proguard/util/ConstantMatcher.java new file mode 100644 index 0000000..1764caa --- /dev/null +++ b/src/proguard/util/ConstantMatcher.java @@ -0,0 +1,48 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher matches any string or no string at all. + * + * @author Eric Lafortune + */ +public class ConstantMatcher implements StringMatcher +{ + private boolean matches; + + + /** + * Creates a new ConstantMatcher that always returns the given result. + */ + public ConstantMatcher(boolean matches) + { + this.matches = matches; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return matches; + } +} \ No newline at end of file diff --git a/src/proguard/util/EmptyStringMatcher.java b/src/proguard/util/EmptyStringMatcher.java new file mode 100644 index 0000000..543f446 --- /dev/null +++ b/src/proguard/util/EmptyStringMatcher.java @@ -0,0 +1,36 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings are empty. + * + * @author Eric Lafortune + */ +public class EmptyStringMatcher implements StringMatcher +{ + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return string.length() == 0; + } +} diff --git a/src/proguard/util/ExtensionMatcher.java b/src/proguard/util/ExtensionMatcher.java new file mode 100644 index 0000000..5a9f658 --- /dev/null +++ b/src/proguard/util/ExtensionMatcher.java @@ -0,0 +1,63 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings end in a given extension, ignoring + * its case. + * + * @author Eric Lafortune + */ +public class ExtensionMatcher implements StringMatcher +{ + private final String extension; + + + /** + * Creates a new StringMatcher. + * @param extension the extension against which strings will be matched. + */ + public ExtensionMatcher(String extension) + { + this.extension = extension; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return endsWithIgnoreCase(string, extension); + } + + + /** + * Returns whether the given string ends with the given suffix, ignoring its + * case. + */ + private static boolean endsWithIgnoreCase(String string, String suffix) + { + int stringLength = string.length(); + int suffixLength = suffix.length(); + + return string.regionMatches(true, stringLength - suffixLength, suffix, 0, suffixLength); + } +} diff --git a/src/proguard/util/FileNameParser.java b/src/proguard/util/FileNameParser.java new file mode 100644 index 0000000..913f22d --- /dev/null +++ b/src/proguard/util/FileNameParser.java @@ -0,0 +1,121 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +import java.io.File; + +/** + * This StringParser can create StringMatcher instances for regular expressions + * matching file names. The regular expressions can contain the following + * wildcards: + * '?' for a single regular file name character, + * '*' for any number of regular file name characters, and + * '**' for any number of regular file name characters or directory separator + * characters (always including '/'). + * + * @author Eric Lafortune + */ +public class FileNameParser implements StringParser +{ + // Implementations for StringParser. + + public StringMatcher parse(String regularExpression) + { + int index; + StringMatcher nextMatcher = new EmptyStringMatcher(); + + // Look for wildcards. + for (index = 0; index < regularExpression.length(); index++) + { + // Is there a '**' wildcard? + if (regularExpression.regionMatches(index, "**", 0, 2)) + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + null, + 0, + Integer.MAX_VALUE, + parse(regularExpression.substring(index + 2))); + break; + } + + // Is there a '*' wildcard? + else if (regularExpression.charAt(index) == '*') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + new char[] { File.pathSeparatorChar, '/' }, + 0, + Integer.MAX_VALUE, + parse(regularExpression.substring(index + 1))); + break; + } + + // Is there a '?' wildcard? + else if (regularExpression.charAt(index) == '?') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + new char[] { File.pathSeparatorChar, '/' }, + 1, + 1, + parse(regularExpression.substring(index + 1))); + break; + } + } + + // Return a matcher for the fixed first part of the regular expression, + // if any, and the remainder. + return index != 0 ? + (StringMatcher)new FixedStringMatcher(regularExpression.substring(0, index), nextMatcher) : + (StringMatcher)nextMatcher; + } + + + /** + * A main method for testing file name matching. + */ + public static void main(String[] args) + { + try + { + System.out.println("Regular expression ["+args[0]+"]"); + FileNameParser parser = new FileNameParser(); + StringMatcher matcher = parser.parse(args[0]); + for (int index = 1; index < args.length; index++) + { + String string = args[index]; + System.out.print("String ["+string+"]"); + System.out.println(" -> match = "+matcher.matches(args[index])); + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/util/FixedStringMatcher.java b/src/proguard/util/FixedStringMatcher.java new file mode 100644 index 0000000..c1eb3f4 --- /dev/null +++ b/src/proguard/util/FixedStringMatcher.java @@ -0,0 +1,56 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings start with a given fixed string + * and then match another optional given StringMatcher. + * + * @author Eric Lafortune + */ +public class FixedStringMatcher implements StringMatcher +{ + private final String fixedString; + private final StringMatcher nextMatcher; + + + public FixedStringMatcher(String fixedString) + { + this(fixedString, null); + } + + + public FixedStringMatcher(String fixedString, StringMatcher nextMatcher) + { + this.fixedString = fixedString; + this.nextMatcher = nextMatcher; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return string.startsWith(fixedString) && + (nextMatcher == null || + nextMatcher.matches(string.substring(fixedString.length()))); + } +} diff --git a/src/proguard/util/ListMatcher.java b/src/proguard/util/ListMatcher.java new file mode 100644 index 0000000..b2559c8 --- /dev/null +++ b/src/proguard/util/ListMatcher.java @@ -0,0 +1,69 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings match a given list of StringMatcher + * instances. The instances are considered sequentially. Each instance in the + * list can optionally be negated, meaning that a match makes the entire + * remaining match fail. + * + * @author Eric Lafortune + */ +public class ListMatcher implements StringMatcher +{ + private final StringMatcher[] matchers; + private final boolean[] negate; + + + public ListMatcher(StringMatcher[] matchers) + { + this(matchers, null); + } + + + public ListMatcher(StringMatcher[] matchers, boolean[] negate) + { + this.matchers = matchers; + this.negate = negate; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + // Check the list of matchers. + for (int index = 0; index < matchers.length; index++) + { + StringMatcher matcher = matchers[index]; + if (matcher.matches(string)) + { + return negate == null || + !negate[index]; + } + } + + return negate != null && + negate[negate.length - 1]; + + } +} diff --git a/src/proguard/util/ListParser.java b/src/proguard/util/ListParser.java new file mode 100644 index 0000000..cec803b --- /dev/null +++ b/src/proguard/util/ListParser.java @@ -0,0 +1,137 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +import java.util.List; + +/** + * This StringParser can create StringMatcher instances for regular expressions. + * The regular expressions are either presented as a list, or they are + * interpreted as comma-separated lists, optionally prefixed with '!' negators. + * If an entry with a negator matches, a negative match is returned, without + * considering any subsequent entries in the list. The creation of StringMatcher + * instances for the entries is delegated to the given StringParser. + * + * @author Eric Lafortune + */ +public class ListParser implements StringParser +{ + private final StringParser stringParser; + + + /** + * Creates a new ListParser that parses individual elements in the + * comma-separated list with the given StringParser. + */ + public ListParser(StringParser stringParser) + { + this.stringParser = stringParser; + } + + + // Implementations for StringParser. + + public StringMatcher parse(String regularExpression) + { + // Does the regular expression contain a ',' list separator? + return parse(ListUtil.commaSeparatedList(regularExpression)); + } + + + /** + * Creates a StringMatcher for the given regular expression, which can + * be a list of optionally negated simple entries. + *

    + * An empty list results in a StringMatcher that matches any string. + */ + public StringMatcher parse(List regularExpressions) + { + StringMatcher listMatcher = null; + + // Loop over all simple regular expressions, backward, creating a + // linked list of matchers. + for (int index = regularExpressions.size()-1; index >=0; index--) + { + String regularExpression = (String)regularExpressions.get(index); + + StringMatcher entryMatcher = parseEntry(regularExpression); + + // Prepend the entry matcher. + listMatcher = + listMatcher == null ? + (StringMatcher)entryMatcher : + isNegated(regularExpression) ? + (StringMatcher)new AndMatcher(entryMatcher, listMatcher) : + (StringMatcher)new OrMatcher(entryMatcher, listMatcher); + } + + return listMatcher != null ? listMatcher : new ConstantMatcher(true); + } + + + // Small utility methods. + + /** + * Creates a StringMatcher for the given regular expression, which is a + * an optionally negated simple expression. + */ + private StringMatcher parseEntry(String regularExpression) + { + // Wrap the matcher if the regular expression starts with a '!' negator. + return isNegated(regularExpression) ? + new NotMatcher(stringParser.parse(regularExpression.substring(1))) : + stringParser.parse(regularExpression); + } + + + /** + * Returns whether the given simple regular expression is negated. + */ + private boolean isNegated(String regularExpression) + { + return regularExpression.length() > 0 && + regularExpression.charAt(0) == '!'; + } + + + /** + * A main method for testing name matching. + */ + public static void main(String[] args) + { + try + { + System.out.println("Regular expression ["+args[0]+"]"); + ListParser parser = new ListParser(new NameParser()); + StringMatcher matcher = parser.parse(args[0]); + for (int index = 1; index < args.length; index++) + { + String string = args[index]; + System.out.print("String ["+string+"]"); + System.out.println(" -> match = "+matcher.matches(args[index])); + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/util/ListUtil.java b/src/proguard/util/ListUtil.java new file mode 100644 index 0000000..570dbe8 --- /dev/null +++ b/src/proguard/util/ListUtil.java @@ -0,0 +1,173 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +import java.util.*; + + +/** + * This class provides some utility methods for working with + * java.util.List objects. + * + * @author Eric Lafortune + */ +public class ListUtil +{ + /** + * Creates a comma-separated String from the given List of String objects. + */ + public static String commaSeparatedString(List list) + { + if (list == null) + { + return null; + } + + StringBuffer buffer = new StringBuffer(); + + for (int index = 0; index < list.size(); index++) + { + if (index > 0) + { + buffer.append(','); + } + + buffer.append(quotedString((String)list.get(index))); + } + + return buffer.toString(); + } + + + /** + * Creates a List of String objects from the given comma-separated String. + */ + public static List commaSeparatedList(String string) + { + if (string == null) + { + return null; + } + + List list = new ArrayList(); + int index = 0; + while ((index = skipWhitespace(string, index)) < string.length()) + { + int nextIndex; + + // Do we have an opening quote? + if (string.charAt(index) == '\'') + { + // Parse a quoted string. + nextIndex = string.indexOf('\'', index + 1); + if (nextIndex < 0) + { + nextIndex = string.length(); + } + + list.add(string.substring(index + 1, nextIndex)); + } + else + { + // Parse a non-quoted string. + nextIndex = string.indexOf(',', index); + if (nextIndex < 0) + { + nextIndex = string.length(); + } + + String substring = string.substring(index, nextIndex).trim(); + if (substring.length() > 0) + { + list.add(substring); + } + } + + index = nextIndex + 1; + } + + return list; + } + + + /** + * Skips any whitespace characters. + */ + private static int skipWhitespace(String string, int index) + { + while (index < string.length() && + Character.isWhitespace(string.charAt(index))) + { + index++; + } + return index; + } + + + /** + * Returns a quoted version of the given string, if necessary. + */ + private static String quotedString(String string) + { + return string.length() == 0 || + string.indexOf(' ') >= 0 || + string.indexOf('@') >= 0 || + string.indexOf('{') >= 0 || + string.indexOf('}') >= 0 || + string.indexOf('(') >= 0 || + string.indexOf(')') >= 0 || + string.indexOf(':') >= 0 || + string.indexOf(';') >= 0 || + string.indexOf(',') >= 0 ? ("'" + string + "'") : + ( string ); + } + + + public static void main(String[] args) + { + if (args.length == 1) + { + System.out.println("Input string: ["+args[0]+"]"); + + List list = commaSeparatedList(args[0]); + + System.out.println("Resulting list:"); + for (int index = 0; index < list.size(); index++) + { + System.out.println("["+list.get(index)+"]"); + } + } + else + { + List list = Arrays.asList(args); + + System.out.println("Input list:"); + for (int index = 0; index < list.size(); index++) + { + System.out.println("["+list.get(index)+"]"); + } + + String string = commaSeparatedString(list); + + System.out.println("Resulting string: ["+string+"]"); + } + } +} diff --git a/src/proguard/util/NameParser.java b/src/proguard/util/NameParser.java new file mode 100644 index 0000000..e311fbf --- /dev/null +++ b/src/proguard/util/NameParser.java @@ -0,0 +1,106 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringParser can create StringMatcher instances for regular expressions + * matching names. The regular expressions are interpreted as comma-separated + * lists of names, optionally prefixed with '!' negators. + * If a name with a negator matches, a negative match is returned, without + * considering any subsequent entries in the list. + * Names can contain the following wildcards: + * '?' for a single character, and + * '*' for any number of characters. + * + * @author Eric Lafortune + */ +public class NameParser implements StringParser +{ + // Implementations for StringParser. + + public StringMatcher parse(String regularExpression) + { + int index; + StringMatcher nextMatcher = new EmptyStringMatcher(); + + // Look for wildcards. + for (index = 0; index < regularExpression.length(); index++) + { + // Is there a '*' wildcard? + if (regularExpression.charAt(index) == '*') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + null, + 0, + Integer.MAX_VALUE, + parse(regularExpression.substring(index + 1))); + break; + } + + // Is there a '?' wildcard? + else if (regularExpression.charAt(index) == '?') + { + // Create a matcher for the wildcard and, recursively, for the + // remainder of the string. + nextMatcher = + new VariableStringMatcher(null, + null, + 1, + 1, + parse(regularExpression.substring(index + 1))); + break; + } + } + + // Return a matcher for the fixed first part of the regular expression, + // if any, and the remainder. + return index != 0 ? + (StringMatcher)new FixedStringMatcher(regularExpression.substring(0, index), nextMatcher) : + (StringMatcher)nextMatcher; + } + + + /** + * A main method for testing name matching. + */ + public static void main(String[] args) + { + try + { + System.out.println("Regular expression ["+args[0]+"]"); + NameParser parser = new NameParser(); + StringMatcher matcher = parser.parse(args[0]); + for (int index = 1; index < args.length; index++) + { + String string = args[index]; + System.out.print("String ["+string+"]"); + System.out.println(" -> match = "+matcher.matches(args[index])); + } + } + catch (Exception ex) + { + ex.printStackTrace(); + } + } +} diff --git a/src/proguard/util/NotMatcher.java b/src/proguard/util/NotMatcher.java new file mode 100644 index 0000000..f2a9a51 --- /dev/null +++ b/src/proguard/util/NotMatcher.java @@ -0,0 +1,46 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings does not match the given + * StringMatcher. + * + * @author Eric Lafortune + */ +public class NotMatcher implements StringMatcher +{ + private final StringMatcher matcher; + + + public NotMatcher(StringMatcher matcher) + { + this.matcher = matcher; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return !matcher.matches(string); + } +} diff --git a/src/proguard/util/OrMatcher.java b/src/proguard/util/OrMatcher.java new file mode 100644 index 0000000..097c6c6 --- /dev/null +++ b/src/proguard/util/OrMatcher.java @@ -0,0 +1,49 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings matches either of the given + * StringMatcher instances. + * + * @author Eric Lafortune + */ +public class OrMatcher implements StringMatcher +{ + private final StringMatcher matcher1; + private final StringMatcher matcher2; + + + public OrMatcher(StringMatcher matcher1, StringMatcher matcher2) + { + this.matcher1 = matcher1; + this.matcher2 = matcher2; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return matcher1.matches(string) || + matcher2.matches(string); + } +} diff --git a/src/proguard/util/SettableMatcher.java b/src/proguard/util/SettableMatcher.java new file mode 100644 index 0000000..9557f62 --- /dev/null +++ b/src/proguard/util/SettableMatcher.java @@ -0,0 +1,46 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher delegates to a another StringMatcher that can be set + * after this StringMatcher has been constructed. + * + * @author Eric Lafortune + */ +public class SettableMatcher implements StringMatcher +{ + private StringMatcher matcher; + + + public void setMatcher(StringMatcher matcher) + { + this.matcher = matcher; + } + + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + return matcher.matches(string); + } +} diff --git a/src/proguard/util/StringMatcher.java b/src/proguard/util/StringMatcher.java new file mode 100644 index 0000000..bd66dcc --- /dev/null +++ b/src/proguard/util/StringMatcher.java @@ -0,0 +1,38 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + + +/** + * This interface provides a method to determine whether strings match a given + * criterion, which is specified by the implementation. + * + * @author Eric Lafortune + */ +public interface StringMatcher +{ + /** + * Checks whether the given string matches. + * @param string the string to match. + * @return a boolean indicating whether the string matches the criterion. + */ + public boolean matches(String string); +} diff --git a/src/proguard/util/StringParser.java b/src/proguard/util/StringParser.java new file mode 100644 index 0000000..29f4f16 --- /dev/null +++ b/src/proguard/util/StringParser.java @@ -0,0 +1,35 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This interface provides a method to create a SringMatcher for a given + * regular expression. + * + * @author Eric Lafortune + */ +public interface StringParser +{ + /** + * Creates a StringMatcher for the given regular expression. + */ + public StringMatcher parse(String regularExpression); +} diff --git a/src/proguard/util/VariableStringMatcher.java b/src/proguard/util/VariableStringMatcher.java new file mode 100644 index 0000000..1e41323 --- /dev/null +++ b/src/proguard/util/VariableStringMatcher.java @@ -0,0 +1,126 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.util; + +/** + * This StringMatcher tests whether strings start with a specified variable + * string and then match another given StringMatcher. + * + * @author Eric Lafortune + */ +public class VariableStringMatcher implements StringMatcher +{ + private final char[] allowedCharacters; + private final char[] disallowedCharacters; + private final int minimumLength; + private final int maximumLength; + private final StringMatcher nextMatcher; + + + public VariableStringMatcher(char[] allowedCharacters, + char[] disallowedCharacters, + int minimumLength, + int maximumLength, + StringMatcher nextMatcher) + { + this.allowedCharacters = allowedCharacters; + this.disallowedCharacters = disallowedCharacters; + this.minimumLength = minimumLength; + this.maximumLength = maximumLength; + this.nextMatcher = nextMatcher; + } + + // Implementations for StringMatcher. + + public boolean matches(String string) + { + if (string.length() < minimumLength) + { + return false; + } + + // Check the first minimum number of characters. + for (int index = 0; index < minimumLength; index++) + { + if (!isAllowedCharacter(string.charAt(index))) + { + return false; + } + } + + int maximumLength = Math.min(this.maximumLength, string.length()); + + // Check the remaining characters, up to the maximum number. + for (int index = minimumLength; index < maximumLength; index++) + { + if (nextMatcher.matches(string.substring(index))) + { + return true; + } + + if (!isAllowedCharacter(string.charAt(index))) + { + return false; + } + } + + // Check the remaining characters in the string. + return nextMatcher.matches(string.substring(maximumLength)); + } + + + // Small utility methods. + + /** + * Returns whether the given character is allowed in the variable string. + */ + private boolean isAllowedCharacter(char character) + { + // Check the allowed characters. + if (allowedCharacters != null) + { + for (int index = 0; index < allowedCharacters.length; index++) + { + if (allowedCharacters[index] == character) + { + return true; + } + } + + return false; + } + + // Check the disallowed characters. + if (disallowedCharacters != null) + { + for (int index = 0; index < disallowedCharacters.length; index++) + { + if (disallowedCharacters[index] == character) + { + return false; + } + } + } + + // Any remaining character is allowed. + return true; + } +} diff --git a/src/proguard/util/package.html b/src/proguard/util/package.html new file mode 100644 index 0000000..cb14fdc --- /dev/null +++ b/src/proguard/util/package.html @@ -0,0 +1,3 @@ + +This package contains utility classes for regular expression matching,... + diff --git a/src/proguard/wtk/ProGuardObfuscator.java b/src/proguard/wtk/ProGuardObfuscator.java new file mode 100644 index 0000000..4618437 --- /dev/null +++ b/src/proguard/wtk/ProGuardObfuscator.java @@ -0,0 +1,141 @@ +/* + * ProGuard -- shrinking, optimization, obfuscation, and preverification + * of Java bytecode. + * + * Copyright (c) 2002-2009 Eric Lafortune (eric@graphics.cornell.edu) + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License as published by the Free + * Software Foundation; either version 2 of the License, or (at your option) + * any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program; if not, write to the Free Software Foundation, Inc., + * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + */ +package proguard.wtk; + +import com.sun.kvem.environment.Obfuscator; +import proguard.*; + +import java.io.*; + + +/** + * ProGuard plug-in for the J2ME Wireless Toolkit. + *

    + * In order to integrate this plug-in in the toolkit, you'll have to put the + * following lines in the file + * {j2mewtk.dir}/wtklib/Linux/ktools.properties or + * {j2mewtk.dir}\wtklib\Windows\ktools.properties (whichever is + * applicable). + *

    + * 

    + * obfuscator.runner.class.name: proguard.wtk.ProGuardObfuscator
+ * obfuscator.runner.classpath: /usr/local/java/proguard1.6/lib/proguard.jar
+ *
    + * Please make sure the class path is set correctly for your system. + * + * @author Eric Lafortune + */ +public class ProGuardObfuscator implements Obfuscator +{ + private static final String DEFAULT_CONFIGURATION = "default.pro"; + + + // Implementations for Obfuscator. + + public void createScriptFile(File jadFile, + File projectDir) + { + // We don't really need to create a script file; + // we'll just fill out all options in the run method. + } + + + public void run(File obfuscatedJarFile, + String wtkBinDir, + String wtkLibDir, + String jarFileName, + String projectDirName, + String classPath, + String emptyAPI) + throws IOException + { + // Create the ProGuard configuration. + Configuration configuration = new Configuration(); + + // Parse the default configuration file. + ConfigurationParser parser = new ConfigurationParser(this.getClass().getResource(DEFAULT_CONFIGURATION)); + + try + { + parser.parse(configuration); + + // Fill out the library class path. + configuration.libraryJars = classPath(classPath); + + // Fill out the program class path (input and output). + configuration.programJars = new ClassPath(); + configuration.programJars.add(new ClassPathEntry(new File(jarFileName), false)); + configuration.programJars.add(new ClassPathEntry(obfuscatedJarFile, true)); + + // The preverify tool seems to unpack the resulting classes, + // so we must not use mixed-case class names on Windows. + configuration.useMixedCaseClassNames = + !System.getProperty("os.name").regionMatches(true, 0, "windows", 0, 7); + + // Run ProGuard with these options. + ProGuard proGuard = new ProGuard(configuration); + proGuard.execute(); + + } + catch (ParseException ex) + { + throw new IOException(ex.getMessage()); + } + finally + { + parser.close(); + } + } + + + /** + * Converts the given class path String into a ClassPath object. + */ + private ClassPath classPath(String classPathString) + { + ClassPath classPath = new ClassPath(); + + String separator = System.getProperty("path.separator"); + + int index = 0; + while (index < classPathString.length()) + { + // Find the next separator, or the end of the String. + int next_index = classPathString.indexOf(separator, index); + if (next_index < 0) + { + next_index = classPathString.length(); + } + + // Create and add the found class path entry. + ClassPathEntry classPathEntry = + new ClassPathEntry(new File(classPathString.substring(index, next_index)), + false); + + classPath.add(classPathEntry); + + // Continue after the separator. + index = next_index + 1; + } + + return classPath; + } +} diff --git a/src/proguard/wtk/default.pro b/src/proguard/wtk/default.pro new file mode 100644 index 0000000..d31714f --- /dev/null +++ b/src/proguard/wtk/default.pro @@ -0,0 +1,114 @@ +-dontnote +-microedition +-mergeinterfacesaggressively +-overloadaggressively +-repackageclasses '' +-allowaccessmodification + +# Keep all extensions of javax.microedition.midlet.MIDlet. +-keep public class * extends javax.microedition.midlet.MIDlet + +# Keep all native class/method names. +-keepclasseswithmembernames class * { + native ; +} + +# Remove all invocations of System methods without side effects +# whose return values are not used. +-assumenosideeffects public class java.lang.System { + public static native long currentTimeMillis(); + static java.lang.Class getCallerClass(); + public static native int identityHashCode(java.lang.Object); + public static java.lang.SecurityManager getSecurityManager(); + public static java.util.Properties getProperties(); + public static java.lang.String getProperty(java.lang.String); + public static java.lang.String getenv(java.lang.String); + public static native java.lang.String mapLibraryName(java.lang.String); + public static java.lang.String getProperty(java.lang.String,java.lang.String); +} + +# Remove all invocations of String methods without side effects +# whose return values are not used. +-assumenosideeffects public class java.lang.String { + public java.lang.String(); + public java.lang.String(byte[]); + public java.lang.String(byte[],int); + public java.lang.String(byte[],int,int); + public java.lang.String(byte[],int,int,int); + public java.lang.String(byte[],int,int,java.lang.String); + public java.lang.String(byte[],java.lang.String); + public java.lang.String(char[]); + public java.lang.String(char[],int,int); + public java.lang.String(java.lang.String); + public java.lang.String(java.lang.StringBuffer); + public static java.lang.String copyValueOf(char[]); + public static java.lang.String copyValueOf(char[],int,int); + public static java.lang.String valueOf(boolean); + public static java.lang.String valueOf(char); + public static java.lang.String valueOf(char[]); + public static java.lang.String valueOf(char[],int,int); + public static java.lang.String valueOf(double); + public static java.lang.String valueOf(float); + public static java.lang.String valueOf(int); + public static java.lang.String valueOf(java.lang.Object); + public static java.lang.String valueOf(long); + public boolean contentEquals(java.lang.StringBuffer); + public boolean endsWith(java.lang.String); + public boolean equalsIgnoreCase(java.lang.String); + public boolean equals(java.lang.Object); + public boolean matches(java.lang.String); + public boolean regionMatches(boolean,int,java.lang.String,int,int); + public boolean regionMatches(int,java.lang.String,int,int); + public boolean startsWith(java.lang.String); + public boolean startsWith(java.lang.String,int); + public byte[] getBytes(); + public byte[] getBytes(java.lang.String); + public char charAt(int); + public char[] toCharArray(); + public int compareToIgnoreCase(java.lang.String); + public int compareTo(java.lang.Object); + public int compareTo(java.lang.String); + public int hashCode(); + public int indexOf(int); + public int indexOf(int,int); + public int indexOf(java.lang.String); + public int indexOf(java.lang.String,int); + public int lastIndexOf(int); + public int lastIndexOf(int,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.CharSequence subSequence(int,int); + public java.lang.String concat(java.lang.String); + public java.lang.String replaceAll(java.lang.String,java.lang.String); + public java.lang.String replace(char,char); + public java.lang.String replaceFirst(java.lang.String,java.lang.String); + public java.lang.String[] split(java.lang.String); + public java.lang.String[] split(java.lang.String,int); + public java.lang.String substring(int); + public java.lang.String substring(int,int); + public java.lang.String toLowerCase(); + public java.lang.String toLowerCase(java.util.Locale); + public java.lang.String toString(); + public java.lang.String toUpperCase(); + public java.lang.String toUpperCase(java.util.Locale); + public java.lang.String trim(); +} + + +# Remove all invocations of StringBuffer methods without side effects +# whose return values are not used. +-assumenosideeffects public class java.lang.StringBuffer { + public java.lang.StringBuffer(); + public java.lang.StringBuffer(int); + public java.lang.StringBuffer(java.lang.String); + public java.lang.String toString(); + public char charAt(int); + public int capacity(); + public int indexOf(java.lang.String,int); + public int lastIndexOf(java.lang.String); + public int lastIndexOf(java.lang.String,int); + public int length(); + public java.lang.String substring(int); + public java.lang.String substring(int,int); +} diff --git a/src/proguard/wtk/package.html b/src/proguard/wtk/package.html new file mode 100644 index 0000000..6efc644 --- /dev/null +++ b/src/proguard/wtk/package.html @@ -0,0 +1,3 @@ + +This package contains the J2ME Wireless Toolkit plug-in for ProGuard. + -- GitLab