Class AbstractSurefireReport

java.lang.Object
org.apache.maven.plugin.AbstractMojo
org.apache.maven.reporting.AbstractMavenReport
org.apache.maven.plugins.surefire.report.AbstractSurefireReport
All Implemented Interfaces:
org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo, org.apache.maven.reporting.MavenMultiPageReport, org.apache.maven.reporting.MavenReport
Direct Known Subclasses:
FailsafeOnlyReport, SurefireReport

public abstract class AbstractSurefireReport extends org.apache.maven.reporting.AbstractMavenReport
Abstract base class for reporting test results using Surefire.
  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Class
    Description
    private static class 
     
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private boolean
    Whether to build an aggregated report at the root, or build individual reports.
    private String
    Path for a custom bundle instead of using the default one.
    private org.codehaus.plexus.i18n.I18N
    Internationalization component
    private boolean
    Link the violation line numbers to the (Test) Source XRef.
    private File[]
    Directories containing the XML Report files that will be parsed and rendered to HTML format.
    private File
    Deprecated.
    private List<File>
     
    private org.apache.maven.settings.Settings
    The current user system settings for use in Maven.
    private boolean
    If set to false, only failures are shown.
    private File
    Location where Test Source XRef is generated for this project.

    Fields inherited from class org.apache.maven.reporting.AbstractMavenReport

    locale, mojoExecution, outputDirectory, outputFormat, outputTimestamp, project, reactorProjects, remoteProjectRepositories, repoSession, siteDirectory, siteRenderer, siteTool

    Fields inherited from interface org.apache.maven.reporting.MavenReport

    CATEGORY_PROJECT_INFORMATION, CATEGORY_PROJECT_REPORTS, ROLE

    Fields inherited from interface org.apache.maven.plugin.Mojo

    ROLE
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
     
    private String
     
    void
    protected final org.apache.maven.plugin.surefire.log.api.ConsoleLogger
     
    protected org.codehaus.plexus.i18n.I18N
    getI18N(Locale locale)
     
    protected abstract String
     
    protected String
    getI18nString(Locale locale, String key)
     
    getName(Locale locale)
    abstract String
    protected org.apache.maven.project.MavenProject
     
    private List<org.apache.maven.project.MavenProject>
     
    protected List<org.apache.maven.project.MavenProject>
     
    private List<File>
     
    protected abstract File
    getSurefireReportsDirectory(org.apache.maven.project.MavenProject subProject)
    Gets the default surefire reports directory for the specified project.
    private File
     
    protected boolean
    Whether the report should be generated when there are no test results.
    protected boolean
    Whether the report should be generated or not.

    Methods inherited from class org.apache.maven.reporting.AbstractMavenReport

    closeReport, constructXrefLocation, execute, generate, generate, getCategoryName, getInputEncoding, getLocale, getOutputDirectory, getOutputEncoding, getReportOutputDirectory, getSink, getSinkFactory, getSiteRenderer, getXrefLocation, isExternalReport, setReportOutputDirectory

    Methods inherited from class org.apache.maven.plugin.AbstractMojo

    getLog, getPluginContext, setLog, setPluginContext

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface org.apache.maven.reporting.MavenReport

    getOutputPath
  • Field Details

    • showSuccess

      @Parameter(defaultValue="true", required=true, property="showSuccess") private boolean showSuccess
      If set to false, only failures are shown.
    • reportsDirectories

      @Parameter private File[] reportsDirectories
      Directories containing the XML Report files that will be parsed and rendered to HTML format.
    • reportsDirectory

      @Deprecated @Parameter private File reportsDirectory
      Deprecated.
      (Deprecated, use reportsDirectories) This directory contains the XML Report files that will be parsed and rendered to HTML format.
    • linkXRef

      @Parameter(property="linkXRef", defaultValue="true") private boolean linkXRef
      Link the violation line numbers to the (Test) Source XRef. Links will be created automatically if the JXR plugin is being used.
    • xrefTestLocation

      @Parameter private File xrefTestLocation
      Location where Test Source XRef is generated for this project.
      Default: AbstractMavenReport.getReportOutputDirectory() + /xref-test
    • aggregate

      @Parameter(defaultValue="false", property="aggregate") private boolean aggregate
      Whether to build an aggregated report at the root, or build individual reports.
    • settings

      @Parameter(defaultValue="${settings}", readonly=true, required=true) private org.apache.maven.settings.Settings settings
      The current user system settings for use in Maven.
    • customBundle

      @Parameter(defaultValue="${basedir}/src/site/custom/surefire-report.properties") private String customBundle
      Path for a custom bundle instead of using the default one.
      Using this field, you could change the texts in the generated reports.
      Since:
      3.1.0
    • i18n

      @Component private org.codehaus.plexus.i18n.I18N i18n
      Internationalization component
    • resolvedReportsDirectories

      private List<File> resolvedReportsDirectories
  • Constructor Details

    • AbstractSurefireReport

      public AbstractSurefireReport()
  • Method Details

    • isSkipped

      protected boolean isSkipped()
      Whether the report should be generated or not.
      Returns:
      true if and only if the report should be generated.
      Since:
      2.11
    • isGeneratedWhenNoResults

      protected boolean isGeneratedWhenNoResults()
      Whether the report should be generated when there are no test results.
      Returns:
      true if and only if the report should be generated when there are no result files at all.
      Since:
      2.11
    • executeReport

      public void executeReport(Locale locale)
      Specified by:
      executeReport in class org.apache.maven.reporting.AbstractMavenReport
    • canGenerateReport

      public boolean canGenerateReport()
      Specified by:
      canGenerateReport in interface org.apache.maven.reporting.MavenReport
      Overrides:
      canGenerateReport in class org.apache.maven.reporting.AbstractMavenReport
    • getReportsDirectories

      private List<File> getReportsDirectories()
    • getSurefireReportsDirectory

      protected abstract File getSurefireReportsDirectory(org.apache.maven.project.MavenProject subProject)
      Gets the default surefire reports directory for the specified project.
      Parameters:
      subProject - the project to query.
      Returns:
      the default surefire reports directory for the specified project.
    • getProjectsWithoutRoot

      private List<org.apache.maven.project.MavenProject> getProjectsWithoutRoot()
    • constructXrefTestLocation

      private String constructXrefTestLocation()
    • getXrefTestLocation

      private File getXrefTestLocation()
    • getI18nString

      protected String getI18nString(Locale locale, String key)
      Parameters:
      locale - The locale
      key - The key to search for
      Returns:
      The text appropriate for the locale.
    • getI18N

      protected org.codehaus.plexus.i18n.I18N getI18N(Locale locale)
      Parameters:
      locale - The local.
      Returns:
      I18N for the locale
    • getI18Nsection

      protected abstract String getI18Nsection()
      Returns:
      The according string for the section.
    • getName

      public String getName(Locale locale)
    • getDescription

      public String getDescription(Locale locale)
    • getOutputName

      public abstract String getOutputName()
    • getConsoleLogger

      protected final org.apache.maven.plugin.surefire.log.api.ConsoleLogger getConsoleLogger()
    • getProject

      protected org.apache.maven.project.MavenProject getProject()
      Overrides:
      getProject in class org.apache.maven.reporting.AbstractMavenReport
    • getReactorProjects

      protected List<org.apache.maven.project.MavenProject> getReactorProjects()