SpringCloud @FeignClient參數(shù)的用法解析
SpringCloud @FeignClient 參數(shù)詳解
今天因為工作中遇到FeignClient一個奇葩的bug,后面仔細研究了,找出了原因,那么剛好對FeignClient 這個注解總結(jié)一下:
先看@FeignClient 源碼:源碼如下,本文最后面。
11個方法,常用方法說明如下
@FeignClient(name = "service-name", url = "${feign.urls.service-name:}", fallback =ApiFallBack.class,configuration = Interceptor.class)
- 1.
value
,name
這兩個就同一個意思:對應(yīng)的是調(diào)用的微服務(wù)的服務(wù)名,對用服務(wù)發(fā)現(xiàn)、走網(wǎng)關(guān)調(diào)用,這個很關(guān)鍵。 - 2.
url
這是訪問地址,可以直接提供給外部調(diào)用,也可以直接寫如192.168.1.11:8800/applicationName - 3.
fallback
與fallbackFactory
就給@FeignClient注解設(shè)置fallback屬性,并且回退類要繼承@FeignClient所注解的接口
ApiFallBack類拿出去單獨作為一個類的話,我們就得在該類上添加注解@Component
如果fallback默認優(yōu)先級比fallfactory優(yōu)先級高。所以二者都存在的話,會訪問fallback的回退方法。
這里不做演示。
那么fallback和fallfactory有什么區(qū)別呢
@FeignClient(name = "service-name", fallbackFactory = HystrixClientFallbackFactory.class) protected interface HystrixClient { @RequestMapping(method = RequestMethod.GET, value = "/test") Hello iFailSometimes(); } @Component static class HystrixClientFallbackFactory implements FallbackFactory<HystrixClient> { @Override public HystrixClient create(Throwable cause) { return new HystrixClientWithFallBackFactory() { @Override public Hello iFailSometimes() { return new Hello("fallback; reason was: " + cause.getMessage()); } }; } }
fallback和fallfactory區(qū)別
fallback
只是重寫了回退方法。fallfactory
層面比較深,因為它用線程拋出了異常,可以看到底層具體問題。
/** * Annotation for interfaces declaring that a REST client with that interface should be * created (e.g. for autowiring into another component). If ribbon is available it will be * used to load balance the backend requests, and the load balancer can be configured * using a <code>@RibbonClient</code> with the same name (i.e. value) as the feign client. * * @author Spencer Gibb * @author Venil Noronha */ @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface FeignClient { /** * The name of the service with optional protocol prefix. Synonym for {@link #name() * name}. A name must be specified for all clients, whether or not a url is provided. * Can be specified as property key, eg: ${propertyKey}. */ @AliasFor("name") String value() default ""; /** * The service id with optional protocol prefix. Synonym for {@link #value() value}. * * @deprecated use {@link #name() name} instead */ @Deprecated String serviceId() default ""; /** * The service id with optional protocol prefix. Synonym for {@link #value() value}. */ @AliasFor("value") String name() default ""; /** * Sets the <code>@Qualifier</code> value for the feign client. */ String qualifier() default ""; /** * An absolute URL or resolvable hostname (the protocol is optional). */ String url() default ""; /** * Whether 404s should be decoded instead of throwing FeignExceptions */ boolean decode404() default false; /** * A custom <code>@Configuration</code> for the feign client. Can contain override * <code>@Bean</code> definition for the pieces that make up the client, for instance * {@link feign.codec.Decoder}, {@link feign.codec.Encoder}, {@link feign.Contract}. * * @see FeignClientsConfiguration for the defaults */ Class<?>[] configuration() default {}; /** * Fallback class for the specified Feign client interface. The fallback class must * implement the interface annotated by this annotation and be a valid spring bean. */ Class<?> fallback() default void.class; /** * Define a fallback factory for the specified Feign client interface. The fallback * factory must produce instances of fallback classes that implement the interface * annotated by {@link FeignClient}. The fallback factory must be a valid spring * bean. * * @see feign.hystrix.FallbackFactory for details. */ Class<?> fallbackFactory() default void.class; /** * Path prefix to be used by all method-level mappings. Can be used with or without * <code>@RibbonClient</code>. */ String path() default ""; /** * Whether to mark the feign proxy as a primary bean. Defaults to true. */ boolean primary() default true; }
@FeignClient 注解常用參數(shù)
怕以后又忘記,總結(jié)下目前項目中實際用到的 @FeignClient 注解中的參數(shù),如下:
@FeignClient(value = "annoroad-alpha", url = "${annoroad.ms.annoroad-alpha.url}") public interface UserFacade { @PostMapping(value = "/user/detail") UserDto detail(@RequestParam("id") long id); }
value
- value 等同于 name
url
- 一般用于調(diào)試,可以手動指定 @FeignClient 調(diào)用的地址
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。
相關(guān)文章
MyBatis-Flex+ShardingSphere-JDBC多數(shù)據(jù)源分庫分表實現(xiàn)
本文介紹了使用MyBatis-Flex和ShardingSphere-JDBC實現(xiàn)多數(shù)據(jù)源分庫分表的方法,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2024-10-10mybatisplus的坑?insert標簽insert?into?select無參數(shù)問題的解決
這篇文章主要介紹了mybatisplus的坑?insert標簽insert?into?select無參數(shù)問題的解決,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2021-12-12java編程之基于SpringBoot框架實現(xiàn)掃碼登錄
本文將介紹基于SpringBoot + Vue + Android實現(xiàn)的掃碼登錄demo的總體思路,文中附含詳細示例代碼,有需要的朋友可以借鑒參考下,希望能夠有所幫助2021-09-09