1 files changed, 156 insertions, 0 deletions
diff --git a/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/Union.java b/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/Union.java
new file mode 100644
index 00000000..e2f2f9f2
--- /dev/null
+++ b/framework/src/ant/apache-ant-1.9.6/src/main/org/apache/tools/ant/types/resources/Union.java
@@ -0,0 +1,156 @@
+/*
+ *  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.tools.ant.types.resources;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Set;
+
+import org.apache.tools.ant.Project;
+import org.apache.tools.ant.types.Resource;
+import org.apache.tools.ant.types.ResourceCollection;
+
+/**
+ * ResourceCollection representing the union of multiple nested ResourceCollections.
+ * @since Ant 1.7
+ */
+public class Union extends BaseResourceCollectionContainer {
+
+    /**
+     * Static convenience method to union an arbitrary set of Resources.
+     * @param rc a ResourceCollection.
+     * @return a Union.
+     */
+    public static Union getInstance(ResourceCollection rc) {
+        return rc instanceof Union ? (Union) rc : new Union(rc);
+    }
+
+    /**
+     * Default constructor.
+     */
+    public Union() {
+    }
+
+    /**
+     * Create a new Union.
+     * @param project owning Project
+     */
+    public Union(Project project) {
+        super(project);
+    }
+
+    /**
+     * Convenience constructor.
+     * @param rc the ResourceCollection to add.
+     */
+    public Union(ResourceCollection rc) {
+        this(Project.getProject(rc), rc);
+    }
+
+    /**
+     * Convenience constructor.
+     * @param project owning Project
+     * @param rc the ResourceCollection to add.
+     */
+    public Union(Project project, ResourceCollection rc) {
+        super(project);
+        add(rc);
+    }
+
+    /**
+     * Returns all Resources in String format. Provided for
+     * convenience in implementing Path.
+     * @return String array of Resources.
+     */
+    public String[] list() {
+        if (isReference()) {
+            return getCheckedRef(Union.class, getDataTypeName()).list();
+        }
+        final Collection<String> result = getAllToStrings();
+        return result.toArray(new String[result.size()]);
+    }
+
+    /**
+     * Convenience method.
+     * @return Resource[]
+     */
+    public Resource[] listResources() {
+        if (isReference()) {
+            return getCheckedRef(Union.class, getDataTypeName()).listResources();
+        }
+        final Collection<Resource> result = getAllResources();
+        return result.toArray(new Resource[result.size()]);
+    }
+
+    /**
+     * Unify the contained Resources.
+     * @return a Collection of Resources.
+     */
+    protected Collection<Resource> getCollection() {
+        return getAllResources();
+    }
+
+    /**
+     * Unify the contained Resources.
+     * @param asString indicates whether the resulting Collection
+     *        should contain Strings instead of Resources.
+     * @return a Collection of Resources.
+     */
+    @Deprecated
+    @SuppressWarnings("unchecked")
+    protected <T> Collection<T> getCollection(boolean asString) { // TODO untypable
+        return asString ? (Collection<T>) getAllToStrings() : (Collection<T>) getAllResources();
+    }
+
+    /**
+     * Get a collection of strings representing the unified resource set (strings may duplicate).
+     * @return Collection<String>
+     */
+    protected Collection<String> getAllToStrings() {
+        final Set<Resource> allResources = getAllResources();
+        final ArrayList<String> result = new ArrayList<String>(allResources.size());
+        for (Resource r : allResources) {
+            result.add(r.toString());
+        }
+        return result;
+    }
+
+    /**
+     * Get the unified set of contained Resources.
+     * @return Set<Resource>
+     */
+    protected Set<Resource> getAllResources() {
+        final List<ResourceCollection> resourceCollections = getResourceCollections();
+        if (resourceCollections.isEmpty()) {
+            return Collections.emptySet();
+        }
+        final LinkedHashSet<Resource> result = new LinkedHashSet<Resource>(
+                resourceCollections.size() * 2);
+        for (ResourceCollection resourceCollection : resourceCollections) {
+            for (Resource r : resourceCollection) {
+                result.add(r);
+            }
+        }
+        return result;
+    }
+
+}
+