1berry/openjdk
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

8241995: Clarify InetSocketAddress::toString specification

Browse Source 
Reviewed-by: michaelm, chegar
This commit is contained in:
Julia Boes 2021-02-03 14:15:00 +00:00
parent 0ef93feb43
commit b0ee7a8624
1 changed files with 12 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
src/java.base/share/classes/java/net/InetSocketAddress.java
View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -373,11 +373,18 @@ public class InetSocketAddress
/** /**
* Constructs a string representation of this InetSocketAddress. * Constructs a string representation of this InetSocketAddress.
* This String is constructed by calling toString() on the InetAddress * This string is constructed by calling {@link InetAddress#toString()}
* and concatenating the port number (with a colon). If the address * on the InetAddress and concatenating the port number (with a colon).
* is an IPv6 address, the IPv6 literal is enclosed in square brackets. * <p>
* If the address is an IPv6 address, the IPv6 literal is enclosed in
* square brackets, for example: {@code "localhost/[0:0:0:0:0:0:0:1]:80"}.
* If the address is {@linkplain #isUnresolved() unresolved}, * If the address is {@linkplain #isUnresolved() unresolved},
* {@code <unresolved>} is displayed in place of the address literal. * {@code <unresolved>} is displayed in place of the address literal, for
* example {@code "foo/<unresolved>:80"}.
* <p>
* To retrieve a string representation of the hostname or the address, use
* {@link #getHostString()}, rather than parsing the string returned by this
* {@link #toString()} method.
* *
* @return a string representation of this object. * @return a string representation of this object.
*/ */