/*
* Copyright 2010-2011 Research In Motion Limited.
*
* Licensed 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 blackberry.io.file;
import net.rim.device.api.io.file.FileIOException;
import blackberry.core.FunctionSignature;
import blackberry.core.ScriptableFunctionBase;
import blackberry.io.FileConnectionWrapper;
/**
* JavaScript function class - renames a specified file
*/
public final class RenameFunction extends ScriptableFunctionBase {
public static final String NAME = "rename";
/**
* Rename a given file
*
* @param args
* args[0]: a compelte URL path to a file that is to be renamed.
*
* IOException will be thrown if src file does not yet exist, or the src path is to an directory
*/
public Object execute( Object thiz, Object[] args ) throws Exception {
FileConnectionWrapper fConnWrap = null;
try {
fConnWrap = new FileConnectionWrapper( args[ 0 ].toString() );
if( !fConnWrap.exists() ) {
throw new FileIOException( FileIOException.FILENAME_NOT_FOUND );
}
if( fConnWrap.isDirectory() ) {
throw new FileIOException( FileIOException.NOT_A_FILE );
}
fConnWrap.getFileConnection().rename( args[ 1 ].toString() );
} finally {
if( fConnWrap != null ) {
fConnWrap.close();
}
}
return UNDEFINED;
}
/**
* @see blackberry.core.ScriptableFunctionBase#getFunctionSignatures
*/
protected FunctionSignature[] getFunctionSignatures() {
FunctionSignature fs = new FunctionSignature( 2 );
fs.addParam( String.class, true );
fs.addParam( String.class, true );
return new FunctionSignature[] { fs };
}
}