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 
  25 import com.sun.org.apache.bcel.internal.Constants;
  26 import com.sun.org.apache.bcel.internal.ExceptionConstants;
  27 
  28 /**
  29  * PUTFIELD - Put field in object
  30  * <PRE>Stack: ..., objectref, value -&gt; ...</PRE>
  31  * OR
  32  * <PRE>Stack: ..., objectref, value.word1, value.word2 -&gt; ...</PRE>
  33  *
  34  * @author  <A HREF="mailto:markus.dahm@berlin.de">M. Dahm</A>
  35  */
  36 public class PUTFIELD
  37     extends FieldInstruction
  38     implements PopInstruction,ExceptionThrower{
  39   /**
  40    * Empty constructor needed for the Class.newInstance() statement in
  41    * Instruction.readInstruction(). Not to be used otherwise.
  42    */
  43   PUTFIELD() {}
  44 
  45   public PUTFIELD(int index) {
  46     super(Constants.PUTFIELD, index);
  47   }
  48 
  49   public int consumeStack(ConstantPoolGen cpg) { return getFieldSize(cpg) + 1; }
  50 
  51   public Class[] getExceptions() {
  52     Class[] cs = new Class[2 + ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length];
  53 
  54     System.arraycopy(ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION, 0,
  55                      cs, 0, ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length);
  56 
  57     cs[ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length+1] =
  58       ExceptionConstants.INCOMPATIBLE_CLASS_CHANGE_ERROR;
  59     cs[ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length] =
  60       ExceptionConstants.NULL_POINTER_EXCEPTION;
  61 
  62     return cs;
  63   }
  64 
  65 
  66   /**
  67    * Call corresponding visitor method(s). The order is:
  68    * Call visitor methods of implemented interfaces first, then
  69    * call methods according to the class hierarchy in descending order,
  70    * i.e., the most specific visitXXX() call comes last.
  71    *
  72    * @param v Visitor object
  73    */
  74   public void accept(Visitor v) {
  75     v.visitExceptionThrower(this);
  76     v.visitStackConsumer(this);
  77     v.visitPopInstruction(this);
  78     v.visitTypedInstruction(this);
  79     v.visitLoadClass(this);
  80     v.visitCPInstruction(this);
  81     v.visitFieldOrMethod(this);
  82     v.visitFieldInstruction(this);
  83     v.visitPUTFIELD(this);
  84   }
  85 }