001/***
002 * ASM: a very small and fast Java bytecode manipulation framework
003 * Copyright (c) 2000-2011 INRIA, France Telecom
004 * All rights reserved.
005 *
006 * Redistribution and use in source and binary forms, with or without
007 * modification, are permitted provided that the following conditions
008 * are met:
009 * 1. Redistributions of source code must retain the above copyright
010 *    notice, this list of conditions and the following disclaimer.
011 * 2. Redistributions in binary form must reproduce the above copyright
012 *    notice, this list of conditions and the following disclaimer in the
013 *    documentation and/or other materials provided with the distribution.
014 * 3. Neither the name of the copyright holders nor the names of its
015 *    contributors may be used to endorse or promote products derived from
016 *    this software without specific prior written permission.
017 *
018 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
019 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
020 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
021 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
022 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
023 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
024 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
025 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
026 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
027 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
028 * THE POSSIBILITY OF SUCH DAMAGE.
029 */
030package io.ebean.enhance.asm.tree;
031
032import io.ebean.enhance.asm.MethodVisitor;
033import io.ebean.enhance.asm.Opcodes;
034import io.ebean.enhance.asm.Type;
035
036import java.util.Map;
037
038/**
039 * A node that represents a method instruction. A method instruction is an
040 * instruction that invokes a method.
041 * 
042 * @author Eric Bruneton
043 */
044public class MethodInsnNode extends AbstractInsnNode {
045
046    /**
047     * The internal name of the method's owner class (see
048     * {@link Type#getInternalName() getInternalName}).
049     */
050    public String owner;
051
052    /**
053     * The method's name.
054     */
055    public String name;
056
057    /**
058     * The method's descriptor (see {@link Type}).
059     */
060    public String desc;
061
062    /**
063     * If the method's owner class if an interface.
064     */
065    public boolean itf;
066
067    /**
068     * Constructs a new {@link MethodInsnNode}.
069     * 
070     * @param opcode
071     *            the opcode of the type instruction to be constructed. This
072     *            opcode must be INVOKEVIRTUAL, INVOKESPECIAL, INVOKESTATIC or
073     *            INVOKEINTERFACE.
074     * @param owner
075     *            the internal name of the method's owner class (see
076     *            {@link Type#getInternalName()
077     *            getInternalName}).
078     * @param name
079     *            the method's name.
080     * @param desc
081     *            the method's descriptor (see {@link Type}).
082     */
083    @Deprecated
084    public MethodInsnNode(final int opcode, final String owner,
085            final String name, final String desc) {
086        this(opcode, owner, name, desc, opcode == Opcodes.INVOKEINTERFACE);
087    }
088
089    /**
090     * Constructs a new {@link MethodInsnNode}.
091     * 
092     * @param opcode
093     *            the opcode of the type instruction to be constructed. This
094     *            opcode must be INVOKEVIRTUAL, INVOKESPECIAL, INVOKESTATIC or
095     *            INVOKEINTERFACE.
096     * @param owner
097     *            the internal name of the method's owner class (see
098     *            {@link Type#getInternalName()
099     *            getInternalName}).
100     * @param name
101     *            the method's name.
102     * @param desc
103     *            the method's descriptor (see {@link Type}).
104     * @param itf
105     *            if the method's owner class is an interface.
106     */
107    public MethodInsnNode(final int opcode, final String owner,
108            final String name, final String desc, final boolean itf) {
109        super(opcode);
110        this.owner = owner;
111        this.name = name;
112        this.desc = desc;
113        this.itf = itf;
114    }
115
116    /**
117     * Sets the opcode of this instruction.
118     * 
119     * @param opcode
120     *            the new instruction opcode. This opcode must be INVOKEVIRTUAL,
121     *            INVOKESPECIAL, INVOKESTATIC or INVOKEINTERFACE.
122     */
123    public void setOpcode(final int opcode) {
124        this.opcode = opcode;
125    }
126
127    @Override
128    public int getType() {
129        return METHOD_INSN;
130    }
131
132    @Override
133    public void accept(final MethodVisitor mv) {
134        mv.visitMethodInsn(opcode, owner, name, desc, itf);
135        acceptAnnotations(mv);
136    }
137
138    @Override
139    public AbstractInsnNode clone(final Map<LabelNode, LabelNode> labels) {
140        return new MethodInsnNode(opcode, owner, name, desc, itf);
141    }
142}