/* BSD 2-Clause License - see OPAL/LICENSE for details. */
package org.opalj
package br
package instructions

/**
 * Invoke interface method.
 *
 * @author Michael Eichberg
 */
case class INVOKEINTERFACE(
    override val declaringClass:   ClassType, // an interface type
    override val name:             String,
    override val methodDescriptor: MethodDescriptor
) extends VirtualMethodInvocationInstruction {

    override final def isInterfaceCall: Boolean = true

    override final def opcode: Opcode = INVOKEINTERFACE.opcode

    override final def mnemonic: String = "invokeinterface"

    override final def jvmExceptions: List[ClassType] = MethodInvocationInstruction.jvmExceptions

    override final def length: Int = 5

    override final def isInstanceMethod: Boolean = true

    // Required to avoid that Scala generates a default toString method!
    override def toString = super.toString

}

/**
 * General information and factory methods.
 *
 * @author Malte Limmeroth
 */
object INVOKEINTERFACE extends InstructionMetaInformation {

    final val opcode = 185

    /**
     * Factory method to create [[INVOKEINTERFACE]] instructions.
     *
     * @param   declaringClass the method's declaring class name in JVM notation,
     *          e.g. "java/lang/Object".
     * @param   methodDescriptor the method descriptor in JVM notation,
     *          e.g. "()V" for a method without parameters which returns void.
     */
    def apply(
        declaringClass:   String,
        methodName:       String,
        methodDescriptor: String
    ): INVOKEINTERFACE = {
        INVOKEINTERFACE(ClassType(declaringClass), methodName, MethodDescriptor(methodDescriptor))
    }
}