mirror of
https://github.com/fafhrd91/actix-net
synced 2025-02-24 23:33:21 +01:00
refactor Connector service
This commit is contained in:
parent
099ebbfaa3
commit
0b0d14d1ea
@ -1,6 +1,6 @@
|
|||||||
[package]
|
[package]
|
||||||
name = "actix-net"
|
name = "actix-net"
|
||||||
version = "0.1.1"
|
version = "0.2.0"
|
||||||
authors = ["Nikolay Kim <fafhrd91@gmail.com>"]
|
authors = ["Nikolay Kim <fafhrd91@gmail.com>"]
|
||||||
description = "Actix net - framework for the compisible network services for Rust (experimental)"
|
description = "Actix net - framework for the compisible network services for Rust (experimental)"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
|
171
src/connector.rs
171
src/connector.rs
@ -1,6 +1,7 @@
|
|||||||
use std::collections::VecDeque;
|
use std::collections::VecDeque;
|
||||||
use std::io;
|
use std::io;
|
||||||
use std::net::SocketAddr;
|
use std::net::SocketAddr;
|
||||||
|
use std::time::Duration;
|
||||||
|
|
||||||
use futures::{
|
use futures::{
|
||||||
future::{ok, FutureResult},
|
future::{ok, FutureResult},
|
||||||
@ -24,6 +25,10 @@ pub enum ConnectorError {
|
|||||||
// #[fail(display = "Invalid input: {}", _0)]
|
// #[fail(display = "Invalid input: {}", _0)]
|
||||||
NoRecords,
|
NoRecords,
|
||||||
|
|
||||||
|
/// Connecting took too long
|
||||||
|
// #[fail(display = "Timeout out while establishing connection")]
|
||||||
|
Timeout,
|
||||||
|
|
||||||
/// Connection io error
|
/// Connection io error
|
||||||
// #[fail(display = "{}", _0)]
|
// #[fail(display = "{}", _0)]
|
||||||
IoError(io::Error),
|
IoError(io::Error),
|
||||||
@ -35,16 +40,50 @@ impl From<ResolverError> for ConnectorError {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
pub struct ConnectionInfo {
|
#[derive(Eq, PartialEq, Debug)]
|
||||||
|
pub struct Connect {
|
||||||
pub host: String,
|
pub host: String,
|
||||||
pub addr: SocketAddr,
|
pub port: Option<u16>,
|
||||||
|
pub timeout: Duration,
|
||||||
}
|
}
|
||||||
|
|
||||||
pub struct Connector<T = String> {
|
impl Connect {
|
||||||
resolver: Resolver<T>,
|
pub fn host<T: AsRef<str>>(host: T) -> Connect {
|
||||||
|
Connect {
|
||||||
|
host: host.as_ref().to_owned(),
|
||||||
|
port: None,
|
||||||
|
timeout: Duration::from_secs(1),
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T: HostAware> Default for Connector<T> {
|
pub fn host_and_port<T: AsRef<str>>(host: T, port: u16) -> Connect {
|
||||||
|
Connect {
|
||||||
|
host: host.as_ref().to_owned(),
|
||||||
|
port: Some(port),
|
||||||
|
timeout: Duration::from_secs(1),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set connect timeout
|
||||||
|
///
|
||||||
|
/// By default timeout is set to a 1 second.
|
||||||
|
pub fn timeout(mut self, timeout: Duration) -> Connect {
|
||||||
|
self.timeout = timeout;
|
||||||
|
self
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
impl HostAware for Connect {
|
||||||
|
fn host(&self) -> &str {
|
||||||
|
&self.host
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
pub struct Connector {
|
||||||
|
resolver: Resolver<Connect>,
|
||||||
|
}
|
||||||
|
|
||||||
|
impl Default for Connector {
|
||||||
fn default() -> Self {
|
fn default() -> Self {
|
||||||
let (cfg, opts) = if let Ok((cfg, opts)) = read_system_conf() {
|
let (cfg, opts) = if let Ok((cfg, opts)) = read_system_conf() {
|
||||||
(cfg, opts)
|
(cfg, opts)
|
||||||
@ -56,7 +95,7 @@ impl<T: HostAware> Default for Connector<T> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T: HostAware> Connector<T> {
|
impl Connector {
|
||||||
pub fn new(cfg: ResolverConfig, opts: ResolverOpts) -> Self {
|
pub fn new(cfg: ResolverConfig, opts: ResolverOpts) -> Self {
|
||||||
Connector {
|
Connector {
|
||||||
resolver: Resolver::new(cfg, opts),
|
resolver: Resolver::new(cfg, opts),
|
||||||
@ -64,43 +103,34 @@ impl<T: HostAware> Connector<T> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
pub fn with_resolver(
|
pub fn with_resolver(
|
||||||
resolver: Resolver<T>,
|
resolver: Resolver<Connect>,
|
||||||
) -> impl Service<
|
) -> impl Service<Request = Connect, Response = (Connect, TcpStream), Error = ConnectorError>
|
||||||
Request = T,
|
+ Clone {
|
||||||
Response = (T, ConnectionInfo, TcpStream),
|
|
||||||
Error = ConnectorError,
|
|
||||||
> + Clone {
|
|
||||||
Connector { resolver }
|
Connector { resolver }
|
||||||
}
|
}
|
||||||
|
|
||||||
pub fn new_service<E>() -> impl NewService<
|
pub fn new_service<E>() -> impl NewService<
|
||||||
Request = T,
|
Request = Connect,
|
||||||
Response = (T, ConnectionInfo, TcpStream),
|
Response = (Connect, TcpStream),
|
||||||
Error = ConnectorError,
|
Error = ConnectorError,
|
||||||
InitError = E,
|
InitError = E,
|
||||||
> + Clone {
|
> + Clone {
|
||||||
|| -> FutureResult<Connector<T>, E> { ok(Connector::default()) }
|
|| -> FutureResult<Connector, E> { ok(Connector::default()) }
|
||||||
}
|
}
|
||||||
|
|
||||||
pub fn new_service_with_config<E>(
|
pub fn new_service_with_config<E>(
|
||||||
cfg: ResolverConfig, opts: ResolverOpts,
|
cfg: ResolverConfig, opts: ResolverOpts,
|
||||||
) -> impl NewService<
|
) -> impl NewService<
|
||||||
Request = T,
|
Request = Connect,
|
||||||
Response = (T, ConnectionInfo, TcpStream),
|
Response = (Connect, TcpStream),
|
||||||
Error = ConnectorError,
|
Error = ConnectorError,
|
||||||
InitError = E,
|
InitError = E,
|
||||||
> + Clone {
|
> + Clone {
|
||||||
move || -> FutureResult<Connector<T>, E> { ok(Connector::new(cfg.clone(), opts)) }
|
move || -> FutureResult<Connector, E> { ok(Connector::new(cfg.clone(), opts)) }
|
||||||
}
|
|
||||||
|
|
||||||
pub fn change_request<T2: HostAware>(&self) -> Connector<T2> {
|
|
||||||
Connector {
|
|
||||||
resolver: self.resolver.change_request(),
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T> Clone for Connector<T> {
|
impl Clone for Connector {
|
||||||
fn clone(&self) -> Self {
|
fn clone(&self) -> Self {
|
||||||
Connector {
|
Connector {
|
||||||
resolver: self.resolver.clone(),
|
resolver: self.resolver.clone(),
|
||||||
@ -108,11 +138,11 @@ impl<T> Clone for Connector<T> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T: HostAware> Service for Connector<T> {
|
impl Service for Connector {
|
||||||
type Request = T;
|
type Request = Connect;
|
||||||
type Response = (T, ConnectionInfo, TcpStream);
|
type Response = (Connect, TcpStream);
|
||||||
type Error = ConnectorError;
|
type Error = ConnectorError;
|
||||||
type Future = ConnectorFuture<T>;
|
type Future = ConnectorFuture;
|
||||||
|
|
||||||
fn poll_ready(&mut self) -> Poll<(), Self::Error> {
|
fn poll_ready(&mut self) -> Poll<(), Self::Error> {
|
||||||
Ok(Async::Ready(()))
|
Ok(Async::Ready(()))
|
||||||
@ -127,13 +157,13 @@ impl<T: HostAware> Service for Connector<T> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
#[doc(hidden)]
|
#[doc(hidden)]
|
||||||
pub struct ConnectorFuture<T: HostAware> {
|
pub struct ConnectorFuture {
|
||||||
fut: ResolverFuture<T>,
|
fut: ResolverFuture<Connect>,
|
||||||
fut2: Option<TcpConnector<T>>,
|
fut2: Option<TcpConnector>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T: HostAware> Future for ConnectorFuture<T> {
|
impl Future for ConnectorFuture {
|
||||||
type Item = (T, ConnectionInfo, TcpStream);
|
type Item = (Connect, TcpStream);
|
||||||
type Error = ConnectorError;
|
type Error = ConnectorError;
|
||||||
|
|
||||||
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
||||||
@ -141,11 +171,11 @@ impl<T: HostAware> Future for ConnectorFuture<T> {
|
|||||||
return fut.poll();
|
return fut.poll();
|
||||||
}
|
}
|
||||||
match self.fut.poll().map_err(ConnectorError::from)? {
|
match self.fut.poll().map_err(ConnectorError::from)? {
|
||||||
Async::Ready((req, host, addrs)) => {
|
Async::Ready((req, _, addrs)) => {
|
||||||
if addrs.is_empty() {
|
if addrs.is_empty() {
|
||||||
Err(ConnectorError::NoRecords)
|
Err(ConnectorError::NoRecords)
|
||||||
} else {
|
} else {
|
||||||
self.fut2 = Some(TcpConnector::new(req, host, addrs));
|
self.fut2 = Some(TcpConnector::new(req, addrs));
|
||||||
self.poll()
|
self.poll()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -154,76 +184,28 @@ impl<T: HostAware> Future for ConnectorFuture<T> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
#[derive(Clone)]
|
|
||||||
pub struct DefaultConnector<T: HostAware>(Connector<T>);
|
|
||||||
|
|
||||||
impl<T: HostAware> Default for DefaultConnector<T> {
|
|
||||||
fn default() -> Self {
|
|
||||||
DefaultConnector(Connector::default())
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T: HostAware> DefaultConnector<T> {
|
|
||||||
pub fn new(cfg: ResolverConfig, opts: ResolverOpts) -> Self {
|
|
||||||
DefaultConnector(Connector::new(cfg, opts))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T: HostAware> Service for DefaultConnector<T> {
|
|
||||||
type Request = T;
|
|
||||||
type Response = TcpStream;
|
|
||||||
type Error = ConnectorError;
|
|
||||||
type Future = DefaultConnectorFuture<T>;
|
|
||||||
|
|
||||||
fn poll_ready(&mut self) -> Poll<(), Self::Error> {
|
|
||||||
self.0.poll_ready()
|
|
||||||
}
|
|
||||||
|
|
||||||
fn call(&mut self, req: Self::Request) -> Self::Future {
|
|
||||||
DefaultConnectorFuture {
|
|
||||||
fut: self.0.call(req),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[doc(hidden)]
|
|
||||||
pub struct DefaultConnectorFuture<T: HostAware> {
|
|
||||||
fut: ConnectorFuture<T>,
|
|
||||||
}
|
|
||||||
|
|
||||||
impl<T: HostAware> Future for DefaultConnectorFuture<T> {
|
|
||||||
type Item = TcpStream;
|
|
||||||
type Error = ConnectorError;
|
|
||||||
|
|
||||||
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
|
||||||
Ok(Async::Ready(try_ready!(self.fut.poll()).2))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
#[doc(hidden)]
|
#[doc(hidden)]
|
||||||
/// Tcp stream connector
|
/// Tcp stream connector
|
||||||
pub struct TcpConnector<T> {
|
pub struct TcpConnector {
|
||||||
req: Option<T>,
|
req: Option<Connect>,
|
||||||
host: Option<String>,
|
|
||||||
addr: Option<SocketAddr>,
|
addr: Option<SocketAddr>,
|
||||||
addrs: VecDeque<SocketAddr>,
|
addrs: VecDeque<SocketAddr>,
|
||||||
stream: Option<ConnectFuture>,
|
stream: Option<ConnectFuture>,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T> TcpConnector<T> {
|
impl TcpConnector {
|
||||||
pub fn new(req: T, host: String, addrs: VecDeque<SocketAddr>) -> TcpConnector<T> {
|
pub fn new(req: Connect, addrs: VecDeque<SocketAddr>) -> TcpConnector {
|
||||||
TcpConnector {
|
TcpConnector {
|
||||||
addrs,
|
addrs,
|
||||||
req: Some(req),
|
req: Some(req),
|
||||||
host: Some(host),
|
|
||||||
addr: None,
|
addr: None,
|
||||||
stream: None,
|
stream: None,
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T> Future for TcpConnector<T> {
|
impl Future for TcpConnector {
|
||||||
type Item = (T, ConnectionInfo, TcpStream);
|
type Item = (Connect, TcpStream);
|
||||||
type Error = ConnectorError;
|
type Error = ConnectorError;
|
||||||
|
|
||||||
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
||||||
@ -232,14 +214,7 @@ impl<T> Future for TcpConnector<T> {
|
|||||||
if let Some(new) = self.stream.as_mut() {
|
if let Some(new) = self.stream.as_mut() {
|
||||||
match new.poll() {
|
match new.poll() {
|
||||||
Ok(Async::Ready(sock)) => {
|
Ok(Async::Ready(sock)) => {
|
||||||
return Ok(Async::Ready((
|
return Ok(Async::Ready((self.req.take().unwrap(), sock)))
|
||||||
self.req.take().unwrap(),
|
|
||||||
ConnectionInfo {
|
|
||||||
host: self.host.take().unwrap(),
|
|
||||||
addr: self.addr.take().unwrap(),
|
|
||||||
},
|
|
||||||
sock,
|
|
||||||
)))
|
|
||||||
}
|
}
|
||||||
Ok(Async::NotReady) => return Ok(Async::NotReady),
|
Ok(Async::NotReady) => return Ok(Async::NotReady),
|
||||||
Err(err) => {
|
Err(err) => {
|
||||||
|
@ -6,7 +6,7 @@ use tokio_io::{AsyncRead, AsyncWrite};
|
|||||||
use tokio_openssl::{AcceptAsync, ConnectAsync, SslAcceptorExt, SslConnectorExt, SslStream};
|
use tokio_openssl::{AcceptAsync, ConnectAsync, SslAcceptorExt, SslConnectorExt, SslStream};
|
||||||
|
|
||||||
use super::MAX_CONN_COUNTER;
|
use super::MAX_CONN_COUNTER;
|
||||||
use connector::ConnectionInfo;
|
use connector::Connect;
|
||||||
use counter::{Counter, CounterGuard};
|
use counter::{Counter, CounterGuard};
|
||||||
use service::{NewService, Service};
|
use service::{NewService, Service};
|
||||||
|
|
||||||
@ -102,113 +102,95 @@ impl<T: AsyncRead + AsyncWrite> Future for OpensslAcceptorServiceFut<T> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/// Openssl connector factory
|
/// Openssl connector factory
|
||||||
pub struct OpensslConnector<T, Io, E> {
|
pub struct OpensslConnector<T, E> {
|
||||||
connector: SslConnector,
|
connector: SslConnector,
|
||||||
t: PhantomData<T>,
|
_t: PhantomData<(T, E)>,
|
||||||
io: PhantomData<Io>,
|
|
||||||
_e: PhantomData<E>,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T, Io, E> OpensslConnector<T, Io, E> {
|
impl<T, E> OpensslConnector<T, E> {
|
||||||
pub fn new(connector: SslConnector) -> Self {
|
pub fn new(connector: SslConnector) -> Self {
|
||||||
OpensslConnector {
|
OpensslConnector {
|
||||||
connector,
|
connector,
|
||||||
t: PhantomData,
|
_t: PhantomData,
|
||||||
io: PhantomData,
|
|
||||||
_e: PhantomData,
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T, Io: AsyncRead + AsyncWrite> OpensslConnector<T, Io, ()> {
|
impl<T: AsyncRead + AsyncWrite> OpensslConnector<T, ()> {
|
||||||
pub fn service(
|
pub fn service(
|
||||||
connector: SslConnector,
|
connector: SslConnector,
|
||||||
) -> impl Service<
|
) -> impl Service<Request = (Connect, T), Response = (Connect, SslStream<T>), Error = Error>
|
||||||
Request = (T, ConnectionInfo, Io),
|
{
|
||||||
Response = (T, ConnectionInfo, SslStream<Io>),
|
|
||||||
Error = Error,
|
|
||||||
> {
|
|
||||||
OpensslConnectorService {
|
OpensslConnectorService {
|
||||||
connector: connector,
|
connector: connector,
|
||||||
t: PhantomData,
|
_t: PhantomData,
|
||||||
io: PhantomData,
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T, Io, E> Clone for OpensslConnector<T, Io, E> {
|
impl<T, E> Clone for OpensslConnector<T, E> {
|
||||||
fn clone(&self) -> Self {
|
fn clone(&self) -> Self {
|
||||||
Self {
|
Self {
|
||||||
connector: self.connector.clone(),
|
connector: self.connector.clone(),
|
||||||
t: PhantomData,
|
_t: PhantomData,
|
||||||
io: PhantomData,
|
|
||||||
_e: PhantomData,
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T, Io: AsyncRead + AsyncWrite, E> NewService for OpensslConnector<T, Io, E> {
|
impl<T: AsyncRead + AsyncWrite, E> NewService for OpensslConnector<T, E> {
|
||||||
type Request = (T, ConnectionInfo, Io);
|
type Request = (Connect, T);
|
||||||
type Response = (T, ConnectionInfo, SslStream<Io>);
|
type Response = (Connect, SslStream<T>);
|
||||||
type Error = Error;
|
type Error = Error;
|
||||||
type Service = OpensslConnectorService<T, Io>;
|
type Service = OpensslConnectorService<T>;
|
||||||
type InitError = E;
|
type InitError = E;
|
||||||
type Future = FutureResult<Self::Service, Self::InitError>;
|
type Future = FutureResult<Self::Service, Self::InitError>;
|
||||||
|
|
||||||
fn new_service(&self) -> Self::Future {
|
fn new_service(&self) -> Self::Future {
|
||||||
ok(OpensslConnectorService {
|
ok(OpensslConnectorService {
|
||||||
connector: self.connector.clone(),
|
connector: self.connector.clone(),
|
||||||
t: PhantomData,
|
_t: PhantomData,
|
||||||
io: PhantomData,
|
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
pub struct OpensslConnectorService<T, Io> {
|
pub struct OpensslConnectorService<T> {
|
||||||
connector: SslConnector,
|
connector: SslConnector,
|
||||||
t: PhantomData<T>,
|
_t: PhantomData<T>,
|
||||||
io: PhantomData<Io>,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T, Io: AsyncRead + AsyncWrite> Service for OpensslConnectorService<T, Io> {
|
impl<T: AsyncRead + AsyncWrite> Service for OpensslConnectorService<T> {
|
||||||
type Request = (T, ConnectionInfo, Io);
|
type Request = (Connect, T);
|
||||||
type Response = (T, ConnectionInfo, SslStream<Io>);
|
type Response = (Connect, SslStream<T>);
|
||||||
type Error = Error;
|
type Error = Error;
|
||||||
type Future = ConnectAsyncExt<T, Io>;
|
type Future = ConnectAsyncExt<T>;
|
||||||
|
|
||||||
fn poll_ready(&mut self) -> Poll<(), Self::Error> {
|
fn poll_ready(&mut self) -> Poll<(), Self::Error> {
|
||||||
Ok(Async::Ready(()))
|
Ok(Async::Ready(()))
|
||||||
}
|
}
|
||||||
|
|
||||||
fn call(&mut self, (req, info, stream): Self::Request) -> Self::Future {
|
fn call(&mut self, (req, stream): Self::Request) -> Self::Future {
|
||||||
ConnectAsyncExt {
|
ConnectAsyncExt {
|
||||||
fut: SslConnectorExt::connect_async(&self.connector, &info.host, stream),
|
fut: SslConnectorExt::connect_async(&self.connector, &req.host, stream),
|
||||||
req: Some(req),
|
req: Some(req),
|
||||||
host: Some(info),
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
pub struct ConnectAsyncExt<T, Io> {
|
pub struct ConnectAsyncExt<T> {
|
||||||
fut: ConnectAsync<Io>,
|
fut: ConnectAsync<T>,
|
||||||
req: Option<T>,
|
req: Option<Connect>,
|
||||||
host: Option<ConnectionInfo>,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<T, Io> Future for ConnectAsyncExt<T, Io>
|
impl<T> Future for ConnectAsyncExt<T>
|
||||||
where
|
where
|
||||||
Io: AsyncRead + AsyncWrite,
|
T: AsyncRead + AsyncWrite,
|
||||||
{
|
{
|
||||||
type Item = (T, ConnectionInfo, SslStream<Io>);
|
type Item = (Connect, SslStream<T>);
|
||||||
type Error = Error;
|
type Error = Error;
|
||||||
|
|
||||||
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
fn poll(&mut self) -> Poll<Self::Item, Self::Error> {
|
||||||
match self.fut.poll()? {
|
match self.fut.poll()? {
|
||||||
Async::Ready(stream) => Ok(Async::Ready((
|
Async::Ready(stream) => Ok(Async::Ready((self.req.take().unwrap(), stream))),
|
||||||
self.req.take().unwrap(),
|
|
||||||
self.host.take().unwrap(),
|
|
||||||
stream,
|
|
||||||
))),
|
|
||||||
Async::NotReady => Ok(Async::NotReady),
|
Async::NotReady => Ok(Async::NotReady),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user