ager@google.com
242bba108b
R=sgjesse@google.com BUG= TEST= Review URL: https://chromiumcodereview.appspot.com//9568004 git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@4790 260f80e4-7a28-3924-810f-c04153c831b5
92 lines
2.7 KiB
Dart
92 lines
2.7 KiB
Dart
// Copyright (c) 2012, 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.
|
|
|
|
/**
|
|
* [Process] objects are used to start new processes and interact with
|
|
* them.
|
|
*/
|
|
interface Process default _Process {
|
|
/**
|
|
* Creates a new process object and starts a process running the
|
|
* [executable] with the specified [arguments]. When the process has
|
|
* been successfully started [onStart] is called. If the process
|
|
* fails to start [onError] is called.
|
|
*
|
|
* An optional [workingDirectory] can be passed to specify where the process
|
|
* is run from. Note that the change of directory occurs before executing
|
|
* the process on some platforms, which may have impact when using relative
|
|
* paths for [executable] and [arguments].
|
|
*
|
|
* No data can be written to the process stdin and the process
|
|
* cannot be closed nor killed before [onStart] has been invoked.
|
|
*/
|
|
Process.start(String executable,
|
|
List<String> arguments,
|
|
[String workingDirectory]);
|
|
|
|
/**
|
|
* Returns an input stream of the process stdout.
|
|
*/
|
|
InputStream get stdout();
|
|
|
|
/**
|
|
* Returns an input stream of the process stderr.
|
|
*/
|
|
InputStream get stderr();
|
|
|
|
/**
|
|
* Returns an output stream to the process stdin.
|
|
*/
|
|
OutputStream get stdin();
|
|
|
|
/**
|
|
* Set the start handler which gets invoked when the process is
|
|
* successfully started.
|
|
*/
|
|
void set onStart(void callback());
|
|
|
|
/**
|
|
* Sets an exit handler which gets invoked when the process terminates.
|
|
*/
|
|
void set onExit(void callback(int exitCode));
|
|
|
|
/**
|
|
* Set an error handler which gets invoked if an operation on the process
|
|
* fails.
|
|
*/
|
|
void set onError(void callback(ProcessException error));
|
|
|
|
/**
|
|
* Kills the process. When the process terminates as a result of
|
|
* calling [kill] [onExit] is called. If the kill operation fails,
|
|
* [onError] is called.
|
|
*/
|
|
void kill();
|
|
|
|
/**
|
|
* Terminates the streams of a process. [close] most be called on a
|
|
* process to free the system resources associated with it. Usually,
|
|
* close should be called in [onExit]. Once a process has been
|
|
* closed it can no longer be killed and [onExit] is detached so the
|
|
* application is not notified of process termination.
|
|
*/
|
|
void close();
|
|
}
|
|
|
|
|
|
class ProcessException implements Exception {
|
|
const ProcessException([String this.message, int this.errorCode = 0]);
|
|
String toString() => "ProcessException: $message";
|
|
|
|
/**
|
|
* Contains the system message for the process exception if any.
|
|
*/
|
|
final String message;
|
|
|
|
/**
|
|
* Contains the OS error code for the process exception if any.
|
|
*/
|
|
final int errorCode;
|
|
}
|