summaryrefslogtreecommitdiff
path: root/MockFtpServer/src/main/groovy/org/mockftpserver/fake/user/UserAccount.groovy
blob: 625a9cd0acafe9a728ee09ded30f7cb5fc58fe7f (plain)
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/*
 * Copyright 2008 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 org.mockftpserver.fake.user

/**
 * Represents a single user account on the server, including the username, password and home
 * directory.
 * <p>
 * The <code>isValidPassword()</code> method returns true if the specified password matches
 * the password value configured for this user account. This implementation uses the
 * <code>isEquals()</code> method to compare passwords. 
 * <p>
 * If you want to provide a custom comparison, for instance using encrypted passwords, you can
 * override the <code>comparePassword()</code> method to provide your own custom implementation.
 * <p>
 * If the <code>passwordCheckedDuringValidation</code> property is set to false, then the password
 * value is ignored, and the <code>isValidPassword()</code> method just returns <code<true</code>. 
 */
class UserAccount {

    String username
    String password
    String homeDirectory
    boolean passwordRequiredForLogin = true
    boolean passwordCheckedDuringValidation = true

    /**
     * Return true if the specified password is the correct, valid password for this user account.
     * This implementation uses standard (case-sensitive) String comparison. Subclasses can provide
     * custom comparison behavior, for instance using encrypted password values, by overriding this
     * method.
     *
     * @param password - the password to compare against the configured value
     * @return true if the password is correct and valid
     *
     * @throws AssertionError - if the username property is null
     */
    boolean isValidPassword(String password) {
        assert username
        return passwordCheckedDuringValidation ? comparePassword(password) : true
    }

    /**
     * @return true if this UserAccount object is valid; i.e. if the homeDirectory is non-null and non-empty.
     */
    boolean isValid() {
        return homeDirectory
    }

    /**
     * @return the String representation of this object
     */
    String toString() {
        "UserAccount[username=$username; password=$password; homeDirectory=$homeDirectory; " +
                "passwordRequiredForLogin=$passwordRequiredForLogin]"
    }

    /**
     * Return true if the specified password matches the password configured for this user account.
     * This implementation uses standard (case-sensitive) String comparison. Subclasses can provide
     * custom comparison behavior, for instance using encrypted password values, by overriding this
     * method.
     *
     * @param password - the password to compare against the configured value
     * @return true if the passwords match
     */
    protected boolean comparePassword(String password) {
        return password == this.password
    }
}