org.eclipse.persistence.jpa.jpql.tools.model.query.MinFunctionStateObject Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of eclipselink Show documentation
Show all versions of eclipselink Show documentation
EclipseLink build based upon Git transaction 774c696
/*******************************************************************************
* Copyright (c) 2011, 2014 Oracle and/or its affiliates. All rights reserved.
* This program and the accompanying materials are made available under the
* terms of the Eclipse Public License v1.0 and Eclipse Distribution License v. 1.0
* which accompanies this distribution.
* The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
* and the Eclipse Distribution License is available at
* http://www.eclipse.org/org/documents/edl-v10.php.
*
* Contributors:
* Oracle - initial API and implementation
*
******************************************************************************/
package org.eclipse.persistence.jpa.jpql.tools.model.query;
import org.eclipse.persistence.jpa.jpql.parser.MinFunction;
import org.eclipse.persistence.jpa.jpql.parser.StateFieldPathExpressionBNF;
import static org.eclipse.persistence.jpa.jpql.parser.Expression.*;
/**
* One of the aggregate functions. The arguments must correspond to orderable state-field types
* (i.e., numeric types, string types, character types, or date types). The return type of this
* function is based on the state-field's type.
*
* BNF: expression ::= MIN([DISTINCT] state_field_path_expression)
*
* @see MinFunction
*
* @version 2.4
* @since 2.4
* @author Pascal Filion
*/
public class MinFunctionStateObject extends AggregateFunctionStateObject {
/**
* Creates a new MinFunctionStateObject
.
*
* @param parent The parent of this state object, which cannot be null
* @exception NullPointerException The given parent cannot be null
*/
public MinFunctionStateObject(StateObject parent) {
super(parent);
}
/**
* Creates a new MinFunctionStateObject
.
*
* @param parent The parent of this state object, which cannot be null
* @param distinct true
to add DISTINCT
to the query in order to
* have distinct values; false
if it is not required
* @param stateObject The {@link StateObject} representing the encapsulated expression
* @exception NullPointerException The given parent cannot be null
*/
public MinFunctionStateObject(StateObject parent, boolean distinct, StateObject stateObject) {
super(parent, distinct, stateObject);
}
/**
* Creates a new MinFunctionStateObject
.
*
* @param parent The parent of this state object, which cannot be null
* @param distinct true
to add DISTINCT
to the query in order to
* have distinct values; false
if it is not required
* @param path Either the identification variable or the state field path expression
* @exception NullPointerException The given parent cannot be null
*/
public MinFunctionStateObject(StateObject parent, boolean distinct, String path) {
super(parent, distinct, path);
}
/**
* Creates a new MinFunctionStateObject
.
*
* @param parent The parent of this state object, which cannot be null
* @param stateObject The {@link StateObject} representing the encapsulated expression
* @exception NullPointerException The given parent cannot be null
*/
public MinFunctionStateObject(StateObject parent, StateObject stateObject) {
super(parent, stateObject);
}
/**
* Creates a new MinFunctionStateObject
.
*
* @param parent The parent of this state object, which cannot be null
* @param path Either the identification variable or the state field path expression
* @exception NullPointerException The given parent cannot be null
*/
public MinFunctionStateObject(StateObject parent, String path) {
super(parent, path);
}
/**
* {@inheritDoc}
*/
public void accept(StateObjectVisitor visitor) {
visitor.visit(this);
}
/**
* {@inheritDoc}
*/
@Override
public MinFunction getExpression() {
return (MinFunction) super.getExpression();
}
/**
* {@inheritDoc}
*/
@Override
public String getIdentifier() {
return MIN;
}
/**
* {@inheritDoc}
*/
@Override
protected String getQueryBNFId() {
return StateFieldPathExpressionBNF.ID;
}
/**
* Keeps a reference of the {@link MinFunction parsed object} object, which should only be done
* when this object is instantiated during the conversion of a parsed JPQL query into {@link
* StateObject StateObjects}.
*
* @param expression The {@link MinFunction parsed object} representing a MIN
* expression
*/
public void setExpression(MinFunction expression) {
super.setExpression(expression);
}
}