1 /*

     2  * reserved comment block

     3  * DO NOT REMOVE OR ALTER!

     4  */

     5 package com.sun.org.apache.bcel.internal.generic;

     6 

     7 /* ====================================================================

     8  * The Apache Software License, Version 1.1

     9  *

    10  * Copyright (c) 2001 The Apache Software Foundation.  All rights

    11  * reserved.

    12  *

    13  * Redistribution and use in source and binary forms, with or without

    14  * modification, are permitted provided that the following conditions

    15  * are met:

    16  *

    17  * 1. Redistributions of source code must retain the above copyright

    18  *    notice, this list of conditions and the following disclaimer.

    19  *

    20  * 2. Redistributions in binary form must reproduce the above copyright

    21  *    notice, this list of conditions and the following disclaimer in

    22  *    the documentation and/or other materials provided with the

    23  *    distribution.

    24  *

    25  * 3. The end-user documentation included with the redistribution,

    26  *    if any, must include the following acknowledgment:

    27  *       "This product includes software developed by the

    28  *        Apache Software Foundation (http://www.apache.org/)."

    29  *    Alternately, this acknowledgment may appear in the software itself,

    30  *    if and wherever such third-party acknowledgments normally appear.

    31  *

    32  * 4. The names "Apache" and "Apache Software Foundation" and

    33  *    "Apache BCEL" must not be used to endorse or promote products

    34  *    derived from this software without prior written permission. For

    35  *    written permission, please contact apache@apache.org.

    36  *

    37  * 5. Products derived from this software may not be called "Apache",

    38  *    "Apache BCEL", nor may "Apache" appear in their name, without

    39  *    prior written permission of the Apache Software Foundation.

    40  *

    41  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED

    42  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES

    43  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

    44  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR

    45  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

    46  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT

    47  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF

    48  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND

    49  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,

    50  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT

    51  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

    52  * SUCH DAMAGE.

    53  * ====================================================================

    54  *

    55  * This software consists of voluntary contributions made by many

    56  * individuals on behalf of the Apache Software Foundation.  For more

    57  * information on the Apache Software Foundation, please see

    58  * <http://www.apache.org/>.

    59  */

    60 import com.sun.org.apache.bcel.internal.Constants;

    61 import com.sun.org.apache.bcel.internal.ExceptionConstants;

    62 

    63 /**

    64  * INVOKESPECIAL - Invoke instance method; special handling for superclass, private

    65  * and instance initialization method invocations

    66  *

    67  * <PRE>Stack: ..., objectref, [arg1, [arg2 ...]] -&gt; ...</PRE>

    68  *

    69  * @author  <A HREF="mailto:markus.dahm@berlin.de">M. Dahm</A>

    70  */

    71 public class INVOKESPECIAL extends InvokeInstruction {

    72   /**

    73    * Empty constructor needed for the Class.newInstance() statement in

    74    * Instruction.readInstruction(). Not to be used otherwise.

    75    */

    76   INVOKESPECIAL() {}

    77 

    78   public INVOKESPECIAL(int index) {

    79     super(Constants.INVOKESPECIAL, index);

    80   }

    81 

    82   public Class[] getExceptions() {

    83     Class[] cs = new Class[4 + ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length];

    84 

    85     System.arraycopy(ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION, 0,

    86                      cs, 0, ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length);

    87 

    88     cs[ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length+3] = ExceptionConstants.UNSATISFIED_LINK_ERROR;

    89     cs[ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length+2] = ExceptionConstants.ABSTRACT_METHOD_ERROR;

    90     cs[ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length+1] = ExceptionConstants.INCOMPATIBLE_CLASS_CHANGE_ERROR;

    91     cs[ExceptionConstants.EXCS_FIELD_AND_METHOD_RESOLUTION.length]   = ExceptionConstants.NULL_POINTER_EXCEPTION;

    92 

    93     return cs;

    94   }

    95 

    96 

    97   /**

    98    * Call corresponding visitor method(s). The order is:

    99    * Call visitor methods of implemented interfaces first, then

   100    * call methods according to the class hierarchy in descending order,

   101    * i.e., the most specific visitXXX() call comes last.

   102    *

   103    * @param v Visitor object

   104    */

   105   public void accept(Visitor v) {

   106     v.visitExceptionThrower(this);

   107     v.visitTypedInstruction(this);

   108     v.visitStackConsumer(this);

   109     v.visitStackProducer(this);

   110     v.visitLoadClass(this);

   111     v.visitCPInstruction(this);

   112     v.visitFieldOrMethod(this);

   113     v.visitInvokeInstruction(this);

   114     v.visitINVOKESPECIAL(this);

   115   }

   116 }