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.apache.maven.plugin;
20  
21  import javax.inject.Named;
22  import javax.inject.Singleton;
23  
24  import java.util.ArrayList;
25  import java.util.Collections;
26  import java.util.List;
27  import java.util.Map;
28  import java.util.Objects;
29  import java.util.concurrent.ConcurrentHashMap;
30  
31  import org.apache.maven.RepositoryUtils;
32  import org.apache.maven.artifact.Artifact;
33  import org.apache.maven.model.Plugin;
34  import org.apache.maven.project.MavenProject;
35  import org.codehaus.plexus.classworlds.realm.ClassRealm;
36  import org.codehaus.plexus.classworlds.realm.NoSuchRealmException;
37  import org.codehaus.plexus.personality.plexus.lifecycle.phase.Disposable;
38  import org.eclipse.aether.RepositorySystemSession;
39  import org.eclipse.aether.graph.DependencyFilter;
40  import org.eclipse.aether.repository.LocalRepository;
41  import org.eclipse.aether.repository.RemoteRepository;
42  import org.eclipse.aether.repository.WorkspaceRepository;
43  
44  /**
45   * Default PluginCache implementation. Assumes cached data does not change.
46   */
47  @Named
48  @Singleton
49  public class DefaultPluginRealmCache implements PluginRealmCache, Disposable {
50      /**
51       * CacheKey
52       */
53      protected static class CacheKey implements Key {
54  
55          private final Plugin plugin;
56  
57          private final WorkspaceRepository workspace;
58  
59          private final LocalRepository localRepo;
60  
61          private final List<RemoteRepository> repositories;
62  
63          private final ClassLoader parentRealm;
64  
65          private final Map<String, ClassLoader> foreignImports;
66  
67          private final DependencyFilter filter;
68  
69          private final int hashCode;
70  
71          public CacheKey(
72                  Plugin plugin,
73                  ClassLoader parentRealm,
74                  Map<String, ClassLoader> foreignImports,
75                  DependencyFilter dependencyFilter,
76                  List<RemoteRepository> repositories,
77                  RepositorySystemSession session) {
78              this.plugin = plugin.clone();
79              this.workspace = RepositoryUtils.getWorkspace(session);
80              this.localRepo = session.getLocalRepository();
81              this.repositories = new ArrayList<>(repositories.size());
82              for (RemoteRepository repository : repositories) {
83                  if (repository.isRepositoryManager()) {
84                      this.repositories.addAll(repository.getMirroredRepositories());
85                  } else {
86                      this.repositories.add(repository);
87                  }
88              }
89              this.parentRealm = parentRealm;
90              this.foreignImports = (foreignImports != null) ? foreignImports : Collections.emptyMap();
91              this.filter = dependencyFilter;
92  
93              int hash = 17;
94              hash = hash * 31 + CacheUtils.pluginHashCode(plugin);
95              hash = hash * 31 + Objects.hashCode(workspace);
96              hash = hash * 31 + Objects.hashCode(localRepo);
97              hash = hash * 31 + RepositoryUtils.repositoriesHashCode(repositories);
98              hash = hash * 31 + Objects.hashCode(parentRealm);
99              hash = hash * 31 + this.foreignImports.hashCode();
100             hash = hash * 31 + Objects.hashCode(dependencyFilter);
101             this.hashCode = hash;
102         }
103 
104         @Override
105         public String toString() {
106             return plugin.getId();
107         }
108 
109         @Override
110         public int hashCode() {
111             return hashCode;
112         }
113 
114         @Override
115         public boolean equals(Object o) {
116             if (o == this) {
117                 return true;
118             }
119 
120             if (o instanceof CacheKey that) {
121                 return parentRealm == that.parentRealm
122                         && CacheUtils.pluginEquals(plugin, that.plugin)
123                         && Objects.equals(workspace, that.workspace)
124                         && Objects.equals(localRepo, that.localRepo)
125                         && RepositoryUtils.repositoriesEquals(this.repositories, that.repositories)
126                         && Objects.equals(filter, that.filter)
127                         && Objects.equals(foreignImports, that.foreignImports);
128             } else {
129                 return false;
130             }
131         }
132     }
133 
134     protected final Map<Key, CacheRecord> cache = new ConcurrentHashMap<>();
135 
136     public Key createKey(
137             Plugin plugin,
138             ClassLoader parentRealm,
139             Map<String, ClassLoader> foreignImports,
140             DependencyFilter dependencyFilter,
141             List<RemoteRepository> repositories,
142             RepositorySystemSession session) {
143         return new CacheKey(plugin, parentRealm, foreignImports, dependencyFilter, repositories, session);
144     }
145 
146     public CacheRecord get(Key key) {
147         return cache.get(key);
148     }
149 
150     @Override
151     public CacheRecord get(Key key, PluginRealmSupplier supplier)
152             throws PluginResolutionException, PluginContainerException {
153         try {
154             return cache.computeIfAbsent(key, k -> {
155                 try {
156                     return supplier.load();
157                 } catch (PluginResolutionException | PluginContainerException e) {
158                     throw new RuntimeException(e);
159                 }
160             });
161         } catch (RuntimeException e) {
162             if (e.getCause() instanceof PluginResolutionException pluginResolutionException) {
163                 throw pluginResolutionException;
164             }
165             if (e.getCause() instanceof PluginContainerException pluginContainerException) {
166                 throw pluginContainerException;
167             }
168             throw e;
169         }
170     }
171 
172     public CacheRecord put(Key key, ClassRealm pluginRealm, List<Artifact> pluginArtifacts) {
173         Objects.requireNonNull(pluginRealm, "pluginRealm cannot be null");
174         Objects.requireNonNull(pluginArtifacts, "pluginArtifacts cannot be null");
175 
176         if (cache.containsKey(key)) {
177             throw new IllegalStateException("Duplicate plugin realm for plugin " + key);
178         }
179 
180         CacheRecord record = new CacheRecord(pluginRealm, pluginArtifacts);
181 
182         cache.put(key, record);
183 
184         return record;
185     }
186 
187     public void flush() {
188         for (CacheRecord record : cache.values()) {
189             ClassRealm realm = record.getRealm();
190             try {
191                 realm.getWorld().disposeRealm(realm.getId());
192             } catch (NoSuchRealmException e) {
193                 // ignore
194             }
195         }
196         cache.clear();
197     }
198 
199     protected static int pluginHashCode(Plugin plugin) {
200         return CacheUtils.pluginHashCode(plugin);
201     }
202 
203     protected static boolean pluginEquals(Plugin a, Plugin b) {
204         return CacheUtils.pluginEquals(a, b);
205     }
206 
207     public void register(MavenProject project, Key key, CacheRecord record) {
208         // default cache does not track plugin usage
209     }
210 
211     public void dispose() {
212         flush();
213     }
214 }