Java tutorial
/* * The MIT License * * Copyright 2015 Ahseya. * * Permission is hereby granted, free from charge, to any person obtaining a copy * from this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies from the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions from the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ package com.github.horrorho.liquiddonkey.cloud.file; import com.github.horrorho.liquiddonkey.cloud.data.Snapshot; import com.github.horrorho.liquiddonkey.cloud.protobuf.ICloud; import com.github.horrorho.liquiddonkey.settings.config.FileConfig; import com.github.horrorho.liquiddonkey.util.Bytes; import com.google.protobuf.ByteString; import java.nio.file.Path; import java.util.function.Function; import net.jcip.annotations.NotThreadSafe; import org.apache.commons.lang3.SystemUtils; import org.bouncycastle.crypto.digests.GeneralDigest; import org.bouncycastle.crypto.digests.SHA1Digest; /** * SnapshotDirectory. * <p> * Handles the standard and iTunes-flat directory structures, either separating or combining snapshots. * * @author Ahseya */ @NotThreadSafe public abstract class SnapshotDirectory implements Function<ICloud.MBSFile, Path> { /** * Returns a new instance. * * @param snapshot not null * @param config not null * @return new instance, not null */ public static SnapshotDirectory from(Snapshot snapshot, FileConfig config) { return SnapshotDirectory.from(config.base(), snapshot.backupUDID(), Integer.toString(snapshot.snapshotID()), config.isFlat(), config.isCombined(), config.combinedDirectory()); } static SnapshotDirectory from(Path base, String udidStr, String snapshotIdStr, boolean isFlat, boolean isCombined, String combinedDirectory) { SHA1Digest sha1 = new SHA1Digest(); Path folder = isCombined ? base.resolve(udidStr).resolve(combinedDirectory) : base.resolve(udidStr).resolve(snapshotIdStr); return isFlat ? new FlatSnapshotDirectory(folder, sha1) : new NonFlatSnapshotDirectory(folder, sha1); } private static final String FILTER = "[\u0001-\u001f\\\\:*?\"<>|\u007f]"; private static final String REPLACE = "_"; private static final ByteString HYPHEN = ByteString.copyFromUtf8("-"); private final Path folder; private final GeneralDigest digest; SnapshotDirectory(Path folder, GeneralDigest digest) { this.folder = folder; this.digest = digest; } @NotThreadSafe public static final class NonFlatSnapshotDirectory extends SnapshotDirectory { NonFlatSnapshotDirectory(Path folder, SHA1Digest sha1) { super(folder, sha1); } @Override public Path apply(ICloud.MBSFile file) { return super.folder.resolve(clean(file.getDomain())).resolve(clean(file.getRelativePath())); } } @NotThreadSafe public static final class FlatSnapshotDirectory extends SnapshotDirectory { FlatSnapshotDirectory(Path folder, SHA1Digest sha1) { super(folder, sha1); } @Override public Path apply(ICloud.MBSFile file) { byte[] hash = new byte[super.digest.getDigestSize()]; byte[] array = file.getDomainBytes().concat(HYPHEN).concat(file.getRelativePathBytes()).toByteArray(); super.digest.reset(); super.digest.update(array, 0, array.length); super.digest.doFinal(hash, 0); return super.folder.resolve(Bytes.hex(hash)); } } String clean(String name) { return SystemUtils.IS_OS_WINDOWS ? name.replaceAll(FILTER, REPLACE) : name; // Assumed Nix/ MacOS mapping directly. } }