summaryrefslogtreecommitdiff
path: root/src/main/java/com/keuin/kbackupfabric/backup/name/BackupFileNameEncoder.java
blob: b47183456dfaf5727c4259af352fbb52ae297a7f (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
package com.keuin.kbackupfabric.backup.name;

import com.keuin.kbackupfabric.util.DateUtil;

import java.time.LocalDateTime;

/**
 * Encode and decode backup file name for a specific backup type.
 */
public interface BackupFileNameEncoder {

    /**
     * Construct full backup file name from custom name and creation time.
     * @param customName the custom name. If the custom name contains invalid chars, an exception will be thrown.
     * @param time the creation time.
     * @return the file name.
     */
    String encode(String customName, LocalDateTime time);

    /**
     * Extract custom and backup time from backup file name.
     *
     * @param fileName the backup file name.
     * @return the information. If the given file name is invalid, return null.
     */
    BackupBasicInformation decode(String fileName);

    default boolean isValidFileName(String fileName) {
        return decode(fileName) != null;
    }

    /**
     * Check if the given string is a valid custom backup name.
     *
     * @param customName the custom backup name.
     * @return if the name is valid.
     */
    default boolean isValidCustomName(String customName) {
        final char[] ILLEGAL_CHARACTERS = {'/', '\n', '\r', '\t', '\0', '\f', '`', '?', '*', '\\', '<', '>', '|', '\"', ':'};
        for (char c : ILLEGAL_CHARACTERS) {
            if (customName.contains(String.valueOf(c))) {
                return false;
            }
        }
        return true;
    }

    class BackupBasicInformation {

        public final String customName;
        public final LocalDateTime time;

        protected BackupBasicInformation(String customName, LocalDateTime time) {
            this.customName = customName;
            this.time = time;
        }

        @Override
        public String toString() {
            return String.format("%s, %s", customName, DateUtil.getString(time));
        }
    }
}