blob: fff6b8245231c6ae5aba452f72f830f53c58d871 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
/* 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 java.net;
import java.security.Principal;
import java.security.cert.Certificate;
import java.util.List;
import javax.net.ssl.SSLPeerUnverifiedException;
/**
* A secure cache response represents data which is originally retrieved over a
* secure connection. Such a connection can be secured by using a cryptographic
* protocol like TLS or SSL.
*
* @see ResponseCache
* @since Android 1.0
*/
public abstract class SecureCacheResponse extends CacheResponse {
/**
* Creates a new instance of this class.
*
* @since Android 1.0
*/
public SecureCacheResponse() {
super();
}
/**
* Gets the cipher suite string on the connection which is originally used
* to retrieve the network resource.
*
* @return the cipher suite string.
* @since Android 1.0
*/
public abstract String getCipherSuite();
/**
* Gets the local certificate chain. When the original connection retrieved
* the resource data, this certificate chain was sent to the server during
* handshaking process. This method only takes effect when certificate-based
* cipher suite is enabled.
*
* @return the certificate chain that was sent to the server. If no
* certificate chain was sent, the method returns {@code null}.
* @since Android 1.0
*/
public abstract List<Certificate> getLocalCertificateChain();
/**
* Gets the cached server's certificate chain. As part of defining the
* session, the certificate chain was established when the original
* connection retrieved network resource. This method can only be invoked
* when certificated-based cipher suite is enabled. Otherwise, it throws an
* {@code SSLPeerUnverifiedException}.
*
* @return the server's certificate chain.
* @throws SSLPeerUnverifiedException
* if the peer is unverified.
* @since Android 1.0
*/
public abstract List<Certificate> getServerCertificateChain()
throws SSLPeerUnverifiedException;
/**
* Gets the server's principle. When the original connection retrieved
* network resource, the principle was established when defining the
* session.
*
* @return a principal object representing the server's principal.
* @throws SSLPeerUnverifiedException
* if the peer is unverified.
* @since Android 1.0
*/
public abstract Principal getPeerPrincipal()
throws SSLPeerUnverifiedException;
/**
* Gets the local principle that the original connection sent to the server.
* When the original connection fetched the network resource, the principle
* was sent to the server during handshaking process.
*
* @return the local principal object being sent to the server. Returns an
* {@code X500Principal} object for X509-based cipher suites. If no
* principal was sent, it returns {@code null}.
* @since Android 1.0
*/
public abstract Principal getLocalPrincipal();
}
|
