Move delete/deleteSync up to FileSystemEntity, with a shared documentation.

sdk/lib/io/link.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.io;
 
 /**
  * [Link] objects are references to filesystem links.
  *
  */
@@ skipping 47 matching lines @@
    * Updates the link. Returns a [:Future<Link>:] that completes with the
    * link when it has been updated.  Calling [update] on a non-existing link
    * will complete its returned future with an exception.
    *
    * On the Windows platform, this will only work with directories, and the
    * target directory must exist.
    */
   Future<Link> update(String target);
 
   /**
-   * Deletes the link. Returns a [:Future<Link>:] that completes with
-   * the link when it has been deleted. This does not delete, or otherwise
-   * affect, the target of the link. It also works on broken links, but if
-   * the link does not exist or is not actually a link, it completes the
-   * future with a LinkException.
-   */
-  Future<Link> delete();
-
-  /**
-   * Synchronously deletes the link. This does not delete, or otherwise
-   * affect, the target of the link.  It also works on broken links, but if
-   * the link does not exist or is not actually a link, it throws a
-   * LinkException.
-   */
-  void deleteSync();
-
-  /**
    * Renames this link. Returns a `Future<Link>` that completes
    * with a [Link] instance for the renamed link.
    *
    * If [newPath] identifies an existing link, that link is
    * replaced. If [newPath] identifies an existing file or directory,
    * the operation fails and the future completes with an exception.
    */
   Future<Link> rename(String newPath);
 
    /**
@@ skipping 111 matching lines @@
   }
 
   Future<Link> update(String target) {
     // TODO(12414): Replace with atomic update, where supported by platform.
     // Atomically changing a link can be done by creating the new link, with
     // a different name, and using the rename() posix call to move it to
     // the old name atomically.
     return delete().then((_) => create(target));
   }
 
-  Future<Link> delete() {
+  Future<Link> _delete({bool recursive: false}) {
+    if (recursive) {
+      return new Directory(path).delete(recursive: true).then((_) => this);
+    }
     _ensureFileService();
     List request = new List(2);
     request[0] = _DELETE_LINK_REQUEST;
     request[1] = path;
     return _fileService.call(request).then((response) {
       if (_isErrorResponse(response)) {
         throw _exceptionFromResponse(response, "Cannot delete link", path);
       }
       return this;
     });
   }
 
-  void deleteSync() {
-    var result = _File._deleteLink(path);
+  void _deleteSync({bool recursive: false}) {
+    if (recursive) {
+      return new Directory(path).deleteSync(recursive: true);
+    }
+    var result = _File._deleteLinkNative(path);
     throwIfError(result, "Cannot delete link", path);
   }
 
   Future<Link> rename(String newPath) {
     _ensureFileService();
     List request = new List(3);
     request[0] = _RENAME_LINK_REQUEST;
     request[1] = path;
     request[2] = newPath;
     return _fileService.call(request).then((response) {
@@ skipping 83 matching lines @@
       if (path != null) {
         sb.write(", path = $path");
       }
     }
     return sb.toString();
   }
   final String message;
   final String path;
   final OSError osError;
 }