1579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson/* 2579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Copyright (C) 2007 The Android Open Source Project 3579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 4579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Licensed under the Apache License, Version 2.0 (the "License"); 5579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * you may not use this file except in compliance with the License. 6579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * You may obtain a copy of the License at 7579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 8579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 9579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 10579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Unless required by applicable law or agreed to in writing, software 11579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 12579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * See the License for the specific language governing permissions and 14579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * limitations under the License. 15579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 16579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 17579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonpackage com.android.dx.rop.annotation; 18579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 19579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.util.FixedSizeList; 20579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 21579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson/** 22579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * List of {@link Annotations} instances. 23579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 24579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonpublic final class AnnotationsList 25579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson extends FixedSizeList { 26579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@code non-null;} immutable empty instance */ 27579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public static final AnnotationsList EMPTY = new AnnotationsList(0); 28579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 29579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** 30579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Constructs an immutable instance which is the combination of 31579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * the two given instances. The two instances must each have the 32579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * same number of elements, and each pair of elements must contain 33579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * disjoint sets of types. 34579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 35579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param list1 {@code non-null;} an instance 36579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param list2 {@code non-null;} the other instance 37579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @return {@code non-null;} the combination 38579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 39579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public static AnnotationsList combine(AnnotationsList list1, 40579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson AnnotationsList list2) { 41579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson int size = list1.size(); 42579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 43579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson if (size != list2.size()) { 44579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson throw new IllegalArgumentException("list1.size() != list2.size()"); 45579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 46579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 47579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson AnnotationsList result = new AnnotationsList(size); 48579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 49579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson for (int i = 0; i < size; i++) { 50579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson Annotations a1 = list1.get(i); 51579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson Annotations a2 = list2.get(i); 52579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson result.set(i, Annotations.combine(a1, a2)); 53579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 54579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 55579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson result.setImmutable(); 56579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson return result; 57579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 58579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 59579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** 60579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Constructs an instance. All indices initially contain {@code null}. 61579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 62579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param size the size of the list 63579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 64579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public AnnotationsList(int size) { 65579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson super(size); 66579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 67579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 68579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** 69579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Gets the element at the given index. It is an error to call 70579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * this with the index for an element which was never set; if you 71579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * do that, this will throw {@code NullPointerException}. 72579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 73579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param n {@code >= 0, < size();} which index 74579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @return {@code non-null;} element at that index 75579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 76579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public Annotations get(int n) { 77579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson return (Annotations) get0(n); 78579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 79579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 80579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** 81579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Sets the element at the given index. The given element must be 82579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * immutable. 83579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * 84579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param n {@code >= 0, < size();} which index 85579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * @param a {@code null-ok;} the element to set at {@code n} 86579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 87579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public void set(int n, Annotations a) { 88579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson a.throwIfMutable(); 89579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson set0(n, a); 90579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 91579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson} 92