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.api.services;
20  
21  import java.util.function.Supplier;
22  
23  /**
24   * Caches auxiliary data used during model building like already processed raw/effective models. The data in the cache
25   * is meant for exclusive consumption by the model builder and is opaque to the cache implementation. The cache key is
26   * formed by a combination of group id, artifact id, version and tag. The first three components generally refer to the
27   * identity of a model. The tag allows for further classification of the associated data on the sole discretion of the
28   * model builder.
29   *
30   */
31  public interface ModelCache {
32  
33      <T> T computeIfAbsent(String groupId, String artifactId, String version, String tag, Supplier<T> data);
34  
35      <T> T computeIfAbsent(Source path, String tag, Supplier<T> data);
36  }