Package me.panjohnny.jip.client

Class Client

java.lang.Object

me.panjohnny.jip.client.Client

Direct Known Subclasses:

ClientImpl

public abstract sealed class Client
extends Object
permits ClientImpl

Klient slouží k připojení klienta k serveru. Pro získání instance využijte create(InetSocketAddress).

Since:

1.0

Author:

Jan Štefanča

See Also:

• connect()
• useSocketConfigurator(Consumer)
• ClientImpl

Field Summary

Fields

Modifier and Type	Field	Description
protected InetSocketAddress	address

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Client(InetSocketAddress address)	Chráněný konstruktor klienta

Method Summary

Modifier and Type	Method	Description
abstract void	close()	Ukončí spojení se serverem uzavřením soketu.
abstract void	connect()	Připojí klienta na předem definovanou adresu.
abstract void	connect(InetSocketAddress address)	Připojí či přepojí klienta na definovanou adresu.
static Client	create(InetSocketAddress address)	Vytvoří nového klienta.
ResponsePacket	fetch(String resource)	Zašle žádost na server s aktuální verzí knihovny a definovanou cestou a pokusí se získat odpověď.
abstract ResponsePacket	fetch(Request req)	Zašle žádost na server a pokusí se získat odpověď.
InetSocketAddress	getAddress()	Získá poslední využitou adresu serveru.
abstract boolean	isClosed()	Zjistí, zda-li je soket uzavřen.
abstract Client	useSocketConfigurator(Consumer<Socket> socketConsumer)	Nastaví consumer pro další konfiguraci soketu při připojování k serveru.

Methods inherited from class java.lang.Object

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

Field Details

address

protected InetSocketAddress address

Constructor Details

Client

protected Client(InetSocketAddress address)

Chráněný konstruktor klienta

Parameters:

address - adresa serveru

Method Details

connect

public abstract void connect()
                      throws Exception

Připojí klienta na předem definovanou adresu. Pro připojení na jinou adresu, či přepojení využijte connect(InetSocketAddress).

Throws:

SecureTransportException - pokud selže bezpečnostní vrstva

IOException - pokud dojde k I/O erroru

Exception

See Also:

• connect(InetSocketAddress)
• close()

connect

public abstract void connect(InetSocketAddress address)
                      throws Exception

Připojí či přepojí klienta na definovanou adresu. Pro připojení na dříve použitou adresu využijte connect().

Parameters:

address - adresa serveru

Throws:

SecureTransportException - pokud selže bezpečnostní vrstva

IOException - pokud dojde k I/O erroru

Exception

fetch

public abstract ResponsePacket fetch(Request req)
                              throws Exception

Zašle žádost na server a pokusí se získat odpověď.

Parameters:

req - žádost

Returns:

odpověď ze serveru

Throws:

SecureTransportException - pokud selže bezpečnostní vrstva

IOException - pokud dojde k I/O erroru

Exception

See Also:

• Request
• ResponsePacket

fetch

public ResponsePacket fetch(String resource)
                     throws Exception

Zašle žádost na server s aktuální verzí knihovny a definovanou cestou a pokusí se získat odpověď.

Parameters:

resource - cesta

Returns:

odpověď ze serveru

Throws:

SecureTransportException - pokud selže bezpečnostní vrstva

IOException - pokud dojde k I/O erroru

Exception

See Also:

• Request
• ResponsePacket

close

public abstract void close()
                    throws IOException

Ukončí spojení se serverem uzavřením soketu. (Klient je tedy odpojen.)

Throws:

IOException - pokud dojde k I/O erroru

isClosed

public abstract boolean isClosed()

Zjistí, zda-li je soket uzavřen.

Returns:

true pokud je soket uzavřen, jinak false

See Also:

• close()

getAddress

public InetSocketAddress getAddress()

Získá poslední využitou adresu serveru. Pokud nebylo využito metody connect(InetSocketAddress), je touto adresou adresa, která byla využita na tvorbu instance.

Returns:

poslední využitá adresa serveru

create

public static Client create(InetSocketAddress address)

Vytvoří nového klienta.

Parameters:

address - adresa serveru

Returns:

nová instance klienta

useSocketConfigurator

public abstract Client useSocketConfigurator(Consumer<Socket> socketConsumer)

Nastaví consumer pro další konfiguraci soketu při připojování k serveru.

Ukázka využití:

 var client = Client.create(addr).useSocketConfigurator((s) -> {
 s.setSoTimeout(20000); // maximální doba blokování read
 })

Parameters:

socketConsumer - consumer pro konfiguraci připojení

Returns:

aktuální instance klienta