|
|
@@ -0,0 +1,198 @@
|
|
|
+/**
|
|
|
+ * 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.hadoop.fs.shell;
|
|
|
+
|
|
|
+import java.io.IOException;
|
|
|
+import java.text.DateFormat;
|
|
|
+import java.text.ParseException;
|
|
|
+import java.text.SimpleDateFormat;
|
|
|
+import java.util.LinkedList;
|
|
|
+
|
|
|
+import org.apache.hadoop.classification.InterfaceAudience;
|
|
|
+import org.apache.hadoop.classification.InterfaceStability;
|
|
|
+import org.apache.hadoop.fs.PathIOException;
|
|
|
+import org.apache.hadoop.fs.PathIsDirectoryException;
|
|
|
+import org.apache.hadoop.fs.PathNotFoundException;
|
|
|
+import org.apache.hadoop.util.StringUtils;
|
|
|
+
|
|
|
+import com.google.common.annotations.VisibleForTesting;
|
|
|
+
|
|
|
+/**
|
|
|
+ * Unix touch like commands
|
|
|
+ */
|
|
|
+@InterfaceAudience.Private
|
|
|
+@InterfaceStability.Unstable
|
|
|
+
|
|
|
+public class TouchCommands extends FsCommand {
|
|
|
+ public static void registerCommands(CommandFactory factory) {
|
|
|
+ factory.addClass(Touchz.class, "-touchz");
|
|
|
+ factory.addClass(Touch.class, "-touch");
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * (Re)create zero-length file at the specified path.
|
|
|
+ * This will be replaced by a more UNIX-like touch when files may be
|
|
|
+ * modified.
|
|
|
+ */
|
|
|
+ public static class Touchz extends TouchCommands {
|
|
|
+ public static final String NAME = "touchz";
|
|
|
+ public static final String USAGE = "<path> ...";
|
|
|
+ public static final String DESCRIPTION =
|
|
|
+ "Creates a file of zero length " +
|
|
|
+ "at <path> with current time as the timestamp of that <path>. " +
|
|
|
+ "An error is returned if the file exists with non-zero length\n";
|
|
|
+
|
|
|
+ @Override
|
|
|
+ protected void processOptions(LinkedList<String> args) {
|
|
|
+ CommandFormat cf = new CommandFormat(1, Integer.MAX_VALUE);
|
|
|
+ cf.parse(args);
|
|
|
+ }
|
|
|
+
|
|
|
+ @Override
|
|
|
+ protected void processPath(PathData item) throws IOException {
|
|
|
+ if (item.stat.isDirectory()) {
|
|
|
+ // TODO: handle this
|
|
|
+ throw new PathIsDirectoryException(item.toString());
|
|
|
+ }
|
|
|
+ if (item.stat.getLen() != 0) {
|
|
|
+ throw new PathIOException(item.toString(), "Not a zero-length file");
|
|
|
+ }
|
|
|
+ touchz(item);
|
|
|
+ }
|
|
|
+
|
|
|
+ @Override
|
|
|
+ protected void processNonexistentPath(PathData item) throws IOException {
|
|
|
+ if (!item.parentExists()) {
|
|
|
+ throw new PathNotFoundException(item.toString())
|
|
|
+ .withFullyQualifiedPath(item.path.toUri().toString());
|
|
|
+ }
|
|
|
+ touchz(item);
|
|
|
+ }
|
|
|
+
|
|
|
+ private void touchz(PathData item) throws IOException {
|
|
|
+ item.fs.create(item.path).close();
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ /**
|
|
|
+ * A UNIX like touch command.
|
|
|
+ */
|
|
|
+ public static class Touch extends TouchCommands {
|
|
|
+ private static final String OPTION_CHANGE_ONLY_MODIFICATION_TIME = "m";
|
|
|
+ private static final String OPTION_CHANGE_ONLY_ACCESS_TIME = "a";
|
|
|
+ private static final String OPTION_USE_TIMESTAMP = "t";
|
|
|
+ private static final String OPTION_DO_NOT_CREATE_FILE = "c";
|
|
|
+
|
|
|
+ public static final String NAME = "touch";
|
|
|
+ public static final String USAGE = "[-" + OPTION_CHANGE_ONLY_ACCESS_TIME
|
|
|
+ + "] [-" + OPTION_CHANGE_ONLY_MODIFICATION_TIME + "] [-"
|
|
|
+ + OPTION_USE_TIMESTAMP + " TIMESTAMP ] [-" + OPTION_DO_NOT_CREATE_FILE
|
|
|
+ + "] <path> ...";
|
|
|
+ public static final String DESCRIPTION =
|
|
|
+ "Updates the access and modification times of the file specified by the"
|
|
|
+ + " <path> to the current time. If the file does not exist, then a zero"
|
|
|
+ + " length file is created at <path> with current time as the timestamp"
|
|
|
+ + " of that <path>.\n"
|
|
|
+ + "-" + OPTION_CHANGE_ONLY_ACCESS_TIME
|
|
|
+ + " Change only the access time \n" + "-"
|
|
|
+ + OPTION_CHANGE_ONLY_MODIFICATION_TIME
|
|
|
+ + " Change only the modification time \n" + "-"
|
|
|
+ + OPTION_USE_TIMESTAMP + " TIMESTAMP"
|
|
|
+ + " Use specified timestamp (in format yyyyMMddHHmmss) instead of current time \n"
|
|
|
+ + "-" + OPTION_DO_NOT_CREATE_FILE + " Do not create any files";
|
|
|
+
|
|
|
+ private boolean changeModTime = false;
|
|
|
+ private boolean changeAccessTime = false;
|
|
|
+ private boolean doNotCreate = false;
|
|
|
+ private String timestamp;
|
|
|
+ private final SimpleDateFormat dateFormat =
|
|
|
+ new SimpleDateFormat("yyyyMMdd:HHmmss");
|
|
|
+
|
|
|
+ @InterfaceAudience.Private
|
|
|
+ @VisibleForTesting
|
|
|
+ public DateFormat getDateFormat() {
|
|
|
+ return dateFormat;
|
|
|
+ }
|
|
|
+
|
|
|
+ @Override
|
|
|
+ protected void processOptions(LinkedList<String> args) {
|
|
|
+ this.timestamp =
|
|
|
+ StringUtils.popOptionWithArgument("-" + OPTION_USE_TIMESTAMP, args);
|
|
|
+
|
|
|
+ CommandFormat cf = new CommandFormat(1, Integer.MAX_VALUE,
|
|
|
+ OPTION_USE_TIMESTAMP, OPTION_CHANGE_ONLY_ACCESS_TIME,
|
|
|
+ OPTION_CHANGE_ONLY_MODIFICATION_TIME);
|
|
|
+ cf.parse(args);
|
|
|
+ this.changeModTime = cf.getOpt(OPTION_CHANGE_ONLY_MODIFICATION_TIME);
|
|
|
+ this.changeAccessTime = cf.getOpt(OPTION_CHANGE_ONLY_ACCESS_TIME);
|
|
|
+ this.doNotCreate = cf.getOpt(OPTION_DO_NOT_CREATE_FILE);
|
|
|
+ }
|
|
|
+
|
|
|
+ @Override
|
|
|
+ protected void processPath(PathData item) throws IOException {
|
|
|
+ if (item.stat.isDirectory()) {
|
|
|
+ throw new PathIsDirectoryException(item.toString());
|
|
|
+ }
|
|
|
+ touch(item);
|
|
|
+ }
|
|
|
+
|
|
|
+ @Override
|
|
|
+ protected void processNonexistentPath(PathData item) throws IOException {
|
|
|
+ if (!item.parentExists()) {
|
|
|
+ throw new PathNotFoundException(item.toString())
|
|
|
+ .withFullyQualifiedPath(item.path.toUri().toString());
|
|
|
+ }
|
|
|
+ touch(item);
|
|
|
+ }
|
|
|
+
|
|
|
+ private void touch(PathData item) throws IOException {
|
|
|
+ if (!item.fs.exists(item.path)) {
|
|
|
+ if (doNotCreate) {
|
|
|
+ return;
|
|
|
+ }
|
|
|
+ item.fs.create(item.path).close();
|
|
|
+ if (timestamp != null) {
|
|
|
+ // update the time only if user specified a timestamp using -t option.
|
|
|
+ updateTime(item);
|
|
|
+ }
|
|
|
+ } else {
|
|
|
+ updateTime(item);
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ private void updateTime(PathData item) throws IOException {
|
|
|
+ long time = System.currentTimeMillis();
|
|
|
+ if (timestamp != null) {
|
|
|
+ try {
|
|
|
+ time = dateFormat.parse(timestamp).getTime();
|
|
|
+ } catch (ParseException e) {
|
|
|
+ throw new IllegalArgumentException(
|
|
|
+ "Unable to parse the specified timestamp " + timestamp, e);
|
|
|
+ }
|
|
|
+ }
|
|
|
+ if (changeModTime ^ changeAccessTime) {
|
|
|
+ long atime = changeModTime ? -1 : time;
|
|
|
+ long mtime = changeAccessTime ? -1 : time;
|
|
|
+ item.fs.setTimes(item.path, mtime, atime);
|
|
|
+ } else {
|
|
|
+ item.fs.setTimes(item.path, time, time);
|
|
|
+ }
|
|
|
+ }
|
|
|
+ }
|
|
|
+}
|
Xiao Chen