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