Add 6 Java patterns and fix resource leak in writing-files

[Copilot]

Implementation Complete ✅

• Understand repository structure and pattern schema
• Fix writing-files.json oldCode bug (resource leak issue)
• Add markdown-comments pattern (language category)
• Add static-methods-in-interfaces pattern (language category)
• Add static-members-in-inner-classes pattern (language category)
• Add compact-canonical-constructor pattern (language category)
• Add reverse-list-iteration pattern (collections category)
• Add file-memory-mapping pattern (io category)
• Update prev/next links for all affected patterns
• Run generator to build HTML files
• Test generated pages locally
• Address code review feedback
• Security scan with CodeQL (no issues - JSON only)
• Fix compact-canonical-constructor oldLabel (Java 8 → Java 16)
• Final validation complete

Original prompt

---

This section details on the original issue you should resolve

<issue_title>New patterns</issue_title>
<issue_description>Some missing bits:

• markdown comments
  /// This is a javadoc comment

• static method in interface (Java 8)

• static member in inner classes (Java 16)

  class Main {
  class Book {
  static int globalBookCount;

   Book() {
    globalBookCount++;
   }
  

  }
  }

• compact canonical constructor (for preconditions) (Java 15 ?)

  public record Person(String name, List pets) {
  public {
  Objects.requireNonNull(name);
  pets = List.copyOf(pets);
  }
  }

• loop over a List in reverse order

  for(Iterator iterator = list.listIerator(list.isze()); iterator.hasPrevious();) {
  String element = iterator.previous();
  ...
  }

vs

for(String element : list.reversed()) {
...
}

• File mapping in memory

  FileChannel channel = ...
  MappedByteBuffer buffer = channel.map( FileChannel.MapMode.READ_WRITE, 0, (int) channel.size());
  // file size limited to 2G
  // freed by the GC, no control

vs

FileChannel channel = ...
try (Arena arena = Arena.ofShared()) {
MemorySegment segment = channel.map( FileChannel.MapMode.READ_WRITE, 0, channel.size(), arena);
// no file size limit
...
} // call close() => freed

• The example of "writing files" old style is wrong
  try(BufferedWriter writer = new BufferedWriter(new FileReader(path))) {
  ...
  }

  here if the new BufferedWriterfails to allocate the buffer, close() is not called on the FileReader,
  it should be (using two lines)

  try(FileWriter fileWriter = new FileReader(path);
  BufferedWriter writer = new BufferedWriter(fileWriter)) {
  ...
  }</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes New patterns #18

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[brunoborges]

@copilot slug compact-canonical-constructor says the old way was for Java 8, but records don't exist in Java 8

[Copilot]

@copilot slug compact-canonical-constructor says the old way was for Java 8, but records don't exist in Java 8

Fixed in e247d91. Changed oldLabel from "Java 8" to "Java 16" since both the full canonical constructor and compact canonical constructor are record features available since Java 16.