/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You 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 org.apache.tomcat.util.modeler;

import java.io.Serial;
import java.util.Locale;
import java.util.concurrent.locks.Lock;
import java.util.concurrent.locks.ReadWriteLock;
import java.util.concurrent.locks.ReentrantReadWriteLock;

import javax.management.MBeanOperationInfo;
import javax.management.MBeanParameterInfo;

/**
 * <p>
 * Internal configuration information for an <code>Operation</code> descriptor.
 * </p>
 */
public class OperationInfo extends FeatureInfo {

    @Serial
    private static final long serialVersionUID = 4418342922072614875L;

    // ----------------------------------------------------------- Constructors

    /**
     * Standard zero-arguments constructor.
     */
    public OperationInfo() {
        super();
    }


    // ----------------------------------------------------- Instance Variables

    // Instance variables for OperationInfo: impact, role, parametersLock, parameters.
     /** Impact of the operation. */
    protected String impact = "UNKNOWN";
    /** Role of the operation. */
    protected String role = "operation";
    /** Lock for parameter access. */
    protected final ReadWriteLock parametersLock = new ReentrantReadWriteLock();
    /** Array of parameters. */
    protected ParameterInfo[] parameters = new ParameterInfo[0];


    // ------------------------------------------------------------- Properties

    /**
     * Returns the "impact" of this operation, which should be a (case-insensitive) string value "ACTION",
     * "ACTION_INFO", "INFO", or "UNKNOWN".
     *
     * @return The impact of this operation
     */
    public String getImpact() {
        return this.impact;
    }

    /**
     * Sets the impact of this operation.
     *
     * @param impact The impact value
     */
    public void setImpact(String impact) {
        if (impact == null) {
            this.impact = null;
        } else {
            this.impact = impact.toUpperCase(Locale.ENGLISH);
        }
    }


    /**
     * Returns the role of this operation ("getter", "setter", "operation", or "constructor").
     *
     * @return The role of this operation
     */
    public String getRole() {
        return this.role;
    }

    /**
     * Sets the role of this operation.
     *
     * @param role The role value
     */
    public void setRole(String role) {
        this.role = role;
    }


    /**
     * Returns the fully qualified Java class name of the return type for this operation.
     *
     * @return The return type
     */
    public String getReturnType() {
        if (type == null) {
            type = "void";
        }
        return type;
    }

    /**
     * Sets the return type of this operation.
     *
     * @param returnType The return type
     */
    public void setReturnType(String returnType) {
        this.type = returnType;
    }

    /**
     * Returns the array of parameters for this operation.
     *
     * @return The parameter array
     */
    public ParameterInfo[] getSignature() {
        Lock readLock = parametersLock.readLock();
        readLock.lock();
        try {
            return this.parameters;
        } finally {
            readLock.unlock();
        }
    }

    // --------------------------------------------------------- Public Methods


    /**
     * Add a new parameter to the set of arguments for this operation.
     *
     * @param parameter The new parameter descriptor
     */
    public void addParameter(ParameterInfo parameter) {

        Lock writeLock = parametersLock.writeLock();
        writeLock.lock();
        try {
            ParameterInfo[] results = new ParameterInfo[parameters.length + 1];
            System.arraycopy(parameters, 0, results, 0, parameters.length);
            results[parameters.length] = parameter;
            parameters = results;
            this.info = null;
        } finally {
            writeLock.unlock();
        }
    }


    /**
     * Create and return a <code>ModelMBeanOperationInfo</code> object that corresponds to the attribute described by
     * this instance.
     *
     * @return the operation info
     */
    MBeanOperationInfo createOperationInfo() {

        // Return our cached information (if any)
        if (info == null) {
            // Create and return a new information object
            int impact = MBeanOperationInfo.UNKNOWN;
            if ("ACTION".equals(getImpact())) {
                impact = MBeanOperationInfo.ACTION;
            } else if ("ACTION_INFO".equals(getImpact())) {
                impact = MBeanOperationInfo.ACTION_INFO;
            } else if ("INFO".equals(getImpact())) {
                impact = MBeanOperationInfo.INFO;
            }

            info = new MBeanOperationInfo(getName(), getDescription(), getMBeanParameterInfo(), getReturnType(),
                    impact);
        }
        return (MBeanOperationInfo) info;
    }

    /**
     * Creates an array of MBeanParameterInfo from the operation parameters.
     *
     * @return The MBean parameter info array
     */
    protected MBeanParameterInfo[] getMBeanParameterInfo() {
        ParameterInfo[] params = getSignature();
        MBeanParameterInfo[] parameters = new MBeanParameterInfo[params.length];
        for (int i = 0; i < params.length; i++) {
            parameters[i] = params[i].createParameterInfo();
        }
        return parameters;
    }
}
