[I] [FEATURE][Java] Add chunk and edge-range value primitives [incubator-graphar]

["keksmd (via GitHub)" <gi...@apache.org>]

keksmd opened a new issue, #967:
URL: https://github.com/apache/incubator-graphar/issues/967

   ### Describe the enhancement requested
   
   Add the small, storage-free value primitives needed to translate GraphAr ordered-adjacency offsets into exact half-open edge-chunk ranges. This is the first core slice of the pure-Java ordered adjacency reader; metadata URI resolution and physical reading follow separately.
   
   Component(s): Java
   
   ## Scope
   
   - Add `graphar-core` with long-safe chunk-index, in-chunk offset, and chunk-count arithmetic.
   - Add validated half-open `ChunkRange` and `EdgeRange` values, including correct end-exclusive edge-chunk selection.
   - Add unit tests for empty ranges, chunk boundaries, and invalid IDs/sizes/offsets.
   
   ## Non-goals
   
   No storage, Parquet, S3, Arrow, metadata URI resolution, GraphAr reader facade, offsets file decoder, or adjacency data read.
   
   ## Compatibility and acceptance
   
   The API remains Java 11 compatible and depends on no physical IO module. It must reject negative IDs and non-positive chunk sizes. A range `[begin,end)` selects no chunks when empty; nonempty ranges include the chunk containing `end - 1`, not an extra chunk at `end`. Focused Maven verification and pre-commit must pass.
   
   ## Links
   
   Relates to #947, #944, and architecture umbrella #756. The follow-up metadata resolver will use `EdgeInfo` URI methods rather than reconstruct GraphAr paths.


-- 
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: commits-unsubscribe@graphar.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@graphar.apache.org
For additional commands, e-mail: commits-help@graphar.apache.org