2022-03-27 15:04:13 +00:00
<!DOCTYPE html>
< html >
< head >
< meta charset = "utf-8" >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
2023-03-03 20:15:41 +00:00
< meta name = "description" content = "Java-specific features and guidance" >
< meta name = "keywords" content = "languages, " >
< title > Java support | PMD Source Code Analyzer< / title >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< link rel = "stylesheet" type = "text/css" href = "assets/fontawesome-free-5.14.0-web/css/all.min.css" >
< link rel = "stylesheet" type = "text/css" href = "assets/bootstrap-4.5.2-dist/css/bootstrap.min.css" >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< link rel = "stylesheet" type = "text/css" href = "css/syntax.css" >
< link rel = "stylesheet" type = "text/css" href = "css/modern-business.css" >
< link rel = "stylesheet" type = "text/css" href = "css/customstyles.css" >
< link rel = "stylesheet" type = "text/css" href = "css/theme-green.css" >
< link rel = "stylesheet" type = "text/css" href = "css/pmd-customstyles.css" >
2022-03-27 15:04:13 +00:00
< link rel = "shortcut icon" href = "images/favicon.ico" type = "image/x-icon" >
< link rel = "icon" href = "images/favicon.ico" type = "image/x-icon" >
2023-03-03 20:15:41 +00:00
< link rel = "alternate" type = "application/rss+xml" title = "" href = "feed.xml" >
2022-03-27 15:04:13 +00:00
< / head >
< body >
<!-- Content is offset by the height of the topnav bar. -->
<!-- There's already a padding - top rule in modern - business.css, but it apparently doesn't work on Firefox 60 and Chrome 67 -->
< div id = "topbar-content-offset" >
<!-- Navigation -->
2023-03-03 20:15:41 +00:00
< nav class = "navbar navbar-expand-lg fixed-top navbar-dark" >
2022-03-27 15:04:13 +00:00
< div class = "container topnavlinks" >
2023-03-03 20:15:41 +00:00
< a class = "navbar-brand fas fa-home fa-lg" href = "index.html" > < span class = "projectTitle" > PMD Source Code Analyzer Project< / span > < / a >
< button class = "navbar-toggler" type = "button" data-toggle = "collapse" data-target = "#navbarSupportedContent" aria-controls = "navbarSupportedContent" aria-expanded = "false" aria-label = "Toggle navigation" >
< span class = "navbar-toggler-icon" > < / span >
< / button >
< div class = "collapse navbar-collapse" id = "navbarSupportedContent" >
< ul class = "navbar-nav mr-auto mt-2 mt-lg-0" > < / ul >
< ul class = "navbar-nav" >
2022-03-27 15:04:13 +00:00
<!-- toggle sidebar button -->
2023-03-03 20:15:41 +00:00
< li class = "nav-item" > < a id = "tg-sb-link" class = "nav-link" href = "#" > < i id = "tg-sb-icon" class = "fas fa-toggle-on" > < / i > Nav< / a > < / li >
2022-03-27 15:04:13 +00:00
<!-- entries without drop - downs appear here -->
2023-03-03 20:15:41 +00:00
< li class = "nav-item" > < a class = "nav-link" href = "https://github.com/pmd/pmd/releases/latest" target = "_blank" > Download< / a > < / li >
< li class = "nav-item" > < a class = "nav-link" href = "https://github.com/pmd/pmd" target = "_blank" > Fork us on github< / a > < / li >
2022-03-27 15:04:13 +00:00
<!-- entries with drop - downs appear here -->
<!-- conditional logic to control which topnav appears for the audience defined in the configuration file. -->
< / ul >
2023-03-03 20:15:41 +00:00
< form class = "form-inline my-2 my-lg-0" >
< input class = "form-control mr-sm-2" type = "search" placeholder = "search..." id = "search-input" >
< ul id = "results-container" > < / ul >
< / form >
2022-03-27 15:04:13 +00:00
< / div >
2023-03-03 20:15:41 +00:00
< / div >
2022-03-27 15:04:13 +00:00
< / nav >
<!-- Page Content -->
< div class = "container-toc-wrapper" >
< div class = "container" >
< div class = "col-lg-12" > < / div >
<!-- Content Row -->
< div class = "row" >
<!-- Sidebar Column -->
< div class = "col-md-3" id = "tg-sb-sidebar" >
< ul id = "mysidebar" class = "nav" >
2023-03-03 20:15:41 +00:00
< li class = "sidebarTitle" > PMD 7.0.0-SNAPSHOT< / li >
< div class = "sidebarTitleDate" > Release date: ??-?????-2023< / div >
2022-03-27 15:04:13 +00:00
< li >
< a href = "#" > About< / a >
< ul >
< li > < a href = "index.html" > Home< / a > < / li >
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_release_notes7.html" > Release notes< / a > < / li >
2022-03-27 15:04:13 +00:00
< li > < a href = "pmd_next_major_development.html" > PMD 7.0.0 development< / a > < / li >
< li > < a href = "pmd_about_help.html" > Getting help< / a > < / li >
< / ul >
< / li >
< li >
< a href = "#" > User Documentation< / a >
< ul >
< li > < a href = "pmd_userdocs_installation.html" > Installation and basic CLI usage< / a > < / li >
< li > < a href = "pmd_userdocs_making_rulesets.html" > Making rulesets< / a > < / li >
< li > < a href = "pmd_userdocs_configuring_rules.html" > Configuring rules< / a > < / li >
< li > < a href = "pmd_userdocs_best_practices.html" > Best practices< / a > < / li >
< li > < a href = "pmd_userdocs_suppressing_warnings.html" > Suppressing warnings< / a > < / li >
< li > < a href = "pmd_userdocs_incremental_analysis.html" > Incremental analysis< / a > < / li >
< li > < a href = "pmd_userdocs_cli_reference.html" > PMD CLI reference< / a > < / li >
< li > < a href = "pmd_userdocs_report_formats.html" > PMD Report formats< / a > < / li >
2022-09-29 15:04:50 +00:00
< li > < a href = "pmd_userdocs_3rdpartyrulesets.html" > 3rd party rulesets< / a > < / li >
2022-03-27 15:04:13 +00:00
< li class = "subfolders" >
< a href = "#" > CPD reference< / a >
< ul >
< li > < a href = "pmd_userdocs_cpd.html" > Copy-paste detection< / a > < / li >
< li > < a href = "pmd_userdocs_cpd_report_formats.html" > CPD Report formats< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Extending PMD< / a >
< ul >
< li > < a href = "pmd_userdocs_extending_writing_rules_intro.html" > Introduction to writing rules< / a > < / li >
< li > < a href = "pmd_userdocs_extending_your_first_rule.html" > Your first rule< / a > < / li >
< li > < a href = "pmd_userdocs_extending_writing_xpath_rules.html" > XPath rules< / a > < / li >
< li > < a href = "pmd_userdocs_extending_writing_java_rules.html" > Java rules< / a > < / li >
< li > < a href = "pmd_userdocs_extending_designer_reference.html" > Rule designer reference< / a > < / li >
< li > < a href = "pmd_userdocs_extending_defining_properties.html" > Defining rule properties< / a > < / li >
< li > < a href = "pmd_userdocs_extending_rule_guidelines.html" > Rule guidelines< / a > < / li >
< li > < a href = "pmd_userdocs_extending_testing.html" > Testing your rules< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Tools / Integrations< / a >
< ul >
< li > < a href = "pmd_userdocs_tools_maven.html" > Maven PMD Plugin< / a > < / li >
< li > < a href = "pmd_userdocs_tools_gradle.html" > Gradle< / a > < / li >
< li > < a href = "pmd_userdocs_tools_ant.html" > Ant< / a > < / li >
< li > < a href = "pmd_userdocs_tools_java_api.html" > PMD Java API< / a > < / li >
< li > < a href = "pmd_userdocs_tools_ci.html" > CI integrations< / a > < / li >
< li > < a href = "pmd_userdocs_tools.html" > Other Tools / Integrations< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< li >
< a href = "#" > Rule Reference< / a >
< ul >
< li class = "subfolders" >
< a href = "#" > Apex Rules< / a >
< ul >
< li > < a href = "pmd_rules_apex.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_apex_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_apex_codestyle.html" > Code Style< / a > < / li >
< li > < a href = "pmd_rules_apex_design.html" > Design< / a > < / li >
< li > < a href = "pmd_rules_apex_documentation.html" > Documentation< / a > < / li >
< li > < a href = "pmd_rules_apex_errorprone.html" > Error Prone< / a > < / li >
< li > < a href = "pmd_rules_apex_performance.html" > Performance< / a > < / li >
< li > < a href = "pmd_rules_apex_security.html" > Security< / a > < / li >
< / ul >
< / li >
2022-04-28 13:34:56 +00:00
< li class = "subfolders" >
< a href = "#" > HTML Rules< / a >
< ul >
< li > < a href = "pmd_rules_html.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_html_bestpractices.html" > Best Practices< / a > < / li >
< / ul >
< / li >
2022-03-27 15:04:13 +00:00
< li class = "subfolders" >
< a href = "#" > Java Rules< / a >
< ul >
< li > < a href = "pmd_rules_java.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_java_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_java_codestyle.html" > Code Style< / a > < / li >
< li > < a href = "pmd_rules_java_design.html" > Design< / a > < / li >
< li > < a href = "pmd_rules_java_documentation.html" > Documentation< / a > < / li >
< li > < a href = "pmd_rules_java_errorprone.html" > Error Prone< / a > < / li >
< li > < a href = "pmd_rules_java_multithreading.html" > Multithreading< / a > < / li >
< li > < a href = "pmd_rules_java_performance.html" > Performance< / a > < / li >
< li > < a href = "pmd_rules_java_security.html" > Security< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Java Server Pages Rules< / a >
< ul >
< li > < a href = "pmd_rules_jsp.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_jsp_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_jsp_codestyle.html" > Code Style< / a > < / li >
< li > < a href = "pmd_rules_jsp_design.html" > Design< / a > < / li >
< li > < a href = "pmd_rules_jsp_errorprone.html" > Error Prone< / a > < / li >
< li > < a href = "pmd_rules_jsp_security.html" > Security< / a > < / li >
< / ul >
< / li >
2023-03-03 20:15:41 +00:00
< li class = "subfolders" >
< a href = "#" > JavaScript Rules< / a >
< ul >
< li > < a href = "pmd_rules_ecmascript.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_ecmascript_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_ecmascript_codestyle.html" > Code Style< / a > < / li >
< li > < a href = "pmd_rules_ecmascript_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Kotlin Rules< / a >
< ul >
< li > < a href = "pmd_rules_kotlin.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_kotlin_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_kotlin_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
2022-03-27 15:04:13 +00:00
< li class = "subfolders" >
< a href = "#" > Maven POM Rules< / a >
< ul >
< li > < a href = "pmd_rules_pom.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_pom_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Modelica Rules< / a >
< ul >
< li > < a href = "pmd_rules_modelica.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_modelica_bestpractices.html" > Best Practices< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > PLSQL Rules< / a >
< ul >
< li > < a href = "pmd_rules_plsql.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_plsql_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_plsql_codestyle.html" > Code Style< / a > < / li >
< li > < a href = "pmd_rules_plsql_design.html" > Design< / a > < / li >
< li > < a href = "pmd_rules_plsql_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Salesforce VisualForce Rules< / a >
< ul >
< li > < a href = "pmd_rules_vf.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_vf_security.html" > Security< / a > < / li >
< / ul >
< / li >
2022-11-18 15:25:16 +00:00
< li class = "subfolders" >
< a href = "#" > Scala Rules< / a >
< ul >
< li > < a href = "pmd_rules_scala.html" > Index< / a > < / li >
< / ul >
< / li >
2023-03-03 20:15:41 +00:00
< li class = "subfolders" >
< a href = "#" > Swift Rules< / a >
< ul >
< li > < a href = "pmd_rules_swift.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_swift_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_swift_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
2022-03-27 15:04:13 +00:00
< li class = "subfolders" >
< a href = "#" > VM Rules< / a >
< ul >
< li > < a href = "pmd_rules_vm.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_vm_bestpractices.html" > Best Practices< / a > < / li >
< li > < a href = "pmd_rules_vm_design.html" > Design< / a > < / li >
< li > < a href = "pmd_rules_vm_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
2022-11-18 15:25:16 +00:00
< li class = "subfolders" >
< a href = "#" > WSDL Rules< / a >
< ul >
< li > < a href = "pmd_rules_wsdl.html" > Index< / a > < / li >
< / ul >
< / li >
2022-03-27 15:04:13 +00:00
< li class = "subfolders" >
< a href = "#" > XML Rules< / a >
< ul >
< li > < a href = "pmd_rules_xml.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_xml_errorprone.html" > Error Prone< / a > < / li >
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > XSL Rules< / a >
< ul >
< li > < a href = "pmd_rules_xsl.html" > Index< / a > < / li >
< li > < a href = "pmd_rules_xsl_codestyle.html" > Code Style< / a > < / li >
< li > < a href = "pmd_rules_xsl_performance.html" > Performance< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< li >
2023-03-03 20:15:41 +00:00
< a href = "#" > Language-Specific Documentation< / a >
2022-03-27 15:04:13 +00:00
< ul >
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_languages_configuration.html" > Language configuration< / a > < / li >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_languages_apex.html" > Apex< / a > < / li >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< li class = "active" > < a href = "pmd_languages_java.html" > Java< / a > < / li >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_languages_jsp.html" > JSP< / a > < / li >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_languages_kotlin.html" > Kotlin< / a > < / li >
2022-03-27 15:04:13 +00:00
< li > < a href = "pmd_languages_plsql.html" > PLSQL< / a > < / li >
< li > < a href = "pmd_languages_visualforce.html" > Visualforce< / a > < / li >
< li > < a href = "pmd_languages_xml.html" > XML and XML dialects< / a > < / li >
2022-04-28 13:34:56 +00:00
< li > < a href = "pmd_languages_html.html" > HTML< / a > < / li >
2022-07-01 07:55:16 +00:00
< li > < a href = "pmd_languages_gherkin.html" > Gherkin< / a > < / li >
2022-03-27 15:04:13 +00:00
< / ul >
< / li >
< li >
< a href = "#" > Developer Documentation< / a >
< ul >
< li > < a href = "pmd_devdocs_development.html" > Developer resources< / a > < / li >
< li > < a href = "pmd_devdocs_building.html" > Building PMD from source< / a > < / li >
< li > < a href = "https://github.com/pmd/pmd/blob/master/CONTRIBUTING.md" target = "_blank" > Contributing< / a > < / li >
< li > < a href = "pmd_devdocs_writing_documentation.html" > Writing documentation< / a > < / li >
< li > < a href = "pmd_devdocs_roadmap.html" > Roadmap< / a > < / li >
< li > < a href = "pmd_devdocs_how_pmd_works.html" > How PMD works< / a > < / li >
< li > < a href = "pmd_devdocs_pmdtester.html" > Pmdtester< / a > < / li >
< li > < a href = "pmd_devdocs_rule_deprecation_policy.html" > Rule Deprecation Policy< / a > < / li >
< li class = "subfolders" >
< a href = "#" > Major contributions< / a >
< ul >
< li > < a href = "pmd_devdocs_major_rule_guidelines.html" > Rule Guidelines< / a > < / li >
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_devdocs_major_adding_new_language_javacc.html" > Adding a new language (JavaCC)< / a > < / li >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_devdocs_major_adding_new_language_antlr.html" > Adding a new language (Antlr)< / a > < / li >
2022-03-27 15:04:13 +00:00
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_devdocs_major_adding_new_cpd_language.html" > Adding a new CPD language< / a > < / li >
2022-03-27 15:04:13 +00:00
< / ul >
< / li >
< li class = "subfolders" >
< a href = "#" > Experimental features< / a >
< ul >
< li > < a href = "pmd_devdocs_experimental_ast_dump.html" > Creating (XML) dump of the AST< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< li >
< a href = "#" > Project documentation< / a >
< ul >
< li class = "subfolders" >
< a href = "#" > Trivia about PMD< / a >
< ul >
< li > < a href = "pmd_projectdocs_trivia_news.html" > PMD in the press< / a > < / li >
< li > < a href = "pmd_projectdocs_trivia_products.html" > Products & books related to PMD< / a > < / li >
< li > < a href = "pmd_projectdocs_trivia_similarprojects.html" > Similar projects< / a > < / li >
< li > < a href = "pmd_projectdocs_trivia_meaning.html" > What does 'PMD' mean?< / a > < / li >
< / ul >
< / li >
2023-03-03 20:15:41 +00:00
< li > < a href = "pmd_projectdocs_logo.html" > Logo< / a > < / li >
2022-03-27 15:04:13 +00:00
< li > < a href = "pmd_projectdocs_faq.html" > FAQ< / a > < / li >
< li > < a href = "license.html" > License< / a > < / li >
< li > < a href = "pmd_projectdocs_credits.html" > Credits< / a > < / li >
< li > < a href = "pmd_release_notes_old.html" > Old release notes< / a > < / li >
2022-09-30 10:03:06 +00:00
< li > < a href = "pmd_projectdocs_decisions.html" > Decisions< / a > < / li >
2022-03-27 15:04:13 +00:00
< li class = "subfolders" >
< a href = "#" > Project management< / a >
< ul >
< li > < a href = "pmd_projectdocs_committers_infrastructure.html" > Infrastructure< / a > < / li >
< li > < a href = "pmd_projectdocs_committers_releasing.html" > Release process< / a > < / li >
< li > < a href = "pmd_projectdocs_committers_merging_pull_requests.html" > Merging pull requests< / a > < / li >
< li > < a href = "pmd_projectdocs_committers_main_landing_page.html" > Main Landing page< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< / ul >
< / div >
<!-- Content Column -->
< div class = "col-md-9" id = "tg-sb-content" >
< header >
< div class = "row" >
< div class = "col-lg-12" >
< a href = "./" role = "button"
>< i class = "fa fa-home fa-lg" > < /i
>< / a >
2023-03-03 20:15:41 +00:00
» Java support
2022-03-27 15:04:13 +00:00
< a
target="_blank"
href="https://github.com/pmd/pmd/blob/master/docs/pages/pmd/languages/java.md"
2023-03-03 20:15:41 +00:00
class="float-right"
2022-03-27 15:04:13 +00:00
role="button"
>< i class = "fa fa-github fa-lg" > < / i > Edit on GitHub< /a
>
< / div >
< / div >
< hr / >
< / header >
< div class = "post-header" >
2023-03-03 20:15:41 +00:00
< h1 class = "post-title-main" > Java support< / h1 >
2022-03-27 15:04:13 +00:00
< / div >
< div class = "post-content" data-github-edit-url = "https://github.com/pmd/pmd/blob/master/docs/pages/pmd/languages/java.md" >
2023-03-03 20:15:41 +00:00
< div class = "summary" > Java-specific features and guidance< / div >
2022-03-27 15:04:13 +00:00
< div id = "inline-toc" > <!-- empty, move TOC here when screen size too small --> < / div >
2023-03-03 20:15:41 +00:00
< div class = "alert alert-danger" role = "alert" > < i class = "fas fa-exclamation-circle" > < / i > < b > Warning:< / b > WIP, todo for pmd 7< / div >
< h2 id = "overview-of-supported-java-language-versions" > Overview of supported Java language versions< / h2 >
2022-03-27 15:04:13 +00:00
< p > Usually the latest non-preview Java Version is the default version.< / p >
< table >
< thead >
< tr >
< th > Java Version< / th >
< th > Alias< / th >
< th > Supported by PMD since< / th >
< / tr >
< / thead >
< tbody >
< tr >
2023-02-23 12:18:02 +00:00
< td > 20-preview< / td >
2022-03-27 15:04:13 +00:00
< td > < / td >
2023-02-23 12:18:02 +00:00
< td > 6.55.0< / td >
< / tr >
< tr >
< td > 20 (default)< / td >
< td > < / td >
< td > 6.55.0< / td >
2022-07-13 19:34:44 +00:00
< / tr >
< tr >
2023-02-23 12:18:02 +00:00
< td > 19-preview< / td >
2022-07-13 19:34:44 +00:00
< td > < / td >
< td > 6.48.0< / td >
2022-03-27 15:04:13 +00:00
< / tr >
< tr >
2023-02-23 12:18:02 +00:00
< td > 19< / td >
2022-03-27 15:04:13 +00:00
< td > < / td >
2023-02-23 12:18:02 +00:00
< td > 6.48.0< / td >
2022-03-27 15:04:13 +00:00
< / tr >
< tr >
2022-07-13 19:34:44 +00:00
< td > 18< / td >
2022-03-27 15:04:13 +00:00
< td > < / td >
2022-07-13 19:34:44 +00:00
< td > 6.44.0< / td >
2022-03-27 15:04:13 +00:00
< / tr >
< tr >
< td > 17< / td >
< td > < / td >
< td > 6.37.0< / td >
< / tr >
< tr >
< td > 16< / td >
< td > < / td >
< td > 6.32.0< / td >
< / tr >
< tr >
< td > 15< / td >
< td > < / td >
< td > 6.27.0< / td >
< / tr >
< tr >
< td > 14< / td >
< td > < / td >
< td > 6.22.0< / td >
< / tr >
< tr >
< td > 13< / td >
< td > < / td >
< td > 6.18.0< / td >
< / tr >
< tr >
< td > 12< / td >
< td > < / td >
< td > 6.13.0< / td >
< / tr >
< tr >
< td > 11< / td >
< td > < / td >
< td > 6.6.0< / td >
< / tr >
< tr >
< td > 10< / td >
< td > 1.10< / td >
< td > 6.4.0< / td >
< / tr >
< tr >
< td > 9< / td >
< td > 1.9< / td >
< td > 6.0.0< / td >
< / tr >
< tr >
< td > 8< / td >
< td > 1.8< / td >
< td > 5.1.0< / td >
< / tr >
< tr >
< td > 7< / td >
< td > 1.7< / td >
< td > 5.0.0< / td >
< / tr >
< tr >
< td > 6< / td >
< td > 1.6< / td >
< td > 3.9< / td >
< / tr >
< tr >
< td > 5< / td >
< td > 1.5< / td >
< td > 3.0< / td >
< / tr >
< tr >
< td > 1.4< / td >
< td > < / td >
< td > 1.2.2< / td >
< / tr >
< tr >
< td > 1.3< / td >
< td > < / td >
< td > 1.0.0< / td >
< / tr >
< / tbody >
< / table >
< h2 id = "using-java-preview-features" > Using Java preview features< / h2 >
< p > In order to analyze a project with PMD that uses preview language features, you’
2023-02-23 12:18:02 +00:00
it via the environment variable < code class = "language-plaintext highlighter-rouge" > PMD_JAVA_OPTS< / code > and select the new language version, e.g. < code class = "language-plaintext highlighter-rouge" > 20-preview< / code > :< / p >
2022-03-27 15:04:13 +00:00
< div class = "language-plaintext highlighter-rouge" > < div class = "highlight" > < pre class = "highlight" > < code > export PMD_JAVA_OPTS=--enable-preview
2023-03-03 20:15:41 +00:00
pmd check --use-version java-20-preview ...
2022-03-27 15:04:13 +00:00
< / code > < / pre > < / div > < / div >
< p > Note: we only support preview language features for the latest two java versions.< / p >
2023-03-03 20:15:41 +00:00
< h2 id = "type-and-symbol-resolution" > Type and symbol resolution< / h2 >
2022-12-07 14:00:28 +00:00
2023-03-03 20:15:41 +00:00
< p > Java being a statically typed language, a Java program contains more information that just its syntax tree; for instance, every expression has a static type, and every method call is bound to a method overload statically (even if that overload is virtual). In PMD, much of this information is resolved from the AST by additional passes, which run after parsing, and before rules can inspect the tree.< / p >
< p > The semantic analysis roughly works like so:< / p >
< ol >
< li > The first passes resolve < em > symbols< / em > , which are a model of the named entities that Java programs declare, like classes, methods, and variables.< / li >
< li > Then, each name in the tree is resolved to a symbol, according to the language’ < em > ambiguous names< / em > (names which could be either a type, package, or variable).< / li >
< li > The last pass resolves the types of expressions, which performs overload resolution on method calls, and type inference.< / li >
< / ol >
< p > TODO describe< / p >
< ul >
< li > why we need auxclasspath< / li >
< li > how disambiguation can fail< / li >
< / ul >
< h2 id = "type-and-symbol-apis" > Type and symbol APIs< / h2 >
< p > TODO describe APIs< / p >
< h2 id = "metrics-framework" > Metrics framework< / h2 >
< p > In order to use code metrics in Java, use the metrics constants in < a href = "https://docs.pmd-code.org/apidocs/pmd-java/7.0.0-SNAPSHOT/net/sourceforge/pmd/lang/java/metrics/JavaMetrics.html#" > < code > JavaMetrics< / code > < / a > ,
together with < a href = "https://docs.pmd-code.org/apidocs/pmd-core/7.0.0-SNAPSHOT/net/sourceforge/pmd/lang/metrics/MetricsUtil.html#" > < code > MetricsUtil< / code > < / a > . For instance:< / p >
< div class = "language-java highlighter-rouge" > < div class = "highlight" > < pre class = "highlight" > < code > < span class = "nd" > @Override< / span >
< span class = "kd" > public< / span > < span class = "nc" > Object< / span > < span class = "nf" > visit< / span > < span class = "o" > (< / span > < span class = "nc" > ASTMethodDeclaration< / span > < span class = "n" > node< / span > < span class = "o" > ,< / span > < span class = "nc" > Object< / span > < span class = "n" > data< / span > < span class = "o" > )< / span > < span class = "o" > {< / span >
< span class = "k" > if< / span > < span class = "o" > (< / span > < span class = "nc" > JavaMetrics< / span > < span class = "o" > .< / span > < span class = "na" > NCSS< / span > < span class = "o" > .< / span > < span class = "na" > supports< / span > < span class = "o" > (< / span > < span class = "n" > node< / span > < span class = "o" > ))< / span > < span class = "o" > {< / span >
< span class = "kt" > int< / span > < span class = "n" > methodSize< / span > < span class = "o" > =< / span > < span class = "nc" > MetricsUtil< / span > < span class = "o" > .< / span > < span class = "na" > computeMetric< / span > < span class = "o" > (< / span > < span class = "nc" > JavaMetrics< / span > < span class = "o" > .< / span > < span class = "na" > NCSS< / span > < span class = "o" > ,< / span > < span class = "n" > node< / span > < span class = "o" > ,< / span > < span class = "n" > ncssOptions< / span > < span class = "o" > );< / span >
< span class = "k" > if< / span > < span class = "o" > (< / span > < span class = "n" > methodSize< / span > < span class = "o" > > =< / span > < span class = "n" > level< / span > < span class = "o" > )< / span > < span class = "o" > {< / span >
< span class = "n" > addViolation< / span > < span class = "o" > (< / span > < span class = "n" > data< / span > < span class = "o" > ,< / span > < span class = "n" > node< / span > < span class = "o" > );< / span >
< span class = "o" > }< / span >
< span class = "o" > }< / span >
< span class = "k" > return< / span > < span class = "kc" > null< / span > < span class = "o" > ;< / span >
< span class = "o" > }< / span >
< / code > < / pre > < / div > < / div >
< p > The Javadocs are the reference documentation.< / p >
2022-12-07 14:00:28 +00:00
2022-03-27 15:04:13 +00:00
< div class = "tags" >
2023-03-03 20:15:41 +00:00
< b > Tags: < / b >
< a href = "tag_languages.html" class = "btn btn-outline-secondary navbar-btn cursorNorm" role = "button" > languages< / a >
2022-03-27 15:04:13 +00:00
< / div >
< / div >
< footer >
< hr / >
< div >
This documentation is written in markdown. < br / >
If there is something missing or can be improved, edit this page on
github and create a PR:
< a
target="_blank"
href="https://github.com/pmd/pmd/blob/master/docs/pages/pmd/languages/java.md"
role="button"
>< i class = "fa fa-github fa-lg" > < / i > Edit on GitHub< /a
>
< / div >
< hr / >
< div class = "row" >
< div class = "col-lg-12 footer" >
2023-01-01 04:26:09 +00:00
© 2023 PMD Open Source Project. All rights
2022-03-27 15:04:13 +00:00
reserved. < br / >
2023-03-03 20:15:41 +00:00
< span > Page last updated:< / span >
2023-03-04 21:22:12 +00:00
March 2021 (7.0.0)< br / > Site last generated: Mar 4, 2023 < br / >
2022-03-27 15:04:13 +00:00
< p >
2023-03-03 20:15:41 +00:00
< img src = "images/logo/pmd-logo-70px.png" alt = "PMD
2022-03-27 15:04:13 +00:00
logo"/>
< / p >
< / div >
< / div >
< / footer >
< / div >
<!-- /.row -->
< / div >
<!-- /.container -->
< / div >
<!-- Sticky TOC column -->
< div class = "toc-col" >
< div id = "toc" > < / div >
< / div >
<!-- /.toc - container - wrapper -->
< / div >
< / div >
2023-03-03 20:15:41 +00:00
< script type = "application/javascript" src = "assets/jquery-3.5.1/jquery-3.5.1.min.js" > < / script >
< script type = "application/javascript" src = "assets/anchorjs-4.2.2/anchor.min.js" > < / script >
< script type = "application/javascript" src = "assets/navgoco-0.2.1/src/jquery.navgoco.min.js" > < / script >
< script type = "application/javascript" src = "assets/bootstrap-4.5.2-dist/js/bootstrap.bundle.min.js" > < / script >
< script type = "application/javascript" src = "assets/Simple-Jekyll-Search-1.0.8/dest/jekyll-search.js" > < / script >
< script type = "application/javascript" src = "assets/jekyll-table-of-contents/toc.js" > < / script >
< script type = "application/javascript" src = "js/tabstate.js" > < / script >
< script type = "application/javascript" src = "js/customscripts.js" > < / script >
< / body >
2022-03-27 15:04:13 +00:00
< / html >
