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]

Reply via email to