On Tue, 30 Mar 2021 15:34:16 GMT, Sean Mullan <mul...@openjdk.org> wrote:

>> Weijun Wang has updated the pull request incrementally with one additional 
>> commit since the last revision:
>> 
>>   update XMLUtils (not used by tests here)
>
> src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/spec/RSAPSSParameterSpec.java
>  line 103:
> 
>> 101:     }
>> 102: 
>> 103:     @Override
> 
> Since you are overriding `Object.hashCode` and `equals`, I think you should 
> document the specification for that.

For `equals` and `hashCode`, the removed internal 
`org/jcp/xml/dsig/internal/dom/RSAPSSParameterSpec.java` file had them so I 
kept them. But now I intend to remove both. `HMACParameterSpec` in the same 
package does not have them. In fact, I felt a little uncomfortable on using the 
result of `mgfParamsAsString` in `hashCode` and `equals` because even 
`PSSParameterSpec` and `MGF1ParameterSpec` have not implemented them.

As for `toString`, I'm not sure if there needs a spec (and I don't want to 
specify the output format). `PSSParameterSpec` and `MGF1ParameterSpec` 
implemented it with no spec. The documentation at 
https://docs.oracle.com/en/java/javase/16/docs/api/java.base/java/security/spec/MGF1ParameterSpec.html
 also only list it in the "Methods declared in class java.lang.Object" with all 
other `Object` methods no matter if it's overridden or not.

-------------

PR: https://git.openjdk.java.net/jdk/pull/3181

Reply via email to