blob: 5a337c748c284b39e8cf992ea67bc04cf61a0a98 [file] [log] [blame]
/*
* 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.rya.indexing.pcj.fluo.app.query;
import static com.google.common.base.Preconditions.checkNotNull;
import org.apache.commons.lang3.builder.EqualsBuilder;
import org.apache.rya.indexing.pcj.storage.accumulo.VariableOrder;
import com.google.common.base.Objects;
import edu.umd.cs.findbugs.annotations.DefaultAnnotation;
import edu.umd.cs.findbugs.annotations.NonNull;
import edu.umd.cs.findbugs.annotations.Nullable;
import net.jcip.annotations.Immutable;
/**
* Metadata that is specific to a Projection.
*/
@Immutable
@DefaultAnnotation(NonNull.class)
public class ProjectionMetadata extends CommonNodeMetadata {
private final String childNodeId;
private final String parentNodeId;
private final VariableOrder projectedVars;
/**
* Constructs an instance of {@link ProjectionMetadata}.
*
* @param nodeId - The ID the Fluo app uses to reference this node. (not null)
* @param varOrder - The order in which binding values are written in the row to identify this result. (not null)
* @param childNodeId - The node whose results are projected to the query's SELECT variables. (not null)
* @param parentNodeId - The parent node of this projection (not null)
* @param projectedVars - The variables that the results are projected onto (not null)
*/
public ProjectionMetadata(
final String nodeId,
final VariableOrder varOrder,
final String childNodeId,
final String parentNodeId,
final VariableOrder projectedVars) {
super(nodeId, varOrder);
this.childNodeId = checkNotNull(childNodeId);
this.parentNodeId = checkNotNull(parentNodeId);
this.projectedVars = checkNotNull(projectedVars);
}
/**
* @return The node whose results are projected to the query's SELECT variables.l
*/
public String getChildNodeId() {
return childNodeId;
}
/**
* @return The parent node of this projection node
*/
public String getParentNodeId() {
return parentNodeId;
}
/**
* @return The variables that results are projected onto
*/
public VariableOrder getProjectedVars() {
return projectedVars;
}
@Override
public int hashCode() {
return Objects.hashCode(
super.getNodeId(),
super.getVariableOrder(),
projectedVars,
childNodeId,
parentNodeId);
}
@Override
public boolean equals(final Object o) {
if(this == o) {
return true;
}
if(o instanceof ProjectionMetadata) {
if(super.equals(o)) {
final ProjectionMetadata projectionMetadata = (ProjectionMetadata)o;
return new EqualsBuilder()
.append(childNodeId, projectionMetadata.childNodeId)
.append(parentNodeId, projectionMetadata.parentNodeId)
.append(projectedVars, projectionMetadata.projectedVars)
.isEquals();
}
return false;
}
return false;
}
@Override
public String toString() {
return new StringBuilder()
.append("ProjectionMetadata {\n")
.append(" Node ID: " + super.getNodeId() + "\n")
.append(" Projection Variables: " + projectedVars + "\n")
.append(" Variable Order: " + super.getVariableOrder() + "\n")
.append(" Child Node ID: " + childNodeId + "\n")
.append(" Parent Node ID: " + parentNodeId + "\n")
.append("}")
.toString();
}
/**
* Creates a new {@link Builder} for this class.
*
* @param nodeId - The ID the Fluo app uses to reference this node. (not null)
* @return A new {@link Builder} for this class.
*/
public static Builder builder(final String nodeId) {
return new Builder(nodeId);
}
/**
* Builds instances of {@link ProjectionMetadata}.
*/
@DefaultAnnotation(NonNull.class)
public static final class Builder implements CommonNodeMetadata.Builder {
private String nodeId;
private VariableOrder varOrder;
private String childNodeId;
private String parentNodeId;
private VariableOrder projectedVars;
/**
* Constructs an instance of {@link Builder}.
*
* @param nodeId - The ID the Fluo app uses to reference this node. (not null)
*/
public Builder(final String nodeId) {
this.nodeId = checkNotNull(nodeId);
}
public String getNodeId() {
return nodeId;
}
/**
* Set the variable order of binding sets that are emitted by this node.
*
* @param varOrder - The order in which result values are written to the row to identify this result
* @return This builder so that method invocations may be chained.
*/
public Builder setVarOrder(@Nullable final VariableOrder varOrder) {
this.varOrder = varOrder;
return this;
}
/**
* @return the variable order of binding sets that are emitted by this node
*/
public VariableOrder getVariableOrder() {
return varOrder;
}
/**
* Set the node whose results are projected to the query's SELECT variables.
*
* @param childNodeId - The node whose results are projected to the query's SELECT variables.
* @return This builder so that method invocations may be chained.
*/
public Builder setChildNodeId(@Nullable final String childNodeId) {
this.childNodeId = childNodeId;
return this;
}
public String getChildNodeId() {
return childNodeId;
}
/**
* Set the the parent node of this projection node.
*
* @param parentNodeId - The parent node of this projection node
* @return This builder so that method invocations may be chained.
*/
public Builder setParentNodeId(@Nullable final String parentNodeId) {
this.parentNodeId = parentNodeId;
return this;
}
public String getParentNodeId() {
return parentNodeId;
}
/**
* @param varOrder - Variables that results are projected onto
* @return This builder so that method invocations may be chained.
*/
public Builder setProjectedVars(VariableOrder projectedVars) {
this.projectedVars = projectedVars;
return this;
}
/**
* @return The variables that results are projected onto
*/
public VariableOrder getProjectionVars() {
return projectedVars;
}
/**
* @return An instance of {@link ProjectionMetadata} built using this builder's values.
*/
public ProjectionMetadata build() {
return new ProjectionMetadata(nodeId, varOrder, childNodeId, parentNodeId, projectedVars);
}
}
}