tajo-plan/src/main/java/org/apache/tajo/plan/function/FunctionInvoke.java

/**
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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 org.apache.tajo.plan.function;

import com.google.gson.annotations.Expose;
import org.apache.tajo.catalog.FunctionDesc;
import org.apache.tajo.datum.Datum;
import org.apache.tajo.exception.TajoRuntimeException;
import org.apache.tajo.exception.UnsupportedException;
import org.apache.tajo.storage.Tuple;

import java.io.IOException;

/**
 * An abstract class for actual function invocation.
 * The metadata for function invocation are stored in the {@link org.apache.tajo.function.FunctionInvocation} class.
 */
public abstract class FunctionInvoke implements Cloneable {
  @Expose protected FunctionDesc functionDesc;

  public FunctionInvoke() {

  }

  public FunctionInvoke(FunctionDesc functionDesc) {
    this.functionDesc = functionDesc;
  }

  public static FunctionInvoke newInstance(FunctionDesc desc) {
    if (desc.getInvocation().hasLegacy()) {
      return new ClassBasedScalarFunctionInvoke(desc);
    } else if (desc.getInvocation().hasPython()) {
      return new PythonFunctionInvoke(desc);
    } else if (desc.getInvocation().hasHiveUDF()) {
      return new HiveFunctionInvoke(desc);
    } else {
      throw new TajoRuntimeException(new UnsupportedException("function invocation '" + desc.getInvocation() + "'"));
    }
  }

  public void setFunctionDesc(FunctionDesc functionDesc) {
    this.functionDesc = functionDesc;
  }

  public abstract void init(FunctionInvokeContext context) throws IOException;

  /**
   * Evaluate the given tuple with a function
   * @param tuple a tuple evaluated with parameters
   * @return a result of a fuction execution
   */
  public abstract Datum eval(Tuple tuple);

  @Override
  public boolean equals(Object o) {
    if (o instanceof FunctionInvoke) {
      FunctionInvoke other = (FunctionInvoke) o;
      return this.functionDesc.equals(other.functionDesc);
    }
    return false;
  }

  @Override
  public int hashCode() {
    return functionDesc.hashCode();
  }

  @Override
  public Object clone() throws CloneNotSupportedException {
    FunctionInvoke clone = (FunctionInvoke) super.clone();
    clone.functionDesc = (FunctionDesc) this.functionDesc.clone();
    return clone;
  }
}