OLD | NEW |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 part of dart.io; | 5 part of dart.io; |
6 | 6 |
7 /** | 7 /** |
8 * A high-level class for communicating securely over a TCP socket, using | 8 * A high-level class for communicating securely over a TCP socket, using |
9 * TLS and SSL. The [SecureSocket] exposes both a [Stream] and an | 9 * TLS and SSL. The [SecureSocket] exposes both a [Stream] and an |
10 * [IOSink] interface, making it ideal for using together with | 10 * [IOSink] interface, making it ideal for using together with |
(...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
51 * handshake to make the communication secure. When the returned | 51 * handshake to make the communication secure. When the returned |
52 * future completes the [SecureSocket] has completed the TLS | 52 * future completes the [SecureSocket] has completed the TLS |
53 * handshake. Using this function requires that the other end of the | 53 * handshake. Using this function requires that the other end of the |
54 * connection is prepared for TLS handshake. | 54 * connection is prepared for TLS handshake. |
55 * | 55 * |
56 * If the [socket] already has a subscription, this subscription | 56 * If the [socket] already has a subscription, this subscription |
57 * will no longer receive and events. In most cases calling | 57 * will no longer receive and events. In most cases calling |
58 * `pause` on this subscription before starting TLS handshake is | 58 * `pause` on this subscription before starting TLS handshake is |
59 * the right thing to do. | 59 * the right thing to do. |
60 * | 60 * |
| 61 * The given [socket] is closed and may not be used anymore. |
| 62 * |
61 * If the [host] argument is passed it will be used as the host name | 63 * If the [host] argument is passed it will be used as the host name |
62 * for the TLS handshake. If [host] is not passed the host name from | 64 * for the TLS handshake. If [host] is not passed the host name from |
63 * the [socket] will be used. The [host] can be either a [String] or | 65 * the [socket] will be used. The [host] can be either a [String] or |
64 * an [InternetAddress]. | 66 * an [InternetAddress]. |
65 * | 67 * |
66 * Calling this function will _not_ cause a DNS host lookup. If the | 68 * Calling this function will _not_ cause a DNS host lookup. If the |
67 * [host] passed is a [String] the [InternetAddress] for the | 69 * [host] passed is a [String] the [InternetAddress] for the |
68 * resulting [SecureSocket] will have the passed in [host] as its | 70 * resulting [SecureSocket] will have the passed in [host] as its |
69 * host value and the internet address of the already connected | 71 * host value and the internet address of the already connected |
70 * socket as its address value. | 72 * socket as its address value. |
(...skipping 1156 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
1227 | 1229 |
1228 /** | 1230 /** |
1229 * An exception that happens in the handshake phase of establishing | 1231 * An exception that happens in the handshake phase of establishing |
1230 * a secure network connection, when looking up or verifying a | 1232 * a secure network connection, when looking up or verifying a |
1231 * certificate. | 1233 * certificate. |
1232 */ | 1234 */ |
1233 class CertificateException extends TlsException { | 1235 class CertificateException extends TlsException { |
1234 const CertificateException([String message = "", OSError osError = null]) | 1236 const CertificateException([String message = "", OSError osError = null]) |
1235 : super._("CertificateException", message, osError); | 1237 : super._("CertificateException", message, osError); |
1236 } | 1238 } |
OLD | NEW |