On Mon, 18 May 2026 19:12:41 GMT, Artur Barashev <[email protected]> wrote:
>> @AlanBateman, @artur-oracle, shall I put the changes up for display in the >> CSR? Do you have any further remarks? > > @vy @AlanBateman I wonder if we need to essentially duplicate `new(String)` > and `new(byte[])` javadocs in `ofHostName()` and `ofEncoded` using different > wording? A random Java user may find it confusing. The only difference > between these new static methods and the constructors is an IP check and a > somewhat stricter DNS name check. I think we should keep things as simple as > possible. We can do either of the following instead: > > 1. Copy existing constructor's javadoc text and make a few modifications for > stricter checks. > 2. Just link to the constructor's javadoc and note that in addition to that > we do stricter checks. > > I think the 1st option is the current java securities code's convention. > Please see `SSLSession` for an example of past depreciation. Discussed this issue further with @artur-oracle and we've decided to close it as `Won't Fix`. ------------- PR Comment: https://git.openjdk.org/jdk/pull/30747#issuecomment-4903918013
