loadBalanceExceptionChecker - Свойство loadBalanceExceptionChecker является ключевым. Оно принимает полностью квалифицированное имя класса, реализующего новый интерфейс com.mysql.cj.jdbc.ha.LoadBalanceExceptionChecker. Этот интерфейс очень простой, и вам нужно только реализовать следующий метод:

public boolean shouldExceptionTriggerFailover(SQLException ex)

Передается SQLException, а возвращается значение типа boolean. Значение true запускает резервное копирование, false — нет.

Вы можете использовать это для реализации собственной логики. Пример, где это может быть полезно, — это при работе с временными ошибками при использовании MySQL Cluster, когда некоторые буферы могут перегружаться. Следующий фрагмент кода демонстрирует это:

public class NdbLoadBalanceExceptionChecker
 extends StandardLoadBalanceExceptionChecker {

 public boolean shouldExceptionTriggerFailover(SQLException ex) {
  return super.shouldExceptionTriggerFailover(ex)
    ||  checkNdbException(ex);
 }

 private boolean checkNdbException(SQLException ex){
 // Have to parse the message since most NDB errors
 // are mapped to the same DEMC.
  return (ex.getMessage().startsWith("Lock wait timeout exceeded") ||
  (ex.getMessage().startsWith("Got temporary error")
  && ex.getMessage().endsWith("from NDB")));
 }
}

Приведенный выше код расширяет com.mysql.cj.jdbc.ha.StandardLoadBalanceExceptionChecker, который является реализацией по умолчанию. Существуют несколько удобных сокращений, встроенных в эту реализацию, для тех, кто хочет иметь некоторый уровень контроля, используя свойства, без написания кода Java. Эта реализация по умолчанию использует два оставшихся свойства: loadBalanceSQLStateFailover и loadBalanceSQLExceptionSubclassFailover.

loadBalanceSQLStateFailover — позволяет определить список разделяемых запятыми префиксов кода SQLState, с которыми сравнивается SQLException. Если префикс совпадает, запускается резервное копирование. Например, следующее вызовет резервное копирование, если заданный SQLException начинается с "00" или равен "12345":

loadBalanceSQLStateFailover=00,12345

loadBalanceSQLExceptionSubclassFailover — может использоваться в сочетании с loadBalanceSQLStateFailover или самостоятельно. Если вы хотите, чтобы определенные подклассы SQLException запускали резервное копирование, просто укажите список разделяемых запятыми полных имен классов или интерфейсов для проверки. Например, если вы хотите, чтобы все SQLTransientConnectionExceptions запускали резервное копирование, вы укажете:

loadBalanceSQLExceptionSubclassFailover=java.sql.SQLTransientConnectionException

loadBalanceAutoCommitStatementThreshold — определяет количество совпадающих инструкций, которые могут привести к тому, что драйвер потенциально переключит физические соединения серверов. Значение по умолчанию 0 сохраняет поведение, при котором соединения с включенным autocommit никогда не сбалансированы.

loadBalanceAutoCommitStatementRegex — регулярное выражение, с которым должны соответствовать инструкции. Значение по умолчанию — пустая строка, соответствует всем инструкциям. Например, использование следующих свойств приведет к тому, что Connector/J будет перебалансироваться после каждой третьей инструкции, содержащей строку «“test”»:

loadBalanceAutoCommitStatementThreshold=3
loadBalanceAutoCommitStatementRegex=.*test.*

loadBalanceAutoCommitStatementRegex может оказаться полезным в ряде ситуаций. Ваше приложение может использовать временные таблицы, переменные состояния сеанса на стороне сервера или состояние подключения, где произвольное переключение драйвером физических подключений до завершения обработки может привести к потере данных или другим проблемам. Это позволяет вам определить триггерную инструкцию, которая выполняется только тогда, когда безопасно переключать физические соединения.