feature: RoleViewController erweitert (WIP)

Thomas Ziemer
1 parent 6a9824ee
Showing 1 changed file with 128 additions and 2 deletions
src/main/java/net/ziemers/swxercise/ui/RoleViewController.java
@@ -26,12 +26,12 @@ public class RoleViewController {
     private RoleService roleService;
     /**
-     * Liefert alle Rollen-Objekte zurück.
+     * Liefert alle Role-Objekte zurück.
      * <p>
      * Aufruf:
      * GET http://localhost:8080/swxercise/rest/v1/roles
      *
-     * @return die Rollen-Objekte, oder ein leeres JSON-Array, falls keine existieren.
+     * @return die Role-Objekte, oder ein leeres JSON-Array, falls keine existieren.
      */
     @GET
     @Path("v1/roles")
@@ -42,6 +42,43 @@ public class RoleViewController {
     }
     /**
+     * Liefert das Role-Objekt mit der gewünschten Id zurück.
+     * <p>
+     * Aufruf:
+     * GET http://localhost:8080/swxercise/rest/v1/role/42
+     *
+     * @param id die Id des gewünschten Role-Objekts
+     * @return das Role-Objekt als JSON, oder <code>null</code>, falls keines existiert.
+     */
+    @GET
+    @Path("v1/role/{id}")
+    @Produces(MediaType.APPLICATION_JSON)
+    @RolesAllowed(RightState.Constants.ADMIN)
+    public User getRole(@PathParam("id") Long id) {
+        // TODO noch zu implementieren
+        //return roleService.findRole(id);
+        return null;
+    }
+
+    /**
+     * Liefert das Role-Objekt des zurzeit angemeldeten Benutzers zurück.
+     * <p>
+     * Aufruf:
+     * GET http://localhost:8080/swxercise/rest/v1/role
+     *
+     * @return das Role-Objekt als JSON, oder <code>null</code>, falls keines existiert.
+     */
+    @GET
+    @Path("v1/role")
+    @Produces(MediaType.APPLICATION_JSON)
+    @RolesAllowed(RightState.Constants.LOGGED_IN)
+    public User getRole() {
+      // TODO noch zu implmentieren
+      //return userService.findUser();
+      return null;
+    }
+
+    /**
      * Erstellt ein neues Role-Objekt mit den gewünschten Eigenschaften, welche mittels {@link RoleDto} definiert werden.
      * <p>
      * Aufruf:
@@ -64,6 +101,95 @@ public class RoleViewController {
     }
     /**
+     * Aktualisiert das Role-Objekt mit der gewünschten Id mit den Eigenschaften,
+     * welche mittels {@link RoleDto} definiert werden. Der Pfadparameter wird
+     * als erstes ge'marshal't, das DTO im Post-Content danach (REST-Konvention).
+     * <p>
+     * Aufruf:
+     * PUT http://localhost:8080/swxercise/rest/v1/role/42
+     *
+     * @param id  die Id des zu aktualisierenden Role-Objekts
+     * @param dto das mittels der als JSON-Objekt übergebenenen Eigenschaften zu füllende {@link RoleDto}
+     * @return ein {@link ResponseState}-Objekt mit den Ergebnisinformationen des Aufrufs.
+     */
+    @PUT
+    @Path("v1/role/{id}")
+    @Consumes(MediaType.APPLICATION_JSON)
+    @Produces(MediaType.APPLICATION_JSON)
+    @RolesAllowed(RightState.Constants.ADMIN)
+    public RestResponse updateRole(@PathParam("id") Long id, RoleDto dto) {
+        // TODO noch zu implementieren
+        //if (roleService.updateRole(id, dto)) {
+        //    return new RestResponse();
+        //}
+        return new RestResponse(ResponseState.FAILED);
+    }
+
+    /**
+     * Aktualisiert das Role-Objekt des zurzeit angemeldeten Benutzers mit den
+     * Eigenschaften, welche mittels {@link RoleDto} definiert werden. Der
+     * Pfadparameter wird als erstes ge'marshal't, das DTO im Post-Content
+     * danach (REST-Konvention).
+     * <p>
+     * Aufruf:
+     * PUT http://localhost:8080/swxercise/rest/v1/role
+     *
+     * @param dto das mittels der als JSON-Objekt übergebenenen Eigenschaften zu füllende {@link RoleDto}
+     * @return ein {@link ResponseState}-Objekt mit den Ergebnisinformationen des Aufrufs.
+     */
+    @PUT
+    @Path("v1/role")
+    @Consumes(MediaType.APPLICATION_JSON)
+    @Produces(MediaType.APPLICATION_JSON)
+    @RolesAllowed(RightState.Constants.LOGGED_IN)
+    public RestResponse updateRole(RoleDto dto) {
+        // TODO noch zu implementieren
+        //if (roleService.updateRole(dto)) {
+        //    return new RestResponse();
+        //}
+        return new RestResponse(ResponseState.FAILED);
+    }
+
+    /**
+     * Löscht das Role-Objekt mit der gewünschten Id.
+     * <p>
+     * Aufruf:
+     * DELETE http://localhost:8080/swxercise/rest/v1/role/42
+     *
+     * @param id die Id des gewünschten Role-Objekts
+     * @return ein {@link ResponseState}-Objekt mit den Ergebnisinformationen des Aufrufs.
+     */
+    @DELETE
+    @Path("v1/role/{id}")
+    @Produces(MediaType.APPLICATION_JSON)
+    @RolesAllowed(RightState.Constants.ADMIN)
+    public RestResponse deletetRole(@PathParam("id") Long id) {
+        // TODO noch zu implementieren
+        //roleService.deleteRole(id);
+        return new RestResponse();
+    }
+
+    /**
+     * Löscht das Role-Objekt des zurzeit angemeldeten Benutzers.
+     * <p>
+     * Aufruf:
+     * DELETE http://localhost:8080/swxercise/rest/v1/role
+     *
+     * @return ein {@link ResponseState}-Objekt mit den Ergebnisinformationen des Aufrufs.
+     */
+    @DELETE
+    @Path("v1/role")
+    @Produces(MediaType.APPLICATION_JSON)
+    @RolesAllowed(RightState.Constants.LOGGED_IN)
+    public RestResponse deleteRole() {
+        // TODO noch zu implementieren
+        //if (roleService.deleteRole()) {
+        //    return new RestResponse();
+        //}
+        return new RestResponse(ResponseState.FAILED);
+    }
+
+    /**
      * Verknüpft eine Rolle (die "Kindrolle") mit einer anderen Rolle (der "Vaterrolle").
      *
      * @param childName die Kindrolle, welche mit der Vaterrolle verknüpft werden soll