blob: 093ce2a666af1aa14f411130ba9ee10e0c5d53b8 [file] [log] [blame]
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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.apache.tools.ant.taskdefs.optional.ssh;
import java.io.File;
import java.io.IOException;
import java.util.Iterator;
import java.util.List;
import com.jcraft.jsch.ChannelSftp;
import com.jcraft.jsch.JSchException;
import com.jcraft.jsch.Session;
import com.jcraft.jsch.SftpException;
import com.jcraft.jsch.SftpProgressMonitor;
/**
* Utility class to carry out an upload by sftp.
*/
public class ScpToMessageBySftp extends ScpToMessage/*AbstractSshMessage*/ {
private static final int HUNDRED_KILOBYTES = 102400;
private File localFile;
private final String remotePath;
private List directoryList;
private final boolean preserveLastModified;
/**
* Constructor for a local file to remote.
* @param verbose if true do verbose logging
* @param session the scp session to use
* @param aLocalFile the local file
* @param aRemotePath the remote path
* @since Ant 1.7
*/
public ScpToMessageBySftp(final boolean verbose,
final Session session,
final File aLocalFile,
final String aRemotePath) {
this(verbose, session, aLocalFile, aRemotePath, false);
}
/**
* Constructor for a local file to remote.
* @param verbose if true do verbose logging
* @param session the scp session to use
* @param aLocalFile the local file
* @param aRemotePath the remote path
* @param preserveLastModified True if the last modified time needs to be preserved
* on the transferred files. False otherwise.
* @since Ant 1.9.10
*/
public ScpToMessageBySftp(final boolean verbose,
final Session session,
final File aLocalFile,
final String aRemotePath,
final boolean preserveLastModified) {
this(verbose, session, aRemotePath, preserveLastModified);
this.localFile = aLocalFile;
}
/**
* Constructor for a local directories to remote.
* @param verbose if true do verbose logging
* @param session the scp session to use
* @param aDirectoryList a list of directories
* @param aRemotePath the remote path
* @since Ant 1.7
*/
public ScpToMessageBySftp(final boolean verbose,
final Session session,
final List aDirectoryList,
final String aRemotePath) {
this(verbose, session, aDirectoryList, aRemotePath, false);
}
/**
* Constructor for a local directories to remote.
* @param verbose if true do verbose logging
* @param session the scp session to use
* @param aDirectoryList a list of directories
* @param aRemotePath the remote path
* @param preserveLastModified True if the last modified time needs to be preserved
* on the transferred files. False otherwise.
* @since Ant 1.9.10
*/
public ScpToMessageBySftp(final boolean verbose,
final Session session,
final List aDirectoryList,
final String aRemotePath,
final boolean preserveLastModified) {
this(verbose, session, aRemotePath, preserveLastModified);
this.directoryList = aDirectoryList;
}
/**
* Constructor for ScpToMessage.
* @param verbose if true do verbose logging
* @param session the scp session to use
* @param aRemotePath the remote path
* @param preserveLastModified True if the last modified time needs to be preserved
* on the transferred files. False otherwise.
*/
private ScpToMessageBySftp(final boolean verbose,
final Session session,
final String aRemotePath,
final boolean preserveLastModified) {
super(verbose, session);
this.remotePath = aRemotePath;
this.preserveLastModified = preserveLastModified;
}
/**
* Constructor for ScpToMessage.
* @param session the scp session to use
* @param aLocalFile the local file
* @param aRemotePath the remote path
*/
public ScpToMessageBySftp(final Session session,
final File aLocalFile,
final String aRemotePath) {
this(false, session, aLocalFile, aRemotePath);
}
/**
* Constructor for ScpToMessage.
* @param session the scp session to use
* @param aDirectoryList a list of directories
* @param aRemotePath the remote path
*/
public ScpToMessageBySftp(final Session session,
final List aDirectoryList,
final String aRemotePath) {
this(false, session, aDirectoryList, aRemotePath);
}
/**
* Carry out the transfer.
* @throws IOException on i/o errors
* @throws JSchException on errors detected by scp
*/
@Override
public void execute() throws IOException, JSchException {
if (directoryList != null) {
doMultipleTransfer();
}
if (localFile != null) {
doSingleTransfer();
}
log("done.\n");
}
private void doSingleTransfer() throws IOException, JSchException {
final ChannelSftp channel = openSftpChannel();
try {
channel.connect();
try {
sendFileToRemote(channel, localFile, remotePath);
} catch (final SftpException e) {
throw new JSchException("Could not send '" + localFile
+ "' to '" + remotePath + "' - "
+ e.toString(), e);
}
} finally {
if (channel != null) {
channel.disconnect();
}
}
}
private void doMultipleTransfer() throws IOException, JSchException {
final ChannelSftp channel = openSftpChannel();
try {
channel.connect();
try {
try {
channel.stat(remotePath);
} catch (final SftpException e) {
if (e.id == ChannelSftp.SSH_FX_NO_SUCH_FILE) {
// dir does not exist.
channel.mkdir(remotePath);
channel.chmod(getDirMode(), remotePath);
} else {
throw new JSchException("failed to access remote dir '"
+ remotePath + "'", e);
}
}
channel.cd(remotePath);
} catch (final SftpException e) {
throw new JSchException("Could not CD to '" + remotePath
+ "' - " + e.toString(), e);
}
Directory current = null;
try {
for (final Iterator i = directoryList.iterator(); i.hasNext();) {
current = (Directory) i.next();
if (getVerbose()) {
log("Sending directory " + current);
}
sendDirectory(channel, current);
}
} catch (final SftpException e) {
String msg = "Error sending directory";
if (current != null && current.getDirectory() != null) {
msg += " '" + current.getDirectory().getName() + "'";
}
throw new JSchException(msg, e);
}
} finally {
if (channel != null) {
channel.disconnect();
}
}
}
private void sendDirectory(final ChannelSftp channel,
final Directory current)
throws IOException, SftpException {
for (final Iterator fileIt = current.filesIterator(); fileIt.hasNext();) {
sendFileToRemote(channel, (File) fileIt.next(), null);
}
for (final Iterator dirIt = current.directoryIterator(); dirIt.hasNext();) {
final Directory dir = (Directory) dirIt.next();
sendDirectoryToRemote(channel, dir);
}
}
private void sendDirectoryToRemote(final ChannelSftp channel,
final Directory directory)
throws IOException, SftpException {
final String dir = directory.getDirectory().getName();
try {
channel.stat(dir);
} catch (final SftpException e) {
// dir does not exist.
if (e.id == ChannelSftp.SSH_FX_NO_SUCH_FILE) {
channel.mkdir(dir);
channel.chmod(getDirMode(), dir);
}
}
channel.cd(dir);
sendDirectory(channel, directory);
channel.cd("..");
}
private void sendFileToRemote(final ChannelSftp channel,
final File localFile,
String remotePath)
throws IOException, SftpException {
final long filesize = localFile.length();
if (remotePath == null) {
remotePath = localFile.getName();
}
final long startTime = System.currentTimeMillis();
final long totalLength = filesize;
// only track progress for files larger than 100kb in verbose mode
final boolean trackProgress = getVerbose() && filesize > HUNDRED_KILOBYTES;
SftpProgressMonitor monitor = null;
if (trackProgress) {
monitor = getProgressMonitor();
}
try {
if (this.getVerbose()) {
log("Sending: " + localFile.getName() + " : " + filesize);
}
channel.put(localFile.getAbsolutePath(), remotePath, monitor);
// set the fileMode on the transferred file. The "remotePath" can potentially be a directory
// into which the file got transferred, so we can't/shouldn't go ahead and try to change that directory's
// permissions. Instead we determine the path of the transferred file on remote.
final String transferredFileRemotePath;
if (channel.stat(remotePath).isDir()) {
// Note: It's correct to use "/" as the file separator without worrying about what the remote
// server's file separator is, since the SFTP spec expects "/" to be considered as file path
// separator. See section 6.2 "File Names" of the spec, which states:
// "This protocol represents file names as strings. File names are
// assumed to use the slash ('/') character as a directory separator."
transferredFileRemotePath = remotePath + "/" + localFile.getName();
} else {
transferredFileRemotePath = remotePath;
}
if (this.getVerbose()) {
log("Setting file mode '" + Integer.toOctalString(getFileMode()) + "' on remote path " + transferredFileRemotePath);
}
channel.chmod(getFileMode(), transferredFileRemotePath);
if (getPreserveLastModified()) {
// set the last modified time (seconds since epoch) on the transferred file
final int lastModifiedTime = (int) (localFile.lastModified() / 1000L);
if (this.getVerbose()) {
log("Setting last modified time on remote path " + transferredFileRemotePath + " to " + lastModifiedTime);
}
channel.setMtime(transferredFileRemotePath, lastModifiedTime);
}
} finally {
if (this.getVerbose()) {
final long endTime = System.currentTimeMillis();
logStats(startTime, endTime, (int) totalLength);
}
}
}
/**
* Get the local file.
* @return the local file.
*/
public File getLocalFile() {
return localFile;
}
/**
* Get the remote path.
* @return the remote path.
*/
public String getRemotePath() {
return remotePath;
}
/**
* Returns true if the last modified time needs to be preserved on the
* file(s) that get transferred. Returns false otherwise.
*
* @return boolean
*/
public boolean getPreserveLastModified() {
return this.preserveLastModified;
}
}