
/*
 * Janino - An embedded Java[TM] compiler
 *
 * Copyright (c) 2001-2010 Arno Unkrig. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
 * following conditions are met:
 *
 *    1. Redistributions of source code must retain the above copyright notice, this list of conditions and the
 *       following disclaimer.
 *    2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
 *       following disclaimer in the documentation and/or other materials provided with the distribution.
 *    3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote
 *       products derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package org.codehaus.janino;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import org.codehaus.commons.compiler.InternalCompilerException;
import org.codehaus.commons.nullanalysis.Nullable;

/**
 * Representation of a "method descriptor" (JVMS 4.3.3).
 */
public
class MethodDescriptor {

    /**
     * The field descriptors of the method parameters.
     */
    public final String[] parameterFds;

    /**
     * The field descriptor of the method return value.
     */
    public final String   returnFd;

    /***/
    public
    MethodDescriptor(String returnFd, String... parameterFds) {
        this.parameterFds = parameterFds;
        this.returnFd     = returnFd;
    }

    /**
     * Parses a method descriptor into parameter FDs and return FDs.
     */
    public
    MethodDescriptor(String s) {
        if (s.charAt(0) != '(') throw new InternalCompilerException();

        int          from         = 1;
        List<String> parameterFDs = new ArrayList<String>();
        while (s.charAt(from) != ')') {
            int to = from;
            while (s.charAt(to) == '[') ++to;
            if ("BCDFIJSZ".indexOf(s.charAt(to)) != -1) {
                ++to;
            } else
            if (s.charAt(to) == 'L') {
                for (++to; s.charAt(to) != ';'; ++to);
                ++to;
            } else {
                throw new InternalCompilerException();
            }
            parameterFDs.add(s.substring(from, to));
            from = to;
        }
        this.parameterFds = (String[]) parameterFDs.toArray(new String[parameterFDs.size()]);
        this.returnFd     = s.substring(++from);
    }

    @Override public boolean
    equals(@Nullable Object obj) {
        if (obj == this) return true;
        if (!(obj instanceof MethodDescriptor)) return false;
        MethodDescriptor that = (MethodDescriptor) obj;

        return Arrays.equals(this.parameterFds, that.parameterFds) && this.returnFd.equals(that.returnFd);
    }

    @Override public int
    hashCode() { return Arrays.hashCode(this.parameterFds) ^ this.returnFd.hashCode(); }

    /**
     * @return The "method descriptor" (JVMS 4.3.3)
     */
    @Override public String
    toString() {
        StringBuilder sb = new StringBuilder("(");
        for (String parameterFd : this.parameterFds) sb.append(parameterFd);
        return sb.append(')').append(this.returnFd).toString();
    }

    /**
     * @return A {@link MethodDescriptor} equal to {@code this}, but with another parameter inserted at position zero
     */
    public MethodDescriptor
    prependParameter(String parameterFd) {

        String[] tmp = new String[1 + this.parameterFds.length];
        tmp[0] = parameterFd;
        System.arraycopy(this.parameterFds, 0, tmp, 1, this.parameterFds.length);

        return new MethodDescriptor(this.returnFd, tmp);
    }
}
