1 /* 2 * Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package com.sun.source.tree; 27 28 import java.util.List; 29 30 /** 31 * A tree node for a {@code try} statement. 32 * 33 * For example: 34 * <pre> 35 * try 36 * <em>block</em> 37 * <em>catches</em> 38 * finally 39 * <em>finallyBlock</em> 40 * </pre> 41 * 42 * @jls section 14.20 43 * 44 * @author Peter von der Ahé 45 * @author Jonathan Gibbons 46 * @since 1.6 47 */ 48 @jdk.Exported 49 public interface TryTree extends StatementTree { 50 /** 51 * Returns the block of the {@code try} statement. 52 * @return the block 53 */ 54 BlockTree getBlock(); 55 56 /** 57 * Returns any catch blocks provided in the {@code try} statement. 58 * The result will be an empty list if there are no 59 * catch blocks. 60 * @return the catch blocks 61 */ 62 List<? extends CatchTree> getCatches(); 63 64 /** 65 * Returns the finally block provided in the {@code try} statement, 66 * or {@code null} if there is none. 67 * @return the finally block 68 */ 69 BlockTree getFinallyBlock(); 70 71 72 /** 73 * Returns any resource declarations provided in the {@code try} statement. 74 * The result will be an empty list if there are no 75 * resource declarations. 76 * @return the resource declarations 77 */ 78 List<? extends Tree> getResources(); 79 }