StructBodyParser.java

/*******************************************************************************
 * Copyright (c) 2015 Ericsson
 *
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *******************************************************************************/
package org.eclipse.tracecompass.internal.ctf.core.event.metadata.tsdl.struct;

import static org.eclipse.tracecompass.internal.ctf.core.event.metadata.tsdl.TsdlUtils.childTypeError;

import java.util.Collections;
import java.util.List;

import org.antlr.runtime.tree.CommonTree;
import org.eclipse.jdt.annotation.NonNullByDefault;
import org.eclipse.jdt.annotation.Nullable;
import org.eclipse.tracecompass.ctf.core.event.metadata.DeclarationScope;
import org.eclipse.tracecompass.ctf.core.event.types.StructDeclaration;
import org.eclipse.tracecompass.ctf.core.trace.CTFTrace;
import org.eclipse.tracecompass.ctf.parser.CTFParser;
import org.eclipse.tracecompass.internal.ctf.core.event.metadata.AbstractScopedCommonTreeParser;
import org.eclipse.tracecompass.internal.ctf.core.event.metadata.MetadataStrings;
import org.eclipse.tracecompass.internal.ctf.core.event.metadata.ParseException;
import org.eclipse.tracecompass.internal.ctf.core.event.metadata.tsdl.TypeAliasParser;
import org.eclipse.tracecompass.internal.ctf.core.event.metadata.tsdl.TypedefParser;

/**
 * A struct body can have any of the following elements, even though some of
 * them do not make sense:
 * <ul>
 * <li>align</li>
 * <li>callsite</li>
 * <li>const</li>
 * <li>char</li>
 * <li>clock</li>
 * <li>double</li>
 * <li>enum</li>
 * <li>env</li>
 * <li>event</li>
 * <li>floating_point</li>
 * <li>float</li>
 * <li>integer</li>
 * <li>int</li>
 * <li>long</li>
 * <li>short</li>
 * <li>signed</li>
 * <li>stream</li>
 * <li>string</li>
 * <li>struct</li>
 * <li>trace</li>
 * <li>typealias</li>
 * <li>typedef</li>
 * <li>unsigned</li>
 * <li>variant</li>
 * <li>void</li>
 * <li>_Bool</li>
 * <li>_Complex</li>
 * <li>_Imaginary</li>
 * </ul>
 *
 * @author Matthew Khouzam
 *
 */
public final class StructBodyParser extends AbstractScopedCommonTreeParser {

    /**
     * The parameter object
     *
     * @author Matthew Khouzam
     *
     */
    @NonNullByDefault
    public static final class Param implements ICommonTreeParserParameter {
        private final DeclarationScope fDeclarationScope;
        private final @Nullable String fName;
        private final StructDeclaration fStructDeclaration;
        private final CTFTrace fTrace;

        /**
         * Constructor
         *
         * @param structDeclaration
         *            struct declaration to populate
         * @param trace
         *            the trace
         * @param name
         *            the struct name
         * @param scope
         *            the current scope
         */
        public Param(StructDeclaration structDeclaration, CTFTrace trace, @Nullable String name, DeclarationScope scope) {
            fStructDeclaration = structDeclaration;
            fTrace = trace;
            fDeclarationScope = scope;
            fName = name;
        }
    }

    /**
     * The instance
     */
    public static final StructBodyParser INSTANCE = new StructBodyParser();

    private StructBodyParser() {
    }

    /**
     * Parse the body of a struct, so anything between the '{' '}'
     *
     * @param structBody
     *            the struct body AST node
     * @param param
     *            the struct body parameters
     * @return {@link StructDeclaration} that is now populated
     * @throws ParseException
     *             The AST is malformed
     */
    @Override
    public StructDeclaration parse(CommonTree structBody, ICommonTreeParserParameter param) throws ParseException {
        if (!(param instanceof Param)) {
            throw new IllegalArgumentException("Param must be a " + Param.class.getCanonicalName()); //$NON-NLS-1$
        }
        String structName = ((Param) param).fName;
        final DeclarationScope scope = new DeclarationScope(((Param) param).fDeclarationScope, structName == null ? MetadataStrings.STRUCT : structName);
        StructDeclaration structDeclaration = ((Param) param).fStructDeclaration;
        List<CommonTree> structDeclarations = structBody.getChildren();
        if (structDeclarations == null) {
            structDeclarations = Collections.emptyList();
        }

        /*
         * If structDeclaration is null, structBody has no children and the
         * struct body is empty.
         */

        CTFTrace trace = ((Param) param).fTrace;

        for (CommonTree declarationNode : structDeclarations) {
            switch (declarationNode.getType()) {
            case CTFParser.TYPEALIAS:
                TypeAliasParser.INSTANCE.parse(declarationNode, new TypeAliasParser.Param(trace, scope));
                break;
            case CTFParser.TYPEDEF:
                TypedefParser.INSTANCE.parse(declarationNode, new TypedefParser.Param(trace, scope));
                StructDeclarationParser.INSTANCE.parse(declarationNode, new StructDeclarationParser.Param(structDeclaration, trace, scope));
                break;
            case CTFParser.SV_DECLARATION:
                StructDeclarationParser.INSTANCE.parse(declarationNode, new StructDeclarationParser.Param(structDeclaration, trace, scope));
                break;
            default:
                throw childTypeError(declarationNode);
            }
        }
        return structDeclaration;
    }

}