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

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);

    /**
     * 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;

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