archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 14:24:46 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8349121: SSLParameters.setApplicationProtocols() ALPN example could be clarified

Browse source 
Reviewed-by: abarashev, jnimeh, dfuchs
This commit is contained in:
Bradford Wetmore 2025-02-07 17:09:56 +00:00
parent fb847bb2af
commit 88a84835a3
1 changed files with 16 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

23
src/java.base/share/classes/javax/net/ssl/SSLParameters.java
View file

@ -653,19 +653,28 @@ public class SSLParameters {
* {@code String} should be exchanged using {@code UTF-8}, the * {@code String} should be exchanged using {@code UTF-8}, the
* {@code String} should be converted to its {@code byte[]} representation * {@code String} should be converted to its {@code byte[]} representation
* and stored as a byte-oriented {@code String} before calling this method. * and stored as a byte-oriented {@code String} before calling this method.
* For example:
* *
* <blockquote><pre> * <blockquote><pre>
* // MEETEI MAYEK LETTERS HUK UN I (Unicode 0xabcd->0xabcf): 2 bytes * // Encode 3 Meetei Mayek letters (HUK, UN, I) using Unicode Escapes
* byte[] bytes = "\u005cuabcd\u005cuabce\u005cuabcf" * // 0xabcd->0xabcf, 2 Unicode bytes/letter.
* .getBytes(StandardCharsets.UTF_8); * String HUK_UN_I = "\u005cuabcd\u005cuabce\u005cuabcf";
* String HUK_UN_I = new String(bytes, StandardCharsets.ISO_8859_1);
* *
* // 0x00-0xFF: 1 byte * // Convert into UTF-8 encoded bytes (3 bytes/letter)
* String rfc7301Grease8A = "\u005cu008A\u005cu008A"; * byte[] bytes = HUK_UN_I.getBytes(StandardCharsets.UTF_8);
* *
* // Preserve octet byte order by using ISO_8859_1 encoding
* String encodedHukUnI =
* new String(bytes, StandardCharsets.ISO_8859_1);
*
* // Also, encode a two byte RFC 8701 GREASE ALPN value
* // e.g. 0x0A, 0x1A, 0x2A...0xFA
* String rfc8701Grease8A = "\u005cu008A\u005cu008A";
*
* // Set the ALPN vlues on the sslSocket.
* SSLParameters p = sslSocket.getSSLParameters(); * SSLParameters p = sslSocket.getSSLParameters();
* p.setApplicationProtocols(new String[] { * p.setApplicationProtocols(new String[] {
* "h2", "http/1.1", rfc7301Grease8A, HUK_UN_I}); * "h2", "http/1.1", encodedHukUnI, rfc8701Grease8A});
* sslSocket.setSSLParameters(p); * sslSocket.setSSLParameters(p);
* </pre></blockquote> * </pre></blockquote>
* *