Deprecated API

Contents

• Interfaces
• Classes
• Enum Classes
• Fields
• Methods
• Constructors
• Annotation Interface Elements

Deprecated Interfaces

Interface	Description
com.linecorp.armeria.client.encoding.StreamDecoder	Use StreamDecoder instead.
com.linecorp.armeria.client.encoding.StreamDecoderFactory	Use StreamDecoderFactory instead.

Deprecated Classes

Class	Description
com.linecorp.armeria.common.grpc.GrpcWebTrailers	Use GrpcWebTrailers instead.

Deprecated Enum Classes

Enum Class	Description
com.linecorp.armeria.server.annotation.ExceptionVerbosity	Use LoggingService or log exceptions using ServerBuilder.errorHandler(ServerErrorHandler) instead.

Deprecated Fields

Field	Description
com.linecorp.armeria.client.ClientFactoryOptions.TLS_ALLOW_UNSAFE_CIPHERS	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.

Deprecated Methods

Method	Description
com.linecorp.armeria.client.AbstractClientOptionsBuilder.auth(BasicToken)	Use AbstractClientOptionsBuilder.auth(AuthToken) instead.
com.linecorp.armeria.client.AbstractClientOptionsBuilder.auth(OAuth1aToken)	Use AbstractClientOptionsBuilder.auth(AuthToken) instead.
com.linecorp.armeria.client.AbstractClientOptionsBuilder.auth(OAuth2Token)	Use AbstractClientOptionsBuilder.auth(AuthToken) instead.
com.linecorp.armeria.client.AbstractDnsResolverBuilder.disableDnsQueryMetrics()	Use AbstractDnsResolverBuilder.enableDnsQueryMetrics(boolean) instead.
com.linecorp.armeria.client.AbstractDnsResolverBuilder.dnsServerAddressStreamProvider(DnsServerAddressStreamProvider)	Use AbstractDnsResolverBuilder.serverAddressStreamProvider(DnsServerAddressStreamProvider) instead.
com.linecorp.armeria.client.AbstractWebClientBuilder.rpcDecorator(DecoratingRpcClientFunction)	RPC decorator cannot be added to the web client builder.
com.linecorp.armeria.client.AbstractWebClientBuilder.rpcDecorator(Function<? super RpcClient, ? extends RpcClient>)	RPC decorator cannot be added to the web client builder.
com.linecorp.armeria.client.circuitbreaker.CircuitBreaker.canRequest()	Use CircuitBreaker.tryRequest().
com.linecorp.armeria.client.circuitbreaker.CircuitBreakerClient.newPerHostAndMethodDecorator(BiFunction<String, String, ? extends CircuitBreaker>, CircuitBreakerRule)	Use CircuitBreakerClient.newDecorator(CircuitBreakerMapping, CircuitBreakerRule) with CircuitBreakerMapping.perHostAndMethod(BiFunction).
com.linecorp.armeria.client.circuitbreaker.CircuitBreakerClient.newPerHostAndMethodDecorator(BiFunction<String, String, ? extends CircuitBreaker>, CircuitBreakerRuleWithContent<HttpResponse>)	Use CircuitBreakerClient.newDecorator(CircuitBreakerMapping, CircuitBreakerRuleWithContent) with CircuitBreakerMapping.perHostAndMethod(BiFunction).
com.linecorp.armeria.client.circuitbreaker.CircuitBreakerRpcClient.newPerHostAndMethodDecorator(BiFunction<String, String, ? extends CircuitBreaker>, CircuitBreakerRuleWithContent<RpcResponse>)	Use CircuitBreakerRpcClient.newDecorator(CircuitBreakerMapping, CircuitBreakerRuleWithContent) with CircuitBreakerMapping.perHostAndMethod(BiFunction).
com.linecorp.armeria.client.ClientFactoryBuilder.tlsAllowUnsafeCiphers()	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.
com.linecorp.armeria.client.ClientFactoryBuilder.tlsAllowUnsafeCiphers(boolean)	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.
com.linecorp.armeria.client.ClientRequestContext.whenResponseTimedOut()	Use ClientRequestContext.whenResponseCancelled() instead.
com.linecorp.armeria.client.ClientRequestContext.whenResponseTimingOut()	Use ClientRequestContext.whenResponseCancelling() instead.
com.linecorp.armeria.client.ClientRequestContextWrapper.whenResponseTimedOut()
com.linecorp.armeria.client.ClientRequestContextWrapper.whenResponseTimingOut()
com.linecorp.armeria.client.DefaultClientRequestContext.whenResponseTimedOut()
com.linecorp.armeria.client.DefaultClientRequestContext.whenResponseTimingOut()
com.linecorp.armeria.client.DnsResolverGroupBuilder.disableDnsQueryMetrics()
com.linecorp.armeria.client.DnsResolverGroupBuilder.dnsServerAddressStreamProvider(DnsServerAddressStreamProvider)
com.linecorp.armeria.client.endpoint.dns.DnsAddressEndpointGroupBuilder.disableDnsQueryMetrics()
com.linecorp.armeria.client.endpoint.dns.DnsServiceEndpointGroupBuilder.disableDnsQueryMetrics()
com.linecorp.armeria.client.endpoint.dns.DnsServiceEndpointGroupBuilder.dnsServerAddressStreamProvider(DnsServerAddressStreamProvider)
com.linecorp.armeria.client.endpoint.dns.DnsTextEndpointGroupBuilder.disableDnsQueryMetrics()
com.linecorp.armeria.client.endpoint.dns.DnsTextEndpointGroupBuilder.dnsServerAddressStreamProvider(DnsServerAddressStreamProvider)
com.linecorp.armeria.client.eureka.EurekaEndpointGroupBuilder.registryFetchIntervalSeconds(long)	Use EurekaEndpointGroupBuilder.registryFetchIntervalMillis(long).
com.linecorp.armeria.client.grpc.GrpcClientBuilder.path(String)	Use GrpcClientBuilder.pathPrefix(String) instead.
com.linecorp.armeria.client.grpc.GrpcClientBuilder.rpcDecorator(DecoratingRpcClientFunction)	Use either GrpcClientBuilder.decorator(DecoratingHttpClientFunction) or GrpcClientBuilder.intercept(ClientInterceptor...) instead.
com.linecorp.armeria.client.grpc.GrpcClientBuilder.rpcDecorator(Function<? super RpcClient, ? extends RpcClient>)	Use either GrpcClientBuilder.decorator(DecoratingHttpClientFunction) or GrpcClientBuilder.intercept(ClientInterceptor...) instead.
com.linecorp.armeria.client.limit.ConcurrencyLimitingClient.newDecorator(int, long, TimeUnit)	Use ConcurrencyLimitingClient.newDecorator(ConcurrencyLimit) with the limit created via ConcurrencyLimit.builder(int)
com.linecorp.armeria.client.logging.LoggingClientBuilder.requestLogLevelMapper(Function<? super RequestOnlyLog, LogLevel>)
com.linecorp.armeria.client.logging.LoggingClientBuilder.responseLogLevelMapper(Function<? super RequestLog, LogLevel>)
com.linecorp.armeria.client.logging.LoggingRpcClientBuilder.requestLogLevelMapper(Function<? super RequestOnlyLog, LogLevel>)
com.linecorp.armeria.client.logging.LoggingRpcClientBuilder.responseLogLevelMapper(Function<? super RequestLog, LogLevel>)
com.linecorp.armeria.client.retry.AbstractRetryingClientBuilder.maxTotalAttempts(int)	Use RetryConfigBuilder.maxTotalAttempts(int) instead.
com.linecorp.armeria.client.retry.AbstractRetryingClientBuilder.responseTimeoutForEachAttempt(Duration)	Use RetryConfigBuilder.responseTimeoutForEachAttempt(Duration) instead.
com.linecorp.armeria.client.retry.AbstractRetryingClientBuilder.responseTimeoutMillisForEachAttempt(long)	Use RetryConfigBuilder.responseTimeoutMillisForEachAttempt(long) instead.
com.linecorp.armeria.client.retry.RetryingClient.newDecorator(RetryRule, int)	Use RetryingClient.newDecorator(RetryConfig) instead.
com.linecorp.armeria.client.retry.RetryingClient.newDecorator(RetryRule, int, long)	Use RetryingClient.newDecorator(RetryConfig) instead.
com.linecorp.armeria.client.retry.RetryingClient.newDecorator(RetryRuleWithContent<HttpResponse>, int)	Use RetryingClient.newDecorator(RetryConfig) instead.
com.linecorp.armeria.client.retry.RetryingClient.newDecorator(RetryRuleWithContent<HttpResponse>, int, long)	Use RetryingClient.newDecorator(RetryConfig) instead.
com.linecorp.armeria.client.retry.RetryingRpcClient.newDecorator(RetryRuleWithContent<RpcResponse>, int)	Use RetryingRpcClient.newDecorator(RetryConfig) instead.
com.linecorp.armeria.client.retry.RetryingRpcClient.newDecorator(RetryRuleWithContent<RpcResponse>, int, long)	Use RetryingRpcClient.newDecorator(RetryConfig) instead.
com.linecorp.armeria.common.auth.BasicToken.of(String, String)	use AuthToken.ofBasic(String, String) instead.
com.linecorp.armeria.common.auth.OAuth1aToken.builder()	use AuthToken.builderForOAuth1a() instead.
com.linecorp.armeria.common.auth.OAuth2Token.of(String)	use AuthToken.ofOAuth2(String) instead.
com.linecorp.armeria.common.Cookie.builder(String, String)	Use Cookie.secureBuilder(String, String) instead to create a secure Cookie.
com.linecorp.armeria.common.Cookie.of(String, String)	Use Cookie.ofSecure(String, String) instead to create a secure Cookie.
com.linecorp.armeria.common.Flags.annotatedServiceExceptionVerbosity()	Use LoggingService or log exceptions using ServerBuilder.errorHandler(ServerErrorHandler).
com.linecorp.armeria.common.Flags.useEpoll()	Use Flags.transportType() and -Dcom.linecorp.armeria.transportType=epoll.
com.linecorp.armeria.common.logging.LoggingDecoratorBuilder.requestLogLevelMapper(Function<? super RequestOnlyLog, LogLevel>)	Use LoggingDecoratorBuilder.requestLogLevelMapper(RequestLogLevelMapper) instead.
com.linecorp.armeria.common.logging.LoggingDecoratorBuilder.responseLogLevelMapper(Function<? super RequestLog, LogLevel>)	Use LoggingDecoratorBuilder.responseLogLevelMapper(ResponseLogLevelMapper) instead.
com.linecorp.armeria.common.logging.RequestLogLevelMapper.andThen(Function<? super LogLevel, ? extends V>)	Do not use this method.
com.linecorp.armeria.common.logging.RequestLogLevelMapper.compose(Function<? super V, ? extends RequestOnlyLog>)	Do not use this method.
com.linecorp.armeria.common.logging.ResponseLogLevelMapper.andThen(Function<? super LogLevel, ? extends V>)	Do not use this method.
com.linecorp.armeria.common.logging.ResponseLogLevelMapper.compose(Function<? super V, ? extends RequestLog>)	Do not use this method.
com.linecorp.armeria.common.metric.AbstractMetricCollectingBuilder.successFunction(BiPredicate<? super RequestContext, ? super RequestLog>)	Use ClientBuilder.successFunction(SuccessFunction) or ServerBuilder.successFunction(SuccessFunction).
com.linecorp.armeria.common.thrift.ThriftProtocolFactories.get(SerializationFormat)	Use ThriftSerializationFormats.protocolFactory(SerializationFormat).
com.linecorp.armeria.common.thrift.ThriftProtocolFactories.toSerializationFormat(TProtocolFactory)	This method has been deprecated without a replacement since it cannot reliably work with custom protocol factories.
com.linecorp.armeria.common.util.EventLoopGroups.datagramChannelType(EventLoopGroup)	Use TransportType.datagramChannelType(EventLoopGroup).
com.linecorp.armeria.common.util.EventLoopGroups.serverChannelType(EventLoopGroup)	Use TransportType.serverChannelType(EventLoopGroup).
com.linecorp.armeria.common.util.EventLoopGroups.socketChannelType(EventLoopGroup)	Use TransportType.socketChannelType(EventLoopGroup).
com.linecorp.armeria.server.annotation.decorator.LoggingDecorator.samplingRate()	Use LoggingDecorator.successSamplingRate() and LoggingDecorator.failureSamplingRate().
com.linecorp.armeria.server.DefaultServiceRequestContext.whenRequestTimedOut()
com.linecorp.armeria.server.DefaultServiceRequestContext.whenRequestTimingOut()
com.linecorp.armeria.server.eureka.EurekaUpdatingListenerBuilder.leaseDurationSeconds(int)	Use EurekaUpdatingListenerBuilder.leaseDurationMillis(long).
com.linecorp.armeria.server.eureka.EurekaUpdatingListenerBuilder.renewalIntervalSeconds(int)	Use EurekaUpdatingListenerBuilder.renewalIntervalMillis(long).
com.linecorp.armeria.server.file.AbstractBlockingHttpVfs.get(Executor, String, Clock, String, HttpHeaders)	Use AbstractBlockingHttpVfs.get(Executor, String, Clock, String, HttpHeaders, MediaTypeResolver) instead.
com.linecorp.armeria.server.file.HttpVfs.get(Executor, String, Clock, String, HttpHeaders)	Use HttpVfs.get(Executor, String, Clock, String, HttpHeaders, MediaTypeResolver) instead.
com.linecorp.armeria.server.grpc.GrpcServiceBuilder.addExceptionMapping(Class<T>, BiFunction<T, Metadata, Status>)	Use GrpcServiceBuilder.addExceptionMapping(Class, GrpcStatusFunction) instead.
com.linecorp.armeria.server.grpc.GrpcServiceBuilder.setMaxInboundMessageSizeBytes(int)	Use GrpcServiceBuilder.maxRequestMessageLength(int) instead.
com.linecorp.armeria.server.grpc.GrpcServiceBuilder.setMaxOutboundMessageSizeBytes(int)	Use GrpcServiceBuilder.maxResponseMessageLength(int) instead.
com.linecorp.armeria.server.HttpResponseException.of(int)	Use HttpStatusException.of(int) instead.
com.linecorp.armeria.server.HttpResponseException.of(HttpStatus)	Use HttpStatusException.of(HttpStatus) instead.
com.linecorp.armeria.server.jetty.JettyServiceBuilder.configurator(Consumer<? super Server>)	Use JettyServiceBuilder.customizer(Consumer).
com.linecorp.armeria.server.logging.LoggingServiceBuilder.requestLogLevelMapper(Function<? super RequestOnlyLog, LogLevel>)
com.linecorp.armeria.server.logging.LoggingServiceBuilder.responseLogLevelMapper(Function<? super RequestLog, LogLevel>)
com.linecorp.armeria.server.Route.apply(RoutingContext)	Use Route.apply(RoutingContext, boolean).
com.linecorp.armeria.server.RoutingContext.isCorsPreflight()	Use RoutingContext.status() and RoutingStatus.CORS_PREFLIGHT.
com.linecorp.armeria.server.saml.SamlAssertionConsumerConfigBuilder.endpoint(SamlEndpoint)	Use SamlServiceProviderBuilder.acs(SamlEndpoint) to specify SamlEndpoint when creating this SamlAssertionConsumerConfigBuilder.
com.linecorp.armeria.server.saml.SamlServiceProviderBuilder.acs()	Use SamlServiceProviderBuilder.acs(SamlEndpoint).
com.linecorp.armeria.server.ServerBuilder.tlsAllowUnsafeCiphers()	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.
com.linecorp.armeria.server.ServerBuilder.tlsAllowUnsafeCiphers(boolean)	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.
com.linecorp.armeria.server.ServerConfig.findVirtualHost(String)	Use ServerConfig.findVirtualHost(String, int) instead.
com.linecorp.armeria.server.ServiceConfig.defaultServiceName()	Use ServiceConfig.defaultServiceNaming() instead.
com.linecorp.armeria.server.ServiceRequestContext.whenRequestTimedOut()	Use ServiceRequestContext.whenRequestCancelled() instead.
com.linecorp.armeria.server.ServiceRequestContext.whenRequestTimingOut()	Use ServiceRequestContext.whenRequestCancelling() instead.
com.linecorp.armeria.server.ServiceRequestContextWrapper.whenRequestTimedOut()
com.linecorp.armeria.server.ServiceRequestContextWrapper.whenRequestTimingOut()
com.linecorp.armeria.server.VirtualHostBuilder.tlsAllowUnsafeCiphers()	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.
com.linecorp.armeria.server.VirtualHostBuilder.tlsAllowUnsafeCiphers(boolean)	It's not recommended to enable this option. Use it only when you have no other way to communicate with an insecure peer than this.

