Class ExecDumpClient

java.lang.Object
org.jacoco.core.tools.ExecDumpClient

public class ExecDumpClient extends Object
A client for remote execution data dumps.
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private boolean
     
    private boolean
     
    private int
     
    private long
     
  • Constructor Summary

    Constructors
    Constructor
    Description
    New instance with the defaults dump==true, reset==false, retryCount==0 and retryDelay=1000.
  • Method Summary

    Modifier and Type
    Method
    Description
    dump(String address, int port)
    Requests a dump from the given end-point.
    dump(InetAddress address, int port)
    Requests a dump from the given end-point.
    protected void
    onConnecting(InetAddress address, int port)
    This method can be overwritten to get an event just before a connection is made.
    protected void
    This method can be overwritten to get an event for connection failures when another retry will be attempted.
    void
    setDump(boolean dump)
    Specifies whether a dump should be requested
    void
    setReset(boolean reset)
    Specifies whether execution data should be reset.
    void
    setRetryCount(int retryCount)
    Sets the number of retry attempts to connect to the target socket.
    void
    setRetryDelay(long retryDelay)
    Sets the delay time before between connection attempts.
    private void
     
    private Socket
    tryConnect(InetAddress address, int port)
     

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • dump

      private boolean dump
    • reset

      private boolean reset
    • retryCount

      private int retryCount
    • retryDelay

      private long retryDelay
  • Constructor Details

    • ExecDumpClient

      public ExecDumpClient()
      New instance with the defaults dump==true, reset==false, retryCount==0 and retryDelay=1000.
  • Method Details

    • setDump

      public void setDump(boolean dump)
      Specifies whether a dump should be requested
      Parameters:
      dump - true if a dump should be requested
    • setReset

      public void setReset(boolean reset)
      Specifies whether execution data should be reset.
      Parameters:
      reset - true if execution data should be reset
    • setRetryCount

      public void setRetryCount(int retryCount)
      Sets the number of retry attempts to connect to the target socket. This allows to wait for a certain time until the target agent has initialized.
      Parameters:
      retryCount - number of retries
    • setRetryDelay

      public void setRetryDelay(long retryDelay)
      Sets the delay time before between connection attempts.
      Parameters:
      retryDelay - delay in milliseconds
    • dump

      public ExecFileLoader dump(String address, int port) throws IOException
      Requests a dump from the given end-point.
      Parameters:
      address - IP-Address to connect to
      port - port to connect to
      Returns:
      container for the dumped data
      Throws:
      IOException - in case the dump can not be requested
    • dump

      public ExecFileLoader dump(InetAddress address, int port) throws IOException
      Requests a dump from the given end-point.
      Parameters:
      address - host name or IP-Address to connect to
      port - port to connect to
      Returns:
      container for the dumped data
      Throws:
      IOException - in case the dump can not be requested
    • tryConnect

      private Socket tryConnect(InetAddress address, int port) throws IOException
      Throws:
      IOException
    • sleep

      private void sleep() throws InterruptedIOException
      Throws:
      InterruptedIOException
    • onConnecting

      protected void onConnecting(InetAddress address, int port)
      This method can be overwritten to get an event just before a connection is made.
      Parameters:
      address - target address
      port - target port
    • onConnectionFailure

      protected void onConnectionFailure(IOException exception)
      This method can be overwritten to get an event for connection failures when another retry will be attempted.
      Parameters:
      exception - connection error