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.code.form; 18579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 19579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.dex.code.DalvInsn; 20579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.dex.code.InsnFormat; 21579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonimport com.android.dx.util.AnnotatedOutput; 22579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 23579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson/** 24579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Instruction format for nonstandard format instructions, which aren't 25579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * generally real instructions but do end up appearing in instruction 26579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * lists. Most of the overridden methods on this class end up throwing 27579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * exceptions, as code should know (implicitly or explicitly) to avoid 28579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * using this class. The one exception is {@link #isCompatible}, which 29579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * always returns {@code true}. 30579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 31579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilsonpublic final class SpecialFormat extends InsnFormat { 32579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@code non-null;} unique instance of this class */ 33579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public static final InsnFormat THE_ONE = new SpecialFormat(); 34579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 35579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** 36579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * Constructs an instance. This class is not publicly 37579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson * instantiable. Use {@link #THE_ONE}. 38579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson */ 39579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson private SpecialFormat() { 40579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson // This space intentionally left blank. 41579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 42579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 43579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 44579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 45579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public String insnArgString(DalvInsn insn) { 46579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson throw new RuntimeException("unsupported"); 47579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 48579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 49579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 50579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 51579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public String insnCommentString(DalvInsn insn, boolean noteIndices) { 52579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson throw new RuntimeException("unsupported"); 53579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 54579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 55579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 56579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 57579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public int codeSize() { 58579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson throw new RuntimeException("unsupported"); 59579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 60579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 61579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 62579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 63579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public boolean isCompatible(DalvInsn insn) { 64579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson return true; 65579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 66579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson 67579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson /** {@inheritDoc} */ 68579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson @Override 69579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson public void writeTo(AnnotatedOutput out, DalvInsn insn) { 70579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson throw new RuntimeException("unsupported"); 71579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson } 72579d7739c53a2707ad711a2d2cae46d7d782f06Jesse Wilson} 73