hutiefang76 opened a new pull request, #303: URL: https://github.com/apache/commons-jxpath/pull/303
The [JXPATH-193 report](https://issues.apache.org/jira/browse/JXPATH-193) attempts to access `doubleValue` as a property of a `BigDecimal`. The existing typed `getValue` overload already supports the desired conversion, but its Javadoc has no example showing how to select the numeric value and request a `Double` result. Add that example and distinguish property lookup from Java method invocation. The note also explains using a property or Map entry path for nested numeric values. This changes Javadoc and one release-note entry. All compiled method instructions of `JXPathContext` match the original implementation. Validation: - Full default Maven build on JDK 21.0.10 with Java 8 release: 415 tests, 414 passed, one existing skip, zero failures/errors. RAT, japicmp, Checkstyle, PMD and Javadoc passed. - The example and related BigDecimal, Integer and Map conversions were asserted against unmodified master on actual Java 8 and Java 21. Strict/lenient missing-property behavior was also observed. - Verified the example and explanatory text in the generated Javadoc HTML. No new repository tests were added for this documentation-only change. <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> Thanks for your contribution to [Apache Commons](https://commons.apache.org/)! Your help is appreciated! Before you push a pull request, review this list: - [x] Read the [contribution guidelines](CONTRIBUTING.md) for this project. - [x] Read the [ASF Generative Tooling Guidance](https://www.apache.org/legal/generative-tooling.html) if you use Artificial Intelligence (AI). - [x] I used AI to create any part of, or all of, this pull request. Which AI tool was used to create this pull request, and to what extent did it contribute? - [x] Run a successful build using the default [Maven](https://maven.apache.org/) goal with `mvn`; that's `mvn` on the command line by itself. - [x] Write unit tests that match behavioral changes, where the tests fail if the changes to the runtime are not applied. This may not always be possible, but it is a best practice. - [x] Write a pull request description that is detailed enough to understand what the pull request does, how, and why. - [x] Each commit in the pull request should have a meaningful subject line and body. Note that a maintainer may squash commits during the merge process. AI assistance: DeepSeek Pro drafted the documentation and reviewed the change. OpenAI Codex refined the wording/formatting, verified the existing API behavior, and ran the native build and Javadoc checks. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
