Class HostAddress

java.lang.Object
org.mariadb.jdbc.HostAddress
public class HostAddress extends Object
Host entry

  • Field Details

    • host

      public final String host
      host address

    • port

      public final int port
      port

    • pipe

      public final String pipe

    • sslMode

      public final SslMode sslMode

    • localSocket

      public final String localSocket

    • primary

      public Boolean primary
      primary node

    • threadsConnected

      private Long threadsConnected

    • threadConnectedTimeout

      private Long threadConnectedTimeout

    • MYSQL_PROC_STATUS

      private static final ConcurrentMap<String, HostAddress.MysqlProcStatus> MYSQL_PROC_STATUS
      Process-wide latch shared across all HostAddress instances that point to the same physical endpoint (same host:port, named pipe, or unix socket). Keyed by content rather than object identity because NonRegisteringDriver.connect(Configuration) parses the URL afresh on every call, producing new HostAddress objects — without a shared map, each pooled connection would re-probe mysql.proc.

  • Constructor Details

    • HostAddress

      private HostAddress(String host, int port, Boolean primary, String pipe, String localSocket, SslMode sslMode)
      Constructor.
      Parameters:
      host - host
      port - port
      primary - is primary

  • Method Details

    • getMysqlProcStatus

      public HostAddress.MysqlProcStatus getMysqlProcStatus()

    • setMysqlProcStatus

      public void setMysqlProcStatus(HostAddress.MysqlProcStatus s)

    • from

      public static HostAddress from(String host, int port)
      Create a Host without knowledge of primary/replica goal
      Parameters:
      host - host (DNS/IP)
      port - port
      Returns:
      host

    • pipe

      public static HostAddress pipe(String pipe)
      Constructor for windows pipe host
      Parameters:
      pipe - windows pipe path
      Returns:
      hostAddress

    • localSocket

      public static HostAddress localSocket(String localSocket)
      Constructor for unix socket host
      Parameters:
      localSocket - unix socket path
      Returns:
      hostAddress

    • from

      public static HostAddress from(String host, int port, boolean primary)
      Create a Host
      Parameters:
      host - host (DNS/IP)
      port - port
      primary - is primary
      Returns:
      host

    • from

      public static HostAddress from(String host, int port, String sslMode)
      Create a Host
      Parameters:
      host - host (DNS/IP)
      port - port
      sslMode - ssl mode
      Returns:
      host

    • from

      public static HostAddress from(String host, int port, boolean primary, String sslMode)
      Create a Host
      Parameters:
      host - host (DNS/IP)
      port - port
      primary - is primary
      sslMode - ssl mode
      Returns:
      host

    • parse

      public static List<HostAddress> parse(String spec, HaMode haMode) throws SQLException
      parse - parse server addresses from the URL fragment.
      Parameters:
      spec - list of endpoints in one of the forms 1 - host1,....,hostN:port (missing port default to MariaDB default 3306 2 - host:port,...,host:port
      haMode - High availability mode
      Returns:
      parsed endpoints
      Throws:
      SQLException - for wrong spec

    • parseSimpleHostAddress

      private static HostAddress parseSimpleHostAddress(String str, HaMode haMode, boolean first) throws SQLException
      Parse Single host
      Parameters:
      str - string to parse
      haMode - current High-Availability mode
      first - is it the first host
      Returns:
      HostAddress
      Throws:
      SQLException - if port is not Integer

    • getPort

      private static int getPort(String portString) throws SQLException
      Parsing host port
      Parameters:
      portString - port in string value
      Returns:
      int value of port
      Throws:
      SQLException - in case of failing to parse port.

    • parseParameterHostAddress

      private static HostAddress parseParameterHostAddress(String str, HaMode haMode, boolean first) throws SQLException
      Throws:
      SQLException

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • getThreadsConnected

      public Long getThreadsConnected()

    • setThreadsConnected

      public void setThreadsConnected(long threadsConnected)

    • forceThreadsConnected

      public void forceThreadsConnected(long threadsConnected, long threadConnectedTimeout)

    • withPipe

      public HostAddress withPipe(String pipe)

    • withLocalSocket

      public HostAddress withLocalSocket(String localSocket)

    • withPort

      public HostAddress withPort(int port)

    • getThreadConnectedTimeout

      public Long getThreadConnectedTimeout()