[ https://issues.apache.org/jira/browse/TINKERPOP-2978?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17778752#comment-17778752 ]
ASF GitHub Bot commented on TINKERPOP-2978: ------------------------------------------- vkagamlyk commented on code in PR #2302: URL: https://github.com/apache/tinkerpop/pull/2302#discussion_r1368982131 ########## gremlin-core/src/main/java/org/apache/tinkerpop/gremlin/process/traversal/step/map/TraversalMergeStep.java: ########## @@ -0,0 +1,132 @@ +/* + * 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.tinkerpop.gremlin.process.traversal.step.map; + +import org.apache.tinkerpop.gremlin.process.traversal.Traversal; +import org.apache.tinkerpop.gremlin.process.traversal.Traverser; +import org.apache.tinkerpop.gremlin.process.traversal.step.TraversalParent; +import org.apache.tinkerpop.gremlin.process.traversal.traverser.TraverserRequirement; +import org.apache.tinkerpop.gremlin.process.traversal.util.ListFunction; +import org.apache.tinkerpop.gremlin.process.traversal.util.TraversalUtil; +import org.apache.tinkerpop.gremlin.structure.util.StringFactory; +import org.apache.tinkerpop.gremlin.util.iterator.IteratorUtils; + +import java.util.ArrayList; +import java.util.Arrays; +import java.util.Collection; +import java.util.Collections; +import java.util.HashMap; +import java.util.HashSet; +import java.util.Iterator; +import java.util.List; +import java.util.Map; +import java.util.Objects; +import java.util.Set; + +/** + * A map step that returns the merger of the traverser and the provided arguments without duplicates. This is commonly + * known as a union. + */ +public final class TraversalMergeStep<S, E> extends ScalarMapStep<S, E> implements TraversalParent, ListFunction { + private Traversal.Admin<S, E> valueTraversal; + private Object parameterItems; + public TraversalMergeStep(final Traversal.Admin traversal, final Object values) { + super(traversal); + + if (values instanceof Traversal) { + valueTraversal = integrateChild(((Traversal<S, E>) values).asAdmin()); + } else { + parameterItems = values; + } + } + + @Override + public String getStepName() { return "merge"; } + + @Override + protected E map(final Traverser.Admin<S> traverser) { + S incoming = traverser.get(); + + Map mapA = (incoming instanceof Map) ? (Map) incoming : null; + if (mapA != null) { + final Object mapB = (valueTraversal != null) ? TraversalUtil.apply(traverser, valueTraversal) : parameterItems; + if (!(mapB instanceof Map)) { + throw new IllegalArgumentException( + String.format( + "%s step expected provided argument to evaluate to a Map, encountered %s", + getStepName(), + mapB.getClass())); + } + + final Map mergedMap = new HashMap(mapA); + mergedMap.putAll((Map) mapB); + return (E) mergedMap; + } else { + final Collection listA = convertTraverserToCollection(traverser); + + if (parameterItems instanceof Map) { + throw new IllegalArgumentException(getStepName() + " step type mismatch: expected argument to be Iterable but got Map"); + } + final Collection listB = + (null != valueTraversal) + ? convertTraversalToCollection(traverser, valueTraversal) + : convertArgumentToCollection(parameterItems); + + final Set elements = new HashSet(); + + elements.addAll(listA); + elements.addAll(listB); + + return (E) elements; + } + } + + @Override + public List<Traversal.Admin<S, E>> getLocalChildren() { + return (null == valueTraversal) ? Collections.emptyList() : Collections.singletonList(valueTraversal); + } + + @Override + public Set<TraverserRequirement> getRequirements() { return this.getSelfAndChildRequirements(); } + + @Override + public void setTraversal(final Traversal.Admin<?, ?> parentTraversal) { + super.setTraversal(parentTraversal); + if (valueTraversal != null) { this.integrateChild(this.valueTraversal); } + } + + @Override + public TraversalMergeStep<S, E> clone() { + final TraversalMergeStep<S, E> clone = (TraversalMergeStep<S, E>) super.clone(); + if (null != this.valueTraversal) { + clone.valueTraversal = this.valueTraversal.clone(); + } else if (this.parameterItems instanceof Map) { Review Comment: Why different handling depends on type of `parameterItems`? > Add List Manipulation Steps to Gremlin > -------------------------------------- > > Key: TINKERPOP-2978 > URL: https://issues.apache.org/jira/browse/TINKERPOP-2978 > Project: TinkerPop > Issue Type: Improvement > Components: language > Reporter: Cole Greer > Priority: Major > > Today Gremlin requires that users fall back to closures to handle many common > list manipulation options that users want to do on data in the graph. This > is a problem for many users as many of the providers prevent the use of > closures due to the security risks so for these users there is no way to > manipulate lists directly. > A full list of proposed functions and semantics is detailed here: > https://github.com/apache/tinkerpop/blob/3.7.0/docs/src/dev/future/proposal-3-remove-closures.asciidoc -- This message was sent by Atlassian Jira (v8.20.10#820010)