securesocial.core.java.BaseUserService Maven / Gradle / Ivy
/**
* Copyright 2012-2014 Jorge Aliss (jaliss at gmail dot com) - twitter: @jaliss
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* 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 CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package securesocial.core.java;
import play.libs.Scala;
import scala.Option;
import scala.concurrent.Future;
import securesocial.core.BasicProfile;
import securesocial.core.PasswordInfo;
import securesocial.core.providers.MailToken;
import securesocial.core.services.SaveMode;
import securesocial.core.services.UserService;
import java.util.concurrent.CompletionStage;
import java.util.function.Function;
import static scala.compat.java8.FutureConverters.toScala;
/**
* A base user service for developers that want to write their UserService in Java.
*
* Note: You need to implement all the doXXX methods below.
*/
public abstract class BaseUserService implements UserService {
protected BaseUserService() {
}
/**
* Finds an Identity that maches the specified id
*
* @return an optional user
*/
@Override
public Future> find(String providerId, String userId) {
return toScala(doFind(providerId, userId).thenApplyAsync(new Function>() {
@Override
public Option apply(BasicProfile user) {
return Scala.Option(user);
}
}));
}
/**
* Finds an Identity by email and provider id.
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation.
*
* @param email - the user email
* @param providerId - the provider id
* @return
*/
@Override
public Future> findByEmailAndProvider(String email, String providerId) {
return toScala(doFindByEmailAndProvider(email, providerId).thenApplyAsync(new Function>() {
public Option apply(BasicProfile user) {
return Scala.Option(user);
}
}));
}
/**
* Saves the Identity. This method gets called when a user logs in.
* This is your chance to save the user information in your backing store.
*
* @param user
*/
@Override
public Future save(BasicProfile user, SaveMode mode) {
return toScala(doSave(user, mode));
}
/**
* Links the current user Identity to another
*
* @param current The Identity of the current user
* @param to The Identity that needs to be linked to the current user
*/
@Override
public Future link(U current, BasicProfile to) {
return toScala(doLink(current, to));
}
@Override
public Future> passwordInfoFor(U user) {
return toScala(doPasswordInfoFor(user).thenApplyAsync(new Function>() {
@Override
public Option apply(PasswordInfo passwordInfo) {
return Scala.Option(passwordInfo);
}
}));
}
@Override
public Future> updatePasswordInfo(U user, PasswordInfo info) {
return toScala(doUpdatePasswordInfo(user, info).thenApplyAsync(new Function>() {
@Override
public Option apply(BasicProfile basicProfile) {
return Scala.Option(basicProfile);
}
}));
}
/**
* Saves a token. This is needed for users that
* are creating an account in the system instead of using one in a 3rd party system.
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*
* @param mailToken The token to save
* @return A string with a uuid that will be embedded in the welcome email.
*/
@Override
public Future saveToken(MailToken mailToken) {
return toScala(doSaveToken(Token.fromScala(mailToken)).thenApplyAsync(new Function() {
@Override
public MailToken apply(Token token) {
return token.toScala();
}
}));
}
/**
* Finds a token
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*
* @param token the token id
* @return
*/
@Override
public Future> findToken(String token) {
return toScala(doFindToken(token).thenApplyAsync(new Function>() {
@Override
public Option apply(Token token) {
MailToken scalaToken = token != null ? token.toScala() : null;
return Scala.Option(scalaToken);
}
}));
}
/**
* Deletes a token
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*
* @param uuid the token id
*/
@Override
public Future> deleteToken(String uuid) {
return toScala(doDeleteToken(uuid).thenApplyAsync(new Function>() {
@Override
public Option apply(Token token) {
MailToken scalaToken = token != null ? token.toScala() : null;
return Scala.Option(scalaToken);
}
}));
}
/**
* Deletes all expired tokens
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*/
@Override
public void deleteExpiredTokens() {
doDeleteExpiredTokens();
}
/**
* Saves the Identity. This method gets called when a user logs in.
* This is your chance to save the user information in your backing store.
*
* @param user
*/
public abstract CompletionStage doSave(BasicProfile user, SaveMode mode);
/**
* Saves a token
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*
* @param token
*/
public abstract CompletionStage doSaveToken(Token token);
/**
* Links the current user Identity to another
*
* @param current The Identity of the current user
* @param to The Identity that needs to be linked to the current user
*/
public abstract CompletionStage doLink(U current, BasicProfile to);
/**
* Finds the user in the backing store.
*
* @return an Identity instance or null if no user matches the specified id
*/
public abstract CompletionStage doFind(String providerId, String userId);
public abstract CompletionStage doPasswordInfoFor(U user);
public abstract CompletionStage doUpdatePasswordInfo(U user, PasswordInfo info);
/**
* Finds a token
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*
* @param tokenId the token id
* @return a Token instance or null if no token matches the specified id
*/
public abstract CompletionStage doFindToken(String tokenId);
/**
* Finds an identity by email and provider id.
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation.
*
* @param email - the user email
* @param providerId - the provider id
* @return an Identity instance or null if no user matches the specified id
*/
public abstract CompletionStage doFindByEmailAndProvider(String email, String providerId);
/**
* Deletes a token
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*
* @param uuid the token id
*/
public abstract CompletionStage doDeleteToken(String uuid);
/**
* Deletes all expired tokens
*
* Note: If you do not plan to use the UsernamePassword provider just provide en empty
* implementation
*/
public abstract void doDeleteExpiredTokens();
}