1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * you may not use this file except in compliance with the License. 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * You may obtain a copy of the License at 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See the License for the specific language governing permissions and 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * limitations under the License. 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage com.android.dx.cf.code; 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.util.Hex; 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.util.IntList; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.util.LabeledItem; 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Representation of a basic block in a bytecode array. 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic final class ByteBlock implements LabeledItem { 2799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code >= 0;} label for this block */ 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final int label; 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 3099409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code >= 0;} bytecode offset (inclusive) of the start of the block */ 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final int start; 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 3399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code > start;} bytecode offset (exclusive) of the end of the block */ 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final int end; 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 3699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code non-null;} list of successors that this block may branch to */ 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final IntList successors; 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 3999409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code non-null;} list of exceptions caught and their handler targets */ 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final ByteCatchList catches; 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 43de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * Constructs an instance. 44de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 4599409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param label {@code >= 0;} target label for this block 4699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param start {@code >= 0;} bytecode offset (inclusive) of the start 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * of the block 4899409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param end {@code > start;} bytecode offset (exclusive) of the end 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * of the block 5099409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param successors {@code non-null;} list of successors that this block may 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * branch to 5299409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param catches {@code non-null;} list of exceptions caught and their 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * handler targets 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public ByteBlock(int label, int start, int end, IntList successors, 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project ByteCatchList catches) { 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (label < 0) { 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException("label < 0"); 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (start < 0) { 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException("start < 0"); 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (end <= start) { 66f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException("end <= start"); 67f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (successors == null) { 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException("targets == null"); 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 73f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project int sz = successors.size(); 74f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project for (int i = 0; i < sz; i++) { 75f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (successors.get(i) < 0) { 76f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new IllegalArgumentException("successors[" + i + 77f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project "] == " + 78f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project successors.get(i)); 79f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 80f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 81f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 82f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (catches == null) { 83f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException("catches == null"); 84f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 85f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 86f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.label = label; 87f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.start = start; 88f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.end = end; 89f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.successors = successors; 90f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.catches = catches; 91f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 92f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 93f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 94f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project @Override 95f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public String toString() { 96f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return '{' + Hex.u2(label) + ": " + Hex.u2(start) + ".." + 97f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project Hex.u2(end) + '}'; 98f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 99f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 100f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 101f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the label of this block. 102de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 10399409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code >= 0;} the label 104f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 105f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getLabel() { 106f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return label; 107f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 108f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 109f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 110f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the bytecode offset (inclusive) of the start of this block. 111de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 11299409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code >= 0;} the start offset 113f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 114f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getStart() { 115f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return start; 116f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 117f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 118f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 119f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the bytecode offset (exclusive) of the end of this block. 120de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 12199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code > getStart();} the end offset 122f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 123f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getEnd() { 124f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return end; 125f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 126f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 127f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 128de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * Gets the list of successors that this block may branch to 129f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * non-exceptionally. 130de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 13199409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code non-null;} the successor list 132f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 133f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public IntList getSuccessors() { 134f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return successors; 135f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 136f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 137f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 138f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the list of exceptions caught and their handler targets. 139de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 14099409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code non-null;} the catch list 141f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 142f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public ByteCatchList getCatches() { 143f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return catches; 144f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 145f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 146