Blame view

src/main/java/fr/plil/sio/persistence/api/RightService.java 1.6 KB
fd5e74ca   jcartign   First student ver...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
  package fr.plil.sio.persistence.api;
  
  import java.util.List;
  
  public interface RightService {
  
      /**
       * Create a parent right with a specific name in the database.
       * It is possible that two rights has the same name.
       *
       * @param name the name of the right
       * @throws IllegalArgumentException if name is null
       */
      Right create(String name);
  
      /**
       * Create a sibling right attached to a parent right with a specific name in the database.
       * It is possible that two rights has the same name.
       *
       * @param name   the name of the right
       * @param parent the parent right
       * @throws IllegalArgumentException if name or parent is null, or if parent does not exist in the database.
       */
      Right create(String name, Right parent);
  
      /**
       * Delete a right in the database. Delete sibling rights if present.
       *
       * @param right the right to delete
       * @return true if right has been deleted, false else.
       * @throws IllegalArgumentException if right is null.
       */
      boolean delete(Right right);
  
      /**
       * Find a list of rights in the database based on their name.
       *
       * @param name the name of the rights to search for.
       * @return A list of rights, eventually empty.
       * @throws IllegalArgumentException if name is null
       */
      List<Right> findByName(String name);
  
      /**
       * Find a right in the database based on its id.
       *
       * @param id the name of the right to search for.
       * @return an instance of the right if found, else null.
       * @throws IllegalArgumentException if id is null
       */
      Right findOne(Long id);
  }