/*
 * Copyright 2014 - 2020 Rafael Winterhalter
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package net.bytebuddy.implementation;

import net.bytebuddy.description.method.MethodDescription;
import net.bytebuddy.dynamic.scaffold.InstrumentedType;
import net.bytebuddy.implementation.bytecode.ByteCodeAppender;
import net.bytebuddy.implementation.bytecode.StackManipulation;
import net.bytebuddy.implementation.bytecode.constant.DefaultValue;
import net.bytebuddy.implementation.bytecode.member.MethodReturn;
import org.objectweb.asm.MethodVisitor;

This implementation creates a method stub which does nothing but returning the default value of the return type of the method. These default values are:
  1. The value 0 for all numeric type.
  2. The null character for the char type.
  3. false for the boolean type.
  4. Nothing for void types.
  5. A null reference for any reference types. Note that this includes primitive wrapper types.
/** * This implementation creates a method stub which does nothing but returning the default value of the return * type of the method. These default values are: * <ol> * <li>The value {@code 0} for all numeric type.</li> * <li>The null character for the {@code char} type.</li> * <li>{@code false} for the {@code boolean} type.</li> * <li>Nothing for {@code void} types.</li> * <li>A {@code null} reference for any reference types. Note that this includes primitive wrapper types.</li> * </ol> */
public enum StubMethod implements Implementation.Composable, ByteCodeAppender {
The singleton instance.
/** * The singleton instance. */
INSTANCE;
{@inheritDoc}
/** * {@inheritDoc} */
public InstrumentedType prepare(InstrumentedType instrumentedType) { return instrumentedType; }
{@inheritDoc}
/** * {@inheritDoc} */
public ByteCodeAppender appender(Target implementationTarget) { return this; }
{@inheritDoc}
/** * {@inheritDoc} */
public Implementation andThen(Implementation implementation) { return implementation; }
{@inheritDoc}
/** * {@inheritDoc} */
public Composable andThen(Composable implementation) { return implementation; }
{@inheritDoc}
/** * {@inheritDoc} */
public Size apply(MethodVisitor methodVisitor, Context implementationContext, MethodDescription instrumentedMethod) { StackManipulation.Size stackSize = new StackManipulation.Compound( DefaultValue.of(instrumentedMethod.getReturnType()), MethodReturn.of(instrumentedMethod.getReturnType()) ).apply(methodVisitor, implementationContext); return new Size(stackSize.getMaximalSize(), instrumentedMethod.getStackSize()); } }