1 /*
2  * reserved comment block
3  * DO NOT REMOVE OR ALTER!
4  */
5 /*
6  * Licensed to the Apache Software Foundation (ASF) under one or more
7  * contributor license agreements.  See the NOTICE file distributed with
8  * this work for additional information regarding copyright ownership.
9  * The ASF licenses this file to You under the Apache License, Version 2.0
10  * (the "License"); you may not use this file except in compliance with
11  * the License.  You may obtain a copy of the License at
12  *
13  *      http://www.apache.org/licenses/LICENSE-2.0
14  *
15  * Unless required by applicable law or agreed to in writing, software
16  * distributed under the License is distributed on an "AS IS" BASIS,
17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18  * See the License for the specific language governing permissions and
19  * limitations under the License.
20  */
21 
22 package com.sun.org.apache.bcel.internal.generic;
23 
24 import com.sun.org.apache.bcel.internal.Const;
25 import com.sun.org.apache.bcel.internal.ExceptionConst;
26 
27 /**
28  * PUTFIELD - Put field in object
29  * <PRE>Stack: ..., objectref, value -&gt; ...</PRE>
30  * OR
31  * <PRE>Stack: ..., objectref, value.word1, value.word2 -&gt; ...</PRE>
32  *
33  */
34 public class PUTFIELD extends FieldInstruction implements PopInstruction, ExceptionThrower {
35 
36     /**
37      * Empty constructor needed for Instruction.readInstruction.
38      * Not to be used otherwise.
39      */
PUTFIELD()40     PUTFIELD() {
41     }
42 
43 
PUTFIELD(final int index)44     public PUTFIELD(final int index) {
45         super(Const.PUTFIELD, index);
46     }
47 
48 
49     @Override
consumeStack( final ConstantPoolGen cpg )50     public int consumeStack( final ConstantPoolGen cpg ) {
51         return getFieldSize(cpg) + 1;
52     }
53 
54 
55     @Override
getExceptions()56     public Class<?>[] getExceptions() {
57         return ExceptionConst.createExceptions(ExceptionConst.EXCS.EXCS_FIELD_AND_METHOD_RESOLUTION,
58             ExceptionConst.NULL_POINTER_EXCEPTION,
59             ExceptionConst.INCOMPATIBLE_CLASS_CHANGE_ERROR);
60     }
61 
62 
63     /**
64      * Call corresponding visitor method(s). The order is:
65      * Call visitor methods of implemented interfaces first, then
66      * call methods according to the class hierarchy in descending order,
67      * i.e., the most specific visitXXX() call comes last.
68      *
69      * @param v Visitor object
70      */
71     @Override
accept( final Visitor v )72     public void accept( final Visitor v ) {
73         v.visitExceptionThrower(this);
74         v.visitStackConsumer(this);
75         v.visitPopInstruction(this);
76         v.visitTypedInstruction(this);
77         v.visitLoadClass(this);
78         v.visitCPInstruction(this);
79         v.visitFieldOrMethod(this);
80         v.visitFieldInstruction(this);
81         v.visitPUTFIELD(this);
82     }
83 }
84