com.hazelcast.jet.sql.impl.connector.HazelcastRexNode Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of hazelcast-sql Show documentation
SQL Parser and Optimizer
There is a newer version: 5.5.0
/*
 * Copyright 2024 Hazelcast Inc.
 *
 * Licensed under the Hazelcast Community License (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://hazelcast.com/hazelcast-community-license
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.hazelcast.jet.sql.impl.connector;

import com.hazelcast.shaded.org.apache.calcite.rex.RexNode;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import java.util.List;

import static java.util.Objects.requireNonNull;
import static java.util.stream.Collectors.toList;

/**
 * Wraps Calcite's {@link RexNode} so that connector can be created outside hazelcast-sql module without problems with
 * relocated Calcite dependency.
 * 
 * During shading process the {@link RexNode} is relocated to {@code com.hazelcast.shaded.*},
 * however if you work on an {@link SqlConnector} inside core Hazelcast repository, then IDE will still see only
 * the class it the original package.
 * 

 * Wrapping {@link RexNode}s avoids problems in compilation both in IDE and Maven, as this class is not relocated
 * and at runtime it will just return the relocated class.
 * If you want to use this class in a module outside hazelcast-sql, you must apply maven-shade-plugin with
 * configuration that shades calcite-core, otherwise you will end up in runtime errors.
 *
 * 

 * To use wrapped {@link RexNode}, call {@link #unwrap(Class)} method, passing {@link RexNode#getClass()} as an argument.
 *
 * 

 * Example usage:
 * 
{@code
 * HazelcastRexNode hazelcastRexNode = HazelcastRexNode.wrap(someRexNodeEgFilter);
 *
 * // later in SqlConnector, maybe outside hazelcast-sql:
 * RexNode node = hazelcastRexNode.unwrap(RexNode.class);
 * }
 *
 * Example shade plugin config:
 * {@code
 *             
 *                 org.apache.maven.plugins
 *                 maven-shade-plugin
 *                 ${maven.shade.plugin.version}
 *                 
 *                     
 *                         fat-shaded-jar
 *                         package
 *                         
 *                             shade
 *                         
 *                         
 *                             
 *                                 
 *                                     *:*
 *                                     
 *                                         module-info.class
 *                                         META-INF/*.SF
 *                                         META-INF/*.DSA
 *                                         META-INF/*.RSA
 *                                     
 *                                 
 *                             
 *                             
 *                                 
 *                                     com.hazelcast.shaded.org.apache.calcite
 *                                     ${relocation.root}.org.apache.calcite
 *                                 
 *                             
 *                         
 *                     
 *                 
 *             
 * }
 *
 * Make sure that {@code hazelcast-sql} and {@code org.apache.calcite:calcite-core} are declared
 * with {@code provided} scope, so that they won't be included in final jar.
 */
public final class HazelcastRexNode {
    private final RexNode node;

    private HazelcastRexNode(@Nonnull RexNode node) {
        this.node = requireNonNull(node);
    }

    /**
     * Returns underlying Calcite {@linkplain RexNode}.
     */
    @Nonnull
    public  T unwrap(Class clazz) {
        return clazz.cast(node);
    }

    /**
     * Creates a new wrapper around the given `node`.
     */
    public static @Nullable HazelcastRexNode wrap(@Nullable RexNode node) {
        if (node == null) {
            return null;
        }
        return new HazelcastRexNode(node);
    }

    /**
     * Creates a new list with each node from original one wrapped.
     */
    public static @Nonnull List wrap(@Nonnull List nodes) {
        return nodes.stream()
                .map(HazelcastRexNode::wrap)
                .collect(toList());
    }
}