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.spi.locator;
20  
21  import java.util.List;
22  
23  /**
24   * A simple infrastructure to programmatically wire the various components of the repository system together when it is
25   * used outside of an IoC container. Once a concrete implementation of a service locator has been setup, clients could
26   * use
27   *
28   * <pre>
29   * RepositorySystem repoSystem = serviceLocator.getService( RepositorySystem.class );
30   * </pre>
31   *
32   * to acquire the repository system. Components that implement {@link Service} will be given an opportunity to acquire
33   * further components from the locator, thereby allowing to create the complete object graph of the repository system.
34   *
35   * @deprecated Use of out-of-the-box DI implementation recommended, or, as alternative new supplier from
36   * module {@code maven-resolver-supplier}.
37   */
38  @Deprecated
39  public interface ServiceLocator {
40  
41      /**
42       * Gets an instance of the specified service.
43       *
44       * @param <T> The service type.
45       * @param type The interface describing the service, must not be {@code null}.
46       * @return The service instance or {@code null} if the service could not be located/initialized.
47       */
48      <T> T getService(Class<T> type);
49  
50      /**
51       * Gets all available instances of the specified service.
52       *
53       * @param <T> The service type.
54       * @param type The interface describing the service, must not be {@code null}.
55       * @return The (read-only) list of available service instances, never {@code null}.
56       */
57      <T> List<T> getServices(Class<T> type);
58  }