/*
 ***************************************************************************************
 *  Copyright (C) 2006 EsperTech, Inc. All rights reserved.                            *
 *  http://www.espertech.com/esper                                                     *
 *  http://www.espertech.com                                                           *
 *  ---------------------------------------------------------------------------------- *
 *  The software in this package is published under the terms of the GPL license       *
 *  a copy of which has been included with this distribution in the license.txt file.  *
 ***************************************************************************************
 */
package com.espertech.esper.client.soda;

import java.io.Serializable;
import java.io.StringWriter;
import java.util.ArrayList;
import java.util.List;

/**
 * The group-by clause consists of a list of expressions that provide the grouped-by values.
 */
public class GroupByClause implements Serializable {
    private static final long serialVersionUID = 0L;

    private List<GroupByClauseExpression> groupByExpressions;

    /**
     * Ctor.
     *
     * @param groupByExpressions expression list
     */
    public GroupByClause(List<GroupByClauseExpression> groupByExpressions) {
        this.groupByExpressions = groupByExpressions;
    }

    /**
     * Creates an empty group-by clause, to add to via add methods.
     *
     * @return group-by clause
     */
    public static GroupByClause create() {
        return new GroupByClause();
    }

    /**
     * Creates a group-by clause from property names.
     *
     * @param properties a list of one or more property names
     * @return group-by clause consisting of the properties
     */
    public static GroupByClause create(String... properties) {
        return new GroupByClause(properties);
    }

    /**
     * Creates a group-by clause from expressions.
     *
     * @param expressions a list of one or more expressions
     * @return group-by clause consisting of the expressions
     */
    public static GroupByClause create(Expression... expressions) {
        return new GroupByClause(expressions);
    }

    /**
     * Ctor - for use to create an expression tree, without child expression.
     * <p>
     * Use add methods to add child expressions to acts upon.
     */
    public GroupByClause() {
        groupByExpressions = new ArrayList<GroupByClauseExpression>();
    }

    /**
     * Ctor.
     *
     * @param properties is a list of property names
     */
    public GroupByClause(String... properties) {
        this();
        for (String property : properties) {
            groupByExpressions.add(new GroupByClauseExpressionSingle(Expressions.property(property)));
        }
    }

    /**
     * Ctor.
     *
     * @param expressions list of expressions
     */
    public GroupByClause(Expression... expressions) {
        this();
        for (Expression expression : expressions) {
            groupByExpressions.add(new GroupByClauseExpressionSingle(expression));
        }
    }

    /**
     * Returns the expressions providing the grouped-by values.
     *
     * @return expressions
     */
    public List<GroupByClauseExpression> getGroupByExpressions() {
        return groupByExpressions;
    }

    /**
     * Sets the expressions providing the grouped-by values.
     *
     * @param groupByExpressions is the expressions providing the grouped-by values
     */
    public void setGroupByExpressions(List<GroupByClauseExpression> groupByExpressions) {
        this.groupByExpressions = groupByExpressions;
    }

    /**
     * Renders the clause in textual representation.
     *
     * @param writer to output to
     */
    public void toEPL(StringWriter writer) {
        String delimiter = "";
        for (GroupByClauseExpression child : groupByExpressions) {
            writer.write(delimiter);
            child.toEPL(writer);
            delimiter = ", ";
        }
    }
}