/* * Syncany, www.syncany.org * Copyright (C) 2011-2015 Philipp C. Heckel <philipp.heckel@gmail.com> * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see <http://www.gnu.org/licenses/>. */ package org.syncany.plugins.transfer; import java.io.File; import java.io.IOException; import java.util.logging.Level; import java.util.logging.Logger; import org.syncany.config.Config; import org.syncany.plugins.transfer.features.Retriable; import org.syncany.plugins.transfer.features.TransactionAware; import org.syncany.util.StringUtil; /** * Implements basic functionality of a {@link TransferManager} which * can be implemented sub-classes. * * <p>This transfer manager is enhanced with the {@link TransactionAware} * and {@link Retriable} annotations, thereby making it reliable. * * @author Philipp C. Heckel <philipp.heckel@gmail.com> * @author Christian Roth <christian.roth@port17.de> */ @TransactionAware @Retriable(numberRetries = 3, sleepInterval = 3000) public abstract class AbstractTransferManager implements TransferManager { // TODO [medium] Rename this to AbstractReliableTransferManager private static final Logger logger = Logger.getLogger(AbstractTransferManager.class.getSimpleName()); protected TransferSettings settings; protected Config config; public AbstractTransferManager(TransferSettings settings, Config config) { this.settings = settings; this.config = config; } /** * Creates a temporary file, either using the config (if initialized) or * using the global temporary directory. */ protected File createTempFile(String name) throws IOException { if (config == null) { return File.createTempFile(String.format("temp-%s-", name), ".tmp"); } else { return config.getCache().createTempFile(name); } } /** * Checks whether the settings given to this transfer manager can be * used to create or connect to a remote repository. * * <p>Tests if the target exists, if it can be written to and if a * repository can be created. */ @Override public StorageTestResult test(boolean testCreateTarget) { logger.log(Level.INFO, "Performing storage test TM.test() ..."); StorageTestResult result = new StorageTestResult(); try { logger.log(Level.INFO, "- Running connect() ..."); connect(); result.setTargetExists(testTargetExists()); result.setTargetCanWrite(testTargetCanWrite()); result.setRepoFileExists(testRepoFileExists()); if (result.isTargetExists()) { result.setTargetCanCreate(true); } else { if (testCreateTarget) { result.setTargetCanCreate(testTargetCanCreate()); } else { result.setTargetCanCreate(false); } } result.setTargetCanConnect(true); } catch (StorageException e) { result.setTargetCanConnect(false); result.setErrorMessage(StringUtil.getStackTrace(e)); logger.log(Level.INFO, "-> Testing storage failed. Returning " + result, e); } finally { try { disconnect(); } catch (StorageException e) { logger.log(Level.FINE, "Could not disconnect", e); } } return result; } }