> For the complete documentation index, see [llms.txt](https://mysql-api.gitbook.io/jhonatas48_mysqlapi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mysql-api.gitbook.io/jhonatas48_mysqlapi/readme/classes/connectionmanager.md).

# ConnectionManager

O ConnectionManager é a classe responsável por realizar a conexão com o banco de dados, e em caso de queda de uma conexão, o sistema de FailBack irá colocar a próxima conexão disponível

Para melhor entendimento segue uma ilustração:

<figure><img src="https://1746339053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc9NnVPQ5t3kPgGILXPbS%2Fuploads%2FKyOwKojmjbhALZaAFD7B%2FUntitled.png?alt=media&amp;token=851bc308-5f58-4404-b437-3df81f61a437" alt=""><figcaption></figcaption></figure>

Como pode ver acima o Connection Manager é capaz de gerenciar diversas conexões e caso a conexão principal caia ele já aciona outra automáticamente o que é chamado de FailBack

### Construtor

**public ConnectionManager(String name)**

O campo nome é obrigatório porque caso o construir lide com múltiplos servidor a API será capaz de atender

OBS: É fortemente recomendável também ter um **nome único** para cada Connection Manager

<details>

<summary><mark style="color:red;"><strong>Erros:</strong></mark></summary>

* <mark style="color:red;">NullPointerException</mark> : Ocorre quando o nome é vazio ou nulo

</details>

### Métodos Da Classe

#### public void addConnection([IConnection](/jhonatas48_mysqlapi/readme/classes/iconnection.md)\<?> connection)

Método responsável por registrar o conector do banco de dados a ser usado.

<details>

<summary><mark style="color:red;"><strong>Erros</strong></mark></summary>

* <mark style="color:red;">DuplicateConnectionNameException</mark> : Ocorre quando o nome da conexão já existe
* <mark style="color:red;">Exception</mark> : Ocorre quando qualquer erro que aconteça ao tentar ao registrar a conexão

</details>

#### public Connection getConnection()

Método responsável de abrir e obter a conexão

<details>

<summary><mark style="color:red;"><strong>Erros</strong></mark></summary>

* <mark style="color:red;">NullPointerException</mark> : Ocorre quando não há nenhuma conexão registrada
* <mark style="color:red;">ConnectionNotEstablishedException</mark> : Ocorre quando não foi possível estabilizar a conexão com o banco de dados por qualquer motivo que seja
* <mark style="color:red;">SQLException</mark>: Ocorre quando há alguma inconsistência no código SQL
* <mark style="color:red;">ClassNotFoundException</mark>: Ocorre quando a classe do driver do banco de dados não for encontrada

</details>

#### public [IConnection](/jhonatas48_mysqlapi/readme/classes/iconnection.md)\<?> getConnectionByName(String name)

Retorna um conector de banco de dados conforme o nome da conexão

<details>

<summary><mark style="color:red;"><strong>Erros</strong></mark></summary>

* [<mark style="color:red;">NullPointerException</mark>](#user-content-fn-1)[^1] : Ocorre quando não há nenhuma conexão registrada ou quando o nome está vazio
* <mark style="color:red;">Exception</mark>: Ocorre quando é disparado algum erro na função que busca a conexão

</details>

#### public void closeConnection()

Realiza o fechamento da conexão que foi aberta para interagir com o banco de dados

<details>

<summary><mark style="color:red;"><strong>Erros</strong></mark></summary>

* <mark style="color:red;">SQLException</mark> : Ocorre quando  houver algum problema durante o fechamento da conexão com o banco de dados

</details>

#### public void removeConnection(String connectionName)

Remove um IConnection baseado no nome da conexão

<details>

<summary><mark style="color:red;"><strong>Erros</strong></mark></summary>

[<mark style="color:red;">NullPointerException</mark>](#user-content-fn-1)[^1] : Ocorre quando não for passado o nome da conexão

</details>

#### public [ConnectionType](/jhonatas48_mysqlapi/readme/enums/connectiontype.md) getConnectionType()

Retorna o [ConnectionType](/jhonatas48_mysqlapi/readme/enums/connectiontype.md) correspondente da conexão. Ou seja, retorna o tipo da conexão

#### public Connection getLogConnecton()

Retorna a conexão do banco de dados de log

<details>

<summary><mark style="color:red;"><strong>Erros</strong></mark></summary>

* <mark style="color:red;">ConnectionNotEstablishedException</mark>: Ocorre quando não foi possível fazer a conexão com o banco de dados de Logs
* <mark style="color:red;">SQLException</mark>: Ocorre quando há alguma inconsistência no código SQL
* <mark style="color:red;">ClassNotFoundException</mark>: Ocorre quando a classe do driver do banco de dados não for encontrada

</details>

#### public String getName()

Retorna o nome do ConnectionManager

[^1]: