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.attrib; 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.rop.annotation.Annotations; 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectimport com.android.dx.util.MutabilityException; 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Base class for annotations attributes. 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic abstract class BaseAnnotations extends BaseAttribute { 2699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code non-null;} list of annotations */ 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final Annotations annotations; 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 2999409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project /** {@code >= 0;} attribute data length in the original classfile (not 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * including the attribute header) */ 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project private final int byteLength; 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Constructs an instance. 35de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 3699409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param attributeName {@code non-null;} the name of the attribute 3799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param annotations {@code non-null;} the list of annotations 3899409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @param byteLength {@code >= 0;} attribute data length in the original 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * classfile (not including the attribute header) 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public BaseAnnotations(String attributeName, Annotations annotations, 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project int byteLength) { 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project super(attributeName); 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project try { 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project if (annotations.isMutable()) { 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new MutabilityException("annotations.isMutable()"); 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } catch (NullPointerException ex) { 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // Translate the exception. 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project throw new NullPointerException("annotations == null"); 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 54f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.annotations = annotations; 55f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project this.byteLength = byteLength; 56f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 57f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 58f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** {@inheritDoc} */ 59f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public final int byteLength() { 60f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project // Add six for the standard attribute header. 61f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return byteLength + 6; 62f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 63f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 64f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 65f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Gets the list of annotations associated with this instance. 66de75089fb7216d19e9c22cce4dc62a49513477d3Carl Shapiro * 6799409883d9c4c0ffb49b070ce307bb33a9dfe9f1The Android Open Source Project * @return {@code non-null;} the list 68f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 69f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public final Annotations getAnnotations() { 70f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project return annotations; 71f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project } 72f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 73