View Javadoc
1   package org.eclipse.aether.transform;
2   
3   /*
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   * 
12   *  http://www.apache.org/licenses/LICENSE-2.0
13   * 
14   * Unless required by applicable law or agreed to in writing,
15   * software distributed under the License is distributed on an
16   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17   * KIND, either express or implied.  See the License for the
18   * specific language governing permissions and limitations
19   * under the License.
20   */
21  
22  import java.util.Collection;
23  
24  import org.eclipse.aether.artifact.Artifact;
25  
26  /**
27   * Manager the FileTransformers 
28   * 
29   * @author Robert Scholte
30   * @since 1.3.0
31   * @deprecated Without any direct replacement for now. This API is OOM-prone, and also lacks a lot of context about
32   * transforming.
33   */
34  @Deprecated
35  public interface FileTransformerManager
36  {
37      /**
38       * <p>
39       * All transformers for this specific artifact. Be aware that if you want to create additional files, but also want
40       * to the original to be deployed, you must add an explicit transformer for that file too (one that doesn't
41       * transform the artifact and data).
42       * </p>
43       * 
44       * <p><strong>IMPORTANT</strong> When using a fileTransformer, the content of the file is stored in memory to ensure
45       * that file content and checksums stay in sync!
46       * </p>
47       * 
48       * @param artifact the artifact
49       * @return a collection of FileTransformers to apply on the artifact, never {@code null}
50       */
51      Collection<FileTransformer> getTransformersForArtifact( Artifact artifact );
52  }