/*
 * Copyright DataStax, Inc.
 *
 * Licensed 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 com.datastax.dse.driver.api.core.metadata.schema;

import com.datastax.oss.driver.api.core.metadata.schema.AggregateMetadata;
import com.datastax.oss.driver.api.core.type.DataType;
import com.datastax.oss.driver.internal.core.metadata.schema.ScriptBuilder;
import edu.umd.cs.findbugs.annotations.NonNull;
import java.util.Optional;

Specialized aggregate metadata for DSE.

It adds support for the DSE-specific DETERMINISTIC keyword.

/** * Specialized aggregate metadata for DSE. * * <p>It adds support for the DSE-specific {@link #getDeterministic() DETERMINISTIC} keyword. */
public interface DseAggregateMetadata extends AggregateMetadata {
Deprecated:Use getDeterministic() instead.
/** @deprecated Use {@link #getDeterministic()} instead. */
@Deprecated boolean isDeterministic();
Indicates if this aggregate is deterministic. A deterministic aggregate means that given a particular input, the aggregate will always produce the same output.

This method returns empty if this information was not found in the system tables, regardless of the actual aggregate characteristics; this is the case for all versions of DSE older than 6.0.0.

Returns:Whether or not this aggregate is deterministic; or empty if such information is not available in the system tables.
/** * Indicates if this aggregate is deterministic. A deterministic aggregate means that given a * particular input, the aggregate will always produce the same output. * * <p>This method returns {@linkplain Optional#empty() empty} if this information was not found in * the system tables, regardless of the actual aggregate characteristics; this is the case for all * versions of DSE older than 6.0.0. * * @return Whether or not this aggregate is deterministic; or {@linkplain Optional#empty() empty} * if such information is not available in the system tables. */
default Optional<Boolean> getDeterministic() { return Optional.of(isDeterministic()); } @NonNull @Override default String describe(boolean pretty) { // Easiest to just copy the OSS describe() method and add in DETERMINISTIC ScriptBuilder builder = new ScriptBuilder(pretty); builder .append("CREATE AGGREGATE ") .append(getKeyspace()) .append(".") .append(getSignature().getName()) .append("("); boolean first = true; for (int i = 0; i < getSignature().getParameterTypes().size(); i++) { if (first) { first = false; } else { builder.append(","); } DataType type = getSignature().getParameterTypes().get(i); builder.append(type.asCql(false, pretty)); } builder .increaseIndent() .append(")") .newLine() .append("SFUNC ") .append(getStateFuncSignature().getName()) .newLine() .append("STYPE ") .append(getStateType().asCql(false, pretty)); if (getFinalFuncSignature().isPresent()) { builder.newLine().append("FINALFUNC ").append(getFinalFuncSignature().get().getName()); } if (getInitCond().isPresent()) { Optional<String> formatInitCond = formatInitCond(); assert formatInitCond.isPresent(); builder.newLine().append("INITCOND ").append(formatInitCond.get()); } // add DETERMINISTIC if present if (getDeterministic().orElse(false)) { builder.newLine().append("DETERMINISTIC"); } return builder.append(";").build(); } }