newrelic / newrelic/newrelic-java-agent

DOCS: -Djavax.xml.transform.TransformerFactory can cause ClassNotFoundException

Open
#1,931 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

1 documentation low priority small
Dominant language
Java
Stars
240
Forks
170
Avg merge
3d 2h
Merged PRs (30d)
21

Description

When customers define -Djavax.xml.transform.TransformerFactory= they can receive a ClassNotFoundException related to this code.

The solution here appears to be adding --add-exports=java.xml/com.sun.org.apache.xalan.internal.xsltc.trax=ALL-UNNAMED to the JVM args.

We should document this problem/solution in the public docs.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the linked ExtensionDomParser.java code around lines 493-522 and the existing public documentation structure. Document the ClassNotFoundException condition involving -Djavax.xml.transform.TransformerFactory= and the proposed --add-exports JVM argument, with completion confirmed by the new public documentation entry.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.