Deprecated Constructors

Constructor	Description
com.linecorp.armeria.client.grpc.protocol.UnaryGrpcClient(WebClient)	Prefer using a standard client building pattern, e.g.: UnaryGrpcClient client = Clients.newClient("gproto+http://127.0.0.1:8080", UnaryGrpcClient.class);
com.linecorp.armeria.client.grpc.protocol.UnaryGrpcClient(WebClient, SerializationFormat)	Prefer using a standard client building pattern, e.g.: UnaryGrpcClient client = Clients.newClient("gproto-web+http://127.0.0.1:8080", UnaryGrpcClient.class);
com.linecorp.armeria.server.metric.PrometheusExpositionService(CollectorRegistry)	Use PrometheusExpositionService.of(CollectorRegistry).
com.linecorp.armeria.server.rxjava2.ObservableResponseConverterFunction(ResponseConverterFunction, ExceptionHandlerFunction)	The registered ExceptionHandlerFunctions will be applied automatically. Use ObservableResponseConverterFunction(ResponseConverterFunction) instead.
com.linecorp.armeria.server.rxjava3.ObservableResponseConverterFunction(ResponseConverterFunction, ExceptionHandlerFunction)	The registered ExceptionHandlerFunctions will be applied automatically. Use ObservableResponseConverterFunction(ResponseConverterFunction) instead.

Deprecated Annotation Interface Elements

Annotation Interface Element	Description
com.linecorp.armeria.server.annotation.decorator.LoggingDecorator.samplingRate()	Use LoggingDecorator.successSamplingRate() and LoggingDecorator.failureSamplingRate().