1f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project/* Copyright (C) 2003 Vladimir Roubtsov. All rights reserved. 2f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 3f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * This program and the accompanying materials are made available under 4f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * the terms of the Common Public License v1.0 which accompanies this distribution, 5f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * and is available at http://www.eclipse.org/legal/cpl-v10.html 6f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 7f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * $Id: IExceptionHandlerTable.java,v 1.1.1.1 2004/05/09 16:57:48 vlad_r Exp $ 8f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 9f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Projectpackage com.vladium.jcd.cls.attribute; 10f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 11f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Projectimport com.vladium.jcd.compiler.IClassFormatOutput; 12f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 13f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project// ---------------------------------------------------------------------------- 14f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project/** 15f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * This table is a structure nested within the {@link CodeAttribute_info}. 16f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * It is a table of {@link Exception_info} entries, each entry representing an 17f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * exception handler range. The order of these entries is the order in which 18f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * a JVM will check for a matching exception handler when the parent method 19f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * throws an exception. 20f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 21f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @author (C) 2001, Vlad Roubtsov 22f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 23f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Projectpublic 24f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Projectinterface IExceptionHandlerTable extends Cloneable, IClassFormatOutput 25f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project{ 26f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project // public: ................................................................ 27f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 28f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project // ACCESSORS: 29f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 30f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project /** 31f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * Returns {@link Exception_info} descriptor at a given offset. 32f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 33f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @param offset exception offset [must be in [0, size()) range; input not checked] 34f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @return Exception_info descriptor [never null] 35f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 36f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @throws IndexOutOfBoundsException if 'offset' is outside of valid range 37f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 38f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project Exception_info get (int offset); 39f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 40f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project /** 41f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * Returns the number of descriptors in this collection [can be 0]. 42f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 43f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project int size (); 44f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 45f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project /** 46f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * Returns the total length of this table when converted to 47f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * .class format [including 2 count bytes] 48f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 49f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project long length (); 50f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 51f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project // Cloneable: adjust the access level of Object.clone(): 52f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project Object clone (); 53f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 54f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 55f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project // MUTATORS: 56f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 57f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project /** 58f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * Adds a new Exception_info descriptor to this collection. No duplicate 59f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * checks are made. It is the responsibility of the caller to ensure 60f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * that all data referenced in 'exception' will eventually be consistent 61f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * with method's bytecode and the class's constant pool. 62f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 63f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @param exception new exception descriptor [may not be null] 64f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 65f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project int add (Exception_info exception); 66f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 67f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project /** 68f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * Replaces the Exception_info descriptor at a given offset. No duplicate 69f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * checks are made. No exception type compatibility checks are made. It is 70f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * the responsibility of the caller to ensure that all data referenced 71f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * in 'exception' will eventually be consistent with method's bytecode and 72f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * the class's constant pool. 73f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 74f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @param offset exception offset [must be in [0, size()) range; input not checked] 75f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @param exception new exception descriptor [may not be null] 76f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @return previous exception descriptor at this offset [never null] 77f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * 78f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project * @throws IndexOutOfBoundsException if 'offset' is outside of valid range 79f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project */ 80f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project Exception_info set (int offset, Exception_info exception); 81f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project 82f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project} // end of interface 83f6fe897e173f4e4bda72a7dddb091b667066764aThe Android Open Source Project// ---------------------------------------------------------------------------- 84