建站
咨詢
售后
建站咨詢
新聞中心
?我們通過Hello World這個例子引入了RPC 框架，知道了客戶端要想調(diào)用服務(wù)端需要靠兩個注解來實現(xiàn)，下面我們一起來實現(xiàn)這兩個注解。
成都創(chuàng)新互聯(lián)長期為千余家客戶提供的網(wǎng)站建設(shè)服務(wù)，團隊從業(yè)經(jīng)驗10年，關(guān)注不同地域、不同群體，并針對不同對象提供差異化的產(chǎn)品和服務(wù)；打造開放共贏平臺，與合作伙伴共同營造健康的互聯(lián)網(wǎng)生態(tài)環(huán)境。為瑪曲企業(yè)提供專業(yè)的網(wǎng)站設(shè)計制作、成都做網(wǎng)站，瑪曲網(wǎng)站改版等技術(shù)服務(wù)。擁有10年豐富建站經(jīng)驗和眾多成功案例,為您定制開發(fā)。
注解相關(guān)的實現(xiàn)代碼是 RPC 框架的核心代碼，后面寫完后可以打包成一個 jar 包作為框架供業(yè)務(wù)代碼中使用，這樣我們前面寫的客戶端和服務(wù)端 demo 就可以正常工作了。
好了，鋪墊這么多，我們真正開始寫 RPC 框架代碼了。RPC 框架計劃提供兩個注解：
- @ServiceReference
- @ServiceExpose
@ServiceReference
@ServiceReference?注解用來引用服務(wù)端提供的服務(wù)，客戶端啟動后可以自動注入對應(yīng)的bean，像調(diào)用本地方法一樣調(diào)用遠程服務(wù)的方法。
首先，我們來定義一個注解類，interface?關(guān)鍵字用來聲明接口，前面加一個@?就可以用來定義注解類，如上面約定客戶端側(cè)注解名為：ServiceReference。
public @interface ServiceReference {
}注解類還可以加很多配置項，一般用幾個元注解進行修飾：
@Target?表示我們定義的這個注解使用的范圍，ElementType?是枚舉類有很多枚舉值，這里我們只用到ElementType.FIELD，業(yè)務(wù)含義：當(dāng)前這個自定義注解只能在類的成員變量上使用。
@Retention?表示注解的保留策略，RetentionPolicy.RUNTIME?的意思是希望注解能一直保留到運行期，那為什么要保留到運行期呢？因為我們希望在運行期通過這個注解自動注入依賴。如果取值為RetentionPolicy.SOURCE則表示僅保存在源碼中，在代碼編譯后就會丟掉這個注解的信息。
@Documented與文檔相關(guān)的，沒有其他業(yè)務(wù)含義，這里不再贅述。
一個完整的注解類詳細(xì)代碼如下：
@Target({ElementType.FIELD})
// 注解保留策略
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ServiceReference {
}
注解已經(jīng)定義好了，代碼非常簡單，使用起來也比較簡單，在類的成員變量上加一個這樣的注解即可：
class A {
@ServiceReference
private XxxService xxxService;
……省略
}可能有小伙伴要問了，為什么加一個簡單的注解就能將遠程服務(wù)的依賴注入進來？這其實是框架背后的功勞，服務(wù)啟動后會自動掃描框架的注解，根據(jù)不同的注解框架會有對應(yīng)的初始化動作，至于@ServiceReference的初始化邏輯我們下一個小節(jié)再詳細(xì)展開講。
下面接著看另外一個注解。
@ServiceExpose
@ServiceExpose注解用于服務(wù)端暴露自己的服務(wù)接口（方法），進而可被客戶端發(fā)現(xiàn)調(diào)用。
與@ServiceReference?類似，定義一個注解，取名叫做：ServiceExpose。
public @interface ServiceExpose {
}與@ServiceReference?稍微有點不同的是，多增加了一個元注解：@Component?以及@Target取值不一樣。
@Component是Spring?原生的注解，Spring?啟動后會掃描注解并將其初始化一個bean?，用于配合@ServiceExpose注解使用，具體邏輯后面章節(jié)會詳細(xì)介紹。
@Target?用于約束注解的使用范圍，ElementType.TYPE表示當(dāng)前這個注解僅可在類（class）、接口（interface）、枚舉（enum）類上使用，在其他地方使用是非法的，會編譯失敗。
完整的代碼如下：
// 元注解，Spring 原生注解
@Component
// 約束注解使用范圍
@Target({ElementType.TYPE})
// 注解保留策略
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ServiceExpose {
}
代碼結(jié)構(gòu)
在前面搭建環(huán)境時創(chuàng)建了一個maven?工程，我們繼續(xù)在工程中創(chuàng)建一個 package并取名為：annotation，剛才寫完的兩個注解類代碼放進去。
目前框架的代碼結(jié)構(gòu)如下：
├── easy-rpc-spring-boot-starter
│ ├── pom.xml
│ ├── src
│ │ └── main
│ │ ├── java
│ │ │ └── com
│ │ │ └── leixiaoshuai
│ │ │ └── easyrpc
│ │ │ ├── annotation
│ │ │ │ ├── ServiceExpose.java
│ │ │ │ └── ServiceReference.java
│ │ └── resources
小結(jié)
前面帶領(lǐng)大家寫完了框架中核心的兩個注解類：@ServiceReference? 和 @ServiceExpose?，客戶端常使用@ServiceReference?引用服務(wù)端；服務(wù)端常使用@ServiceExpose暴露自身的服務(wù)便于客戶端發(fā)現(xiàn)和使用。
定義注解的步驟非常簡單：
- 使用@interface聲明注解類
- 注解類前面添加元注解，如：@Target、@Retention等
相信大家也發(fā)現(xiàn)了，注解類定義好之后并不能立馬生效，比如在一個類上添加注解@ServiceReference，我們期望服務(wù)啟動后這個類能自動暴露自己，但是你會發(fā)現(xiàn)什么也沒發(fā)生，這是為什么呢？
其實注解僅僅只是一種標(biāo)記的手段，自身并無業(yè)務(wù)邏輯，如果你希望注解實現(xiàn)預(yù)期效果，需要自己去寫一段驅(qū)動代碼，代碼中可以通過反射方式掃描所有添加了注解的地方，然后執(zhí)行對應(yīng)的邏輯，至于什么時候執(zhí)行這段驅(qū)動代碼，需要結(jié)合注解的保留策略，一般是編譯或者運行中執(zhí)行。
明白了這個道理之后，要想使@ServiceReference? 和 @ServiceExpose這兩個注解實現(xiàn)對應(yīng)的功能，需要分別寫一段驅(qū)動程序，這段代碼在后續(xù)的章節(jié)會詳細(xì)介紹，我們接著往下看。
網(wǎng)頁標(biāo)題：你該學(xué)會自己寫Java注解了
分享URL：http://fisionsoft.com.cn/article/dhpedss.html
