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.dex.file;
18579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson
19579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.rop.cst.CstType;
20579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson
21579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson/**
22579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Representation of a reference to an item inside a Dalvik file.
23579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */
24579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonpublic abstract class IdItem extends IndexedItem {
25579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    /**
26579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * {@code non-null;} the type constant for the defining class of
27579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * the reference
28579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     */
29579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    private final CstType type;
30579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson
31579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    /**
32579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * Constructs an instance.
33579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     *
34579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * @param type {@code non-null;} the type constant for the defining
35579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * class of the reference
36579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     */
37579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    public IdItem(CstType type) {
38579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson        if (type == null) {
39579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson            throw new NullPointerException("type == null");
40579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson        }
41579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson
42579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson        this.type = type;
43579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    }
44579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson
45579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    /** {@inheritDoc} */
46579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    @Override
47579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    public void addContents(DexFile file) {
48579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson        TypeIdsSection typeIds = file.getTypeIds();
49579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson        typeIds.intern(type);
50579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    }
51579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson
52579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    /**
53579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * Gets the type constant for the defining class of the
54579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * reference.
55579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     *
56579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     * @return {@code non-null;} the type constant
57579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson     */
58579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    public final CstType getDefiningClass() {
59579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson        return type;
60579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson    }
61579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson}
62