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.Type;
034
035import java.util.Map;
036
037/**
038 * A node that represents a field instruction. A field instruction is an
039 * instruction that loads or stores the value of a field of an object.
040 * 
041 * @author Eric Bruneton
042 */
043public class FieldInsnNode extends AbstractInsnNode {
044
045    /**
046     * The internal name of the field's owner class (see
047     * {@link Type#getInternalName() getInternalName}).
048     */
049    public String owner;
050
051    /**
052     * The field's name.
053     */
054    public String name;
055
056    /**
057     * The field's descriptor (see {@link Type}).
058     */
059    public String desc;
060
061    /**
062     * Constructs a new {@link FieldInsnNode}.
063     * 
064     * @param opcode
065     *            the opcode of the type instruction to be constructed. This
066     *            opcode must be GETSTATIC, PUTSTATIC, GETFIELD or PUTFIELD.
067     * @param owner
068     *            the internal name of the field's owner class (see
069     *            {@link Type#getInternalName()
070     *            getInternalName}).
071     * @param name
072     *            the field's name.
073     * @param desc
074     *            the field's descriptor (see {@link Type}).
075     */
076    public FieldInsnNode(final int opcode, final String owner,
077            final String name, final String desc) {
078        super(opcode);
079        this.owner = owner;
080        this.name = name;
081        this.desc = desc;
082    }
083
084    /**
085     * Sets the opcode of this instruction.
086     * 
087     * @param opcode
088     *            the new instruction opcode. This opcode must be GETSTATIC,
089     *            PUTSTATIC, GETFIELD or PUTFIELD.
090     */
091    public void setOpcode(final int opcode) {
092        this.opcode = opcode;
093    }
094
095    @Override
096    public int getType() {
097        return FIELD_INSN;
098    }
099
100    @Override
101    public void accept(final MethodVisitor mv) {
102        mv.visitFieldInsn(opcode, owner, name, desc);
103        acceptAnnotations(mv);
104    }
105
106    @Override
107    public AbstractInsnNode clone(final Map<LabelNode, LabelNode> labels) {
108        return new FieldInsnNode(opcode, owner, name, desc)
109                .cloneAnnotations(this);
110    }
111}