jade-recipe-1.5-1.6-arrays-copyof-full
Replaces the full-array copy idiom System.arraycopy(a, 0, b, 0, a.length) with Java 6 Arrays.copyOf. Agent-mode recipe: the shard contract names the files to edit; this document defines the transform
SKILL.md.claude/skills/java-migration-skill-registry/1.5-to-1.6/jade-recipe-1.5-1.6-arrays-copyof-full/SKILL.md
GitHubjade-recipe-1.5-1.6-arrays-copyof-full — full-array copy → Arrays.copyOf
The Oracle Java SE 6 collections changes page prints this exact idiom as the
"before" and java.util.Arrays.copyOf as the "after". The rule matches only the
full-array form, where both offsets are 0 and the length is the source array's
own length.
Scope of one task
You receive a shard contract. Edit only the files listed in editable_files.
read_only_context is for reading, never for editing.
Transform
For each site in entry_points:
- Confirm the call really is the full-array form:
System.arraycopy(src, 0, dest, 0, src.length)— same identifier insrcand insrc.length, both offsets literal0. - Rewrite to
dest = java.util.Arrays.copyOf(src, src.length);Use the fully qualified name rather than adding an import, so the edit stays inside the statement and cannot collide with an existingArrayssymbol. - Remove the
// JADE-FLAG:ARRAYS_COPYOF_FULL_ARRAY_COPYcomment for that site.
When NOT to transform
Report SKIPPED and leave the code untouched when:
destisfinal, or is a field that must not be reassigned —Arrays.copyOfreturns a new array, so it reassigns the reference instead of filling the existing one. If any other live reference points at the olddestarray, the rewrite changes behaviour. Check the enclosing method before rewriting.destandsrcare the same variable and the result is not reassigned.- either argument is an expression rather than a plain identifier.
A behaviour change here is silent and hard to find. When the aliasing question
cannot be answered from the file plus read_only_context, report SKIPPED.
Invariants
- No edit outside
editable_files. - No public signature changes — this rule is
body-local. - No new import statements; the fully qualified call is deliberate.
Status to report
| status | when |
|---|---|
FIXED |
full-array form confirmed, no aliasing risk, rewritten |
SKIPPED |
aliasing risk, non-identifier arguments, or form not confirmed |
NEEDS_REVIEW |
rewritten, but the aliasing analysis was not conclusive |
FAILED |
file unreadable, or the flagged call is not present |