Java tutorial
/* * Copyright (c) 2015 Daniel Jabry * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.github.djabry.platform.rest; import com.github.djabry.platform.domain.api.SecurityToken; import com.github.djabry.platform.domain.api.User; import com.github.djabry.platform.service.api.*; import com.github.djabry.platform.service.security.annotations.Authenticate; import com.github.djabry.platform.service.security.annotations.ReadOwn; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.*; import javax.validation.constraints.NotNull; /** * Created by djabry on 09/01/15. */ @RestController public class AuthenticationController implements AuthenticationService { @Autowired private SpringAuthenticationService authenticationService; /** * @param request The credentials of the user attempting to log in * @return A security token on success, null otherwise */ @Override @ResponseStatus(HttpStatus.OK) @RequestMapping(name = "/login", method = RequestMethod.POST) public SecurityToken login(@NotNull LoginRequest request) { return this.authenticationService.login(request); } /** * @param request The request containing the user credentials and details * @return A security token on success, null otherwise */ @Override @ResponseStatus(HttpStatus.ACCEPTED) @ResponseBody @RequestMapping(name = "/signup", method = RequestMethod.POST) public SecurityToken signUp(@NotNull SignUpRequest request) { return this.authenticationService.signUp(request); } /** * @param request The request to change the password * @return True if the password was changed successfully */ @Override @ResponseStatus(HttpStatus.CREATED) @RequestMapping(name = "/changepassword", method = RequestMethod.POST) public boolean changePassword(@NotNull ChangePasswordRequest request) { return this.authenticationService.changePassword(request); } /** * Request a token to reset the password of the current user * * @param request The request to reset the password */ @Override @ResponseStatus(HttpStatus.OK) @RequestMapping(name = "/resetpassword", method = RequestMethod.POST) public SecurityToken requestPasswordResetToken(@NotNull ResetPasswordRequest request) { return this.authenticationService.requestPasswordResetToken(request); } /** * @return The current logged in user */ @Override @ResponseBody @RequestMapping(name = "/user", method = RequestMethod.GET) @ReadOwn public User getCurrentUser() { return this.authenticationService.getCurrentUser(); } /** * Log out of the current account */ @Override @ResponseStatus(HttpStatus.OK) @RequestMapping(name = "/logout", method = RequestMethod.GET) @Authenticate public boolean logout() { return this.authenticationService.logout(); } }