Skip to content

Document Java security spec key contracts - #557

Merged
jonathanpeppers merged 1 commit into
mainfrom
jonathanpeppers-java-security-spec-docs
Aug 16, 2026
Merged

Document Java security spec key contracts#557
jonathanpeppers merged 1 commit into
mainfrom
jonathanpeppers-java-security-spec-docs

Conversation

@jonathanpeppers

Copy link
Copy Markdown
Member

Summary

  • Document NullPointerException contracts for the four modern EdEC/XEC key-spec constructors.

Sources

Validation

  • Parsed all four edited XML files.
  • Confirmed CRLF line endings and git diff --check.

Refs #228

Refs #228

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the API reference XML documentation for Java.Security.Spec to explicitly document NullPointerException contracts for the “modern” EdEC/XEC key-spec constructors, aligning the docs with the upstream AOSP Java specifications.

Changes:

  • Add NullPointerException <exception> entries for XECPublicKeySpec and XECPrivateKeySpec constructors when required arguments are null.
  • Add NullPointerException <exception> entries for EdECPublicKeySpec and EdECPrivateKeySpec constructors when required arguments are null.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File Description
docs/xml/Java.Security.Spec/XECPublicKeySpec.xml Documents NullPointerException for null params/u constructor arguments.
docs/xml/Java.Security.Spec/XECPrivateKeySpec.xml Documents NullPointerException for null params/scalar constructor arguments.
docs/xml/Java.Security.Spec/EdECPublicKeySpec.xml Documents NullPointerException for null params/point constructor arguments.
docs/xml/Java.Security.Spec/EdECPrivateKeySpec.xml Documents NullPointerException for null params/bytes constructor arguments.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto review

1 similar comment
@jonathanpeppers

Copy link
Copy Markdown
Member Author

@dalexsoto review

@dalexsoto dalexsoto left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The four EdEC/XEC constructor exception contracts match the Android and Java specifications, with complete managed-signature parity.

@jonathanpeppers
jonathanpeppers merged commit 4f035ae into main Aug 16, 2026
4 checks passed
@jonathanpeppers
jonathanpeppers deleted the jonathanpeppers-java-security-spec-docs branch August 16, 2026 02:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants