View Javadoc
1   /*
2    * *************************************************************************************************************************************************************
3    *
4    * blueHour: open source accounting
5    * http://tidalwave.it/projects/bluehour
6    *
7    * Copyright (C) 2013 - 2024 by Tidalwave s.a.s. (http://tidalwave.it)
8    *
9    * *************************************************************************************************************************************************************
10   *
11   * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
12   * You may obtain a copy of the License at
13   *
14   *     http://www.apache.org/licenses/LICENSE-2.0
15   *
16   * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
17   * CONDITIONS OF ANY KIND, either express or implied.  See the License for the specific language governing permissions and limitations under the License.
18   *
19   * *************************************************************************************************************************************************************
20   *
21   * git clone https://bitbucket.org/tidalwave/bluehour-src
22   * git clone https://github.com/tidalwave-it/bluehour-src
23   *
24   * *************************************************************************************************************************************************************
25   */
26  package it.tidalwave.accounting.model;
27  
28  import javax.annotation.Nonnull;
29  import it.tidalwave.accounting.model.Project.Builder;
30  import it.tidalwave.util.Id;
31  import it.tidalwave.util.spi.ExtendedFinderSupport;
32  
33  /***************************************************************************************************************************************************************
34   *
35   * @author  Fabrizio Giudici
36   *
37   **************************************************************************************************************************************************************/
38  public interface CustomerRegistry
39    {
40      /***********************************************************************************************************************************************************
41       *
42       **********************************************************************************************************************************************************/
43      public static interface Finder extends it.tidalwave.util.Finder<Customer>,
44                                             ExtendedFinderSupport<Customer, CustomerRegistry.Finder>
45        {
46          @Nonnull
47          public Finder withId (@Nonnull Id id);
48        }
49  
50      /***********************************************************************************************************************************************************
51       * Returns a {@link Finder} for finding {@link Customer}s.
52       *
53       * @return  the finder
54       **********************************************************************************************************************************************************/
55      @Nonnull
56      public Finder findCustomers();
57  
58      /***********************************************************************************************************************************************************
59       * Returns a {@link Builder} for adding a {@link Customer} to the registry.
60       *
61       * @return  the builder
62       **********************************************************************************************************************************************************/
63      @Nonnull
64      public Customer.Builder addCustomer();
65    }