com.alipay.remoting

接口 ConnectionManager

所有超级接口:

Scannable

所有已知实现类:

DefaultConnectionManager

public interface ConnectionManager
extends Scannable

Connection manager of connection pool

方法概要

限定符和类型	方法和说明
void	add(Connection connection) Add a connection to ConnectionPool.
void	add(Connection connection, String poolKey) Add a connection to ConnectionPool with the specified poolKey.
void	check(Connection connection) check a connection whether available, if not, throw RemotingException
int	count(String poolKey) Get the number of Connection in ConnectionPool with the specified pool key
Connection	create(String address, int connectTimeout) Create a connection using specified String address.
Connection	create(String ip, int port, int connectTimeout) Create a connection using specified ip and port.
Connection	create(Url url) Create a connection using specified Url.
void	createConnectionAndHealIfNeed(Url url) This method can create connection pool with connections initialized and check the number of connections.
Connection	get(String poolKey) Get a connection from ConnectionPool with the specified poolKey.
Map<String,List<Connection>>	getAll() Get all connections of all poolKey.
List<Connection>	getAll(String poolKey) Get all connections from ConnectionPool with the specified poolKey.
Connection	getAndCreateIfAbsent(Url url) Get a connection using Url, if null then create and add into ConnectionPool.
void	init() init
void	remove(Connection connection) Remove a Connection from all ConnectionPool with the poolKeys in Connection, and close it.
void	remove(Connection connection, String poolKey) Remove and close a Connection from ConnectionPool with the specified poolKey.
void	remove(String poolKey) Remove and close all connections from ConnectionPool with the specified poolKey.
void	removeAll() Remove and close all connections from all ConnectionPool.

从接口继承的方法 com.alipay.remoting.Scannable

scan

方法详细资料

init

void init()

init

add

void add(Connection connection)

Add a connection to ConnectionPool. If it contains multiple pool keys, this connection will be added to multiple ConnectionPool too.

参数:

connection - an available connection, you should check(Connection) this connection before add

add

void add(Connection connection,
         String poolKey)

Add a connection to ConnectionPool with the specified poolKey.

参数:

connection - an available connection, you should check(Connection) this connection before add

poolKey - unique key of a ConnectionPool

get

Connection get(String poolKey)

Get a connection from ConnectionPool with the specified poolKey.

参数:

poolKey - unique key of a ConnectionPool

返回:

a Connection selected by ConnectionSelectStrategy
or return null if there is no ConnectionPool mapping with poolKey
or return null if there is no Connection in ConnectionPool.

getAll

List<Connection> getAll(String poolKey)

Get all connections from ConnectionPool with the specified poolKey.

参数:

poolKey - unique key of a ConnectionPool

返回:

a list of Connection
or return an empty list if there is no ConnectionPool mapping with poolKey.

getAll

Map<String,List<Connection>> getAll()

Get all connections of all poolKey.

返回:

a map with poolKey as key and a list of connections in ConnectionPool as value

remove

void remove(Connection connection)

Remove a Connection from all ConnectionPool with the poolKeys in Connection, and close it.

remove

void remove(Connection connection,
            String poolKey)

Remove and close a Connection from ConnectionPool with the specified poolKey.

参数:

connection - target connection

poolKey - unique key of a ConnectionPool

remove

void remove(String poolKey)

Remove and close all connections from ConnectionPool with the specified poolKey.

参数:

poolKey - unique key of a ConnectionPool

removeAll

void removeAll()

Remove and close all connections from all ConnectionPool.

check

void check(Connection connection)
    throws RemotingException

check a connection whether available, if not, throw RemotingException

参数:

connection - target connection

抛出:

RemotingException

count

int count(String poolKey)

Get the number of Connection in ConnectionPool with the specified pool key

参数:

poolKey - unique key of a ConnectionPool

返回:

connection count

getAndCreateIfAbsent

Connection getAndCreateIfAbsent(Url url)
                         throws InterruptedException,
                                RemotingException

Get a connection using Url, if null then create and add into ConnectionPool. The connection number of ConnectionPool is decided by Url.getConnNum()

参数:

url - Url contains connect infos.

返回:

the created Connection.

抛出:

InterruptedException - if interrupted

RemotingException - if create failed.

createConnectionAndHealIfNeed

void createConnectionAndHealIfNeed(Url url)
                            throws InterruptedException,
                                   RemotingException

This method can create connection pool with connections initialized and check the number of connections. The connection number of ConnectionPool is decided by Url.getConnNum(). Each time call this method, will check the number of connection, if not enough, this will do the healing logic additionally.

抛出:

InterruptedException

RemotingException

create

Connection create(Url url)
           throws RemotingException

Create a connection using specified Url.

参数:

url - Url contains connect infos.

抛出:

RemotingException

create

Connection create(String address,
                  int connectTimeout)
           throws RemotingException

Create a connection using specified String address.

参数:

address - a String address, e.g. 127.0.0.1:1111

connectTimeout - an int connect timeout value

返回:

the created Connection

抛出:

RemotingException - if create failed

create

Connection create(String ip,
                  int port,
                  int connectTimeout)
           throws RemotingException

Create a connection using specified ip and port.

参数:

ip - connect ip, e.g. 127.0.0.1

port - connect port, e.g. 1111

connectTimeout - an int connect timeout value

返回:

the created Connection

抛出:

RemotingException