com.springsource.greenhouse.signup.SignupHelper.java Source code

Introduction

Here is the source code for com.springsource.greenhouse.signup.SignupHelper.java

Source

/*
 * Copyright 2010 the original author or authors.
 *
 * 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 com.springsource.greenhouse.signup;

import org.springframework.transaction.annotation.Transactional;
import org.springframework.validation.BindingResult;

import com.springsource.greenhouse.account.Account;
import com.springsource.greenhouse.account.AccountRepository;
import com.springsource.greenhouse.account.AccountUtils;
import com.springsource.greenhouse.account.EmailAlreadyOnFileException;
import com.springsource.greenhouse.account.Person;
import com.springsource.greenhouse.invite.InviteController;

/**
 * A helper for signing up new users.
 * Encapsulates common signup UI control and business logic.
 * Factored out since signup can be triggered by a normal {@link SignupController} flow or via a {@link InviteController accept invite} flow.
 * @author Keith Donald
 */
public class SignupHelper {

    private final AccountRepository accountRepository;

    private final SignedUpGateway gateway;

    public SignupHelper(AccountRepository accountRepository, SignedUpGateway gateway) {
        this.accountRepository = accountRepository;
        this.gateway = gateway;
    }

    /**
     * Signup the person who completed the signup form.
     * Returns true if signup was successful, false if there was an error.
     * Records any errors in the form's BindingResult context for display to the person.
     */
    public boolean signup(SignupForm form, BindingResult formBinding) {
        return signup(form, formBinding, null);
    }

    /**
     * Signup the person who completed the signup form.
     * Returns true if signup was successful, false if there was an error.
     * Records any errors in the form's BindingResult context for display to the person.
     * An optional SignupCallback may be specified for performing custom processing after successful member signup.
     */
    public boolean signup(SignupForm form, BindingResult formBinding, SignupCallback callback) {
        try {
            Account account = createAccount(form.createPerson(), callback);
            gateway.signedUp(account);
            AccountUtils.signin(account);
            if (callback != null) {
                callback.postSignup(account);
            }
            return true;
        } catch (EmailAlreadyOnFileException e) {
            formBinding.rejectValue("email", "account.duplicateEmail", "already on file");
            return false;
        }
    }

    // internal helpers

    @Transactional
    private Account createAccount(Person person, SignupCallback callback) throws EmailAlreadyOnFileException {
        return accountRepository.createAccount(person);
    }

    /**
     * Called after new member Account signup to allow for custom post processing.
     */
    public interface SignupCallback {

        void postSignup(Account account);

    }

}