View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *   http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  package org.eclipse.aether.util.graph.version;
20  
21  import java.util.Arrays;
22  import java.util.Collection;
23  
24  import org.eclipse.aether.RepositoryException;
25  import org.eclipse.aether.collection.DependencyCollectionContext;
26  import org.eclipse.aether.collection.VersionFilter;
27  
28  /**
29   * A version filter that combines multiple version filters into a chain where each filter gets invoked one after the
30   * other, thereby accumulating their filtering effects.
31   */
32  public final class ChainedVersionFilter implements VersionFilter {
33  
34      private final VersionFilter[] filters;
35  
36      private int hashCode;
37  
38      /**
39       * Chains the specified version filters.
40       *
41       * @param filter1 The first version filter, may be {@code null}.
42       * @param filter2 The second version filter, may be {@code null}.
43       * @return The chained version filter or {@code null} if both input filters are {@code null}.
44       */
45      public static VersionFilter newInstance(VersionFilter filter1, VersionFilter filter2) {
46          if (filter1 == null) {
47              return filter2;
48          }
49          if (filter2 == null) {
50              return filter1;
51          }
52          return new ChainedVersionFilter(new VersionFilter[] {filter1, filter2});
53      }
54  
55      /**
56       * Chains the specified version filters.
57       *
58       * @param filters The version filters to chain, must not be {@code null} or contain {@code null}.
59       * @return The chained version filter or {@code null} if the input array is empty.
60       */
61      public static VersionFilter newInstance(VersionFilter... filters) {
62          if (filters.length <= 1) {
63              if (filters.length <= 0) {
64                  return null;
65              }
66              return filters[0];
67          }
68          return new ChainedVersionFilter(filters.clone());
69      }
70  
71      /**
72       * Chains the specified version filters.
73       *
74       * @param filters The version filters to chain, must not be {@code null} or contain {@code null}.
75       * @return The chained version filter or {@code null} if the input collection is empty.
76       */
77      public static VersionFilter newInstance(Collection<? extends VersionFilter> filters) {
78          if (filters.size() <= 1) {
79              if (filters.isEmpty()) {
80                  return null;
81              }
82              return filters.iterator().next();
83          }
84          return new ChainedVersionFilter(filters.toArray(new VersionFilter[0]));
85      }
86  
87      private ChainedVersionFilter(VersionFilter[] filters) {
88          this.filters = filters;
89      }
90  
91      @Override
92      public void filterVersions(VersionFilterContext context) throws RepositoryException {
93          for (int i = 0, n = filters.length; i < n && context.getCount() > 0; i++) {
94              filters[i].filterVersions(context);
95          }
96      }
97  
98      @Override
99      public VersionFilter deriveChildFilter(DependencyCollectionContext context) {
100         VersionFilter[] children = null;
101         int removed = 0;
102         for (int i = 0, n = filters.length; i < n; i++) {
103             VersionFilter child = filters[i].deriveChildFilter(context);
104             if (children != null) {
105                 children[i - removed] = child;
106             } else if (child != filters[i]) {
107                 children = new VersionFilter[filters.length];
108                 System.arraycopy(filters, 0, children, 0, i);
109                 children[i - removed] = child;
110             }
111             if (child == null) {
112                 removed++;
113             }
114         }
115         if (children == null) {
116             return this;
117         }
118         if (removed > 0) {
119             int count = filters.length - removed;
120             if (count <= 0) {
121                 return null;
122             }
123             if (count == 1) {
124                 return children[0];
125             }
126             VersionFilter[] tmp = new VersionFilter[count];
127             System.arraycopy(children, 0, tmp, 0, count);
128             children = tmp;
129         }
130         return new ChainedVersionFilter(children);
131     }
132 
133     @Override
134     public boolean equals(Object obj) {
135         if (this == obj) {
136             return true;
137         } else if (null == obj || !getClass().equals(obj.getClass())) {
138             return false;
139         }
140 
141         ChainedVersionFilter that = (ChainedVersionFilter) obj;
142         return Arrays.equals(filters, that.filters);
143     }
144 
145     @Override
146     public int hashCode() {
147         if (hashCode == 0) {
148             int hash = getClass().hashCode();
149             hash = hash * 31 + Arrays.hashCode(filters);
150             hashCode = hash;
151         }
152         return hashCode;
153     }
154 }