前言

在 Java 中通常對(duì)一些方法進(jìn)行一些注解操作，但是很多注解在 Java 代碼上沒(méi)有問(wèn)題，如果切換到 Kotlin 上時(shí)，如果繼續(xù)使用這些注解就會(huì)存在一些問(wèn)題，本篇主要對(duì)比一些常用 Java 注解和 Kotlin 注解使用轉(zhuǎn)換。

Deprecated

在 Java 方法中，如果需要廢棄一個(gè)方法，只需要在方法錢(qián)加上 @Deprecated 即可，例如這樣：

@Deprecated
public void test(){

}

但是如果在 Kotlin 代碼中直接使用這個(gè)注釋?zhuān)痛嬖趩?wèn)題了：

Deprecated

翻看源碼發(fā)現(xiàn)，Kotlin 中對(duì) Deprecated 這個(gè)注解做了加強(qiáng)：

@Target(CLASS, FUNCTION, PROPERTY, ANNOTATION_CLASS, CONSTRUCTOR, PROPERTY_SETTER, PROPERTY_GETTER, TYPEALIAS)
@MustBeDocumented
public annotation class Deprecated(
 val message: String,
 val replaceWith: ReplaceWith = ReplaceWith(""),
 val level: DeprecationLevel = DeprecationLevel.WARNING
)

源碼中 Deprecated 存在三個(gè)參數(shù)，其中第二個(gè)和第三個(gè)參數(shù)存在默認(rèn)值，第一個(gè)參數(shù) message 沒(méi)有，也就是說(shuō)，要想正常使用時(shí)，必須要帶上 message 信息，正常寫(xiě)法是這樣：

@Deprecated("xxx")
fun testKt(){

}

三個(gè)參數(shù)說(shuō)明：

message：解釋棄用并建議使用替代 API 的信息

level：指定如何在代碼中報(bào)告已棄用的元素用法，level 存在三種枚舉

public enum class DeprecationLevel {
/** Usage of the deprecated element will be reported as a warning. */
WARNING,
/** Usage of the deprecated element will be reported as an error. */
ERROR,
/** Deprecated element will not be accessible from code. */
HIDDEN
}

• WARNING：僅用于警告 API 使用者，不會(huì)中斷其編譯或運(yùn)行時(shí)使用
• ERROR：禁止使用該 API，如果調(diào)用了這類(lèi)API直接編譯報(bào)錯(cuò)
• HIDDEN：直接隱藏該 API

replaceWith：指定可用于替換已棄用的函數(shù)，屬性或類(lèi)的代碼片段。不明白？一圖看懂：

replace

SuppressWarnings 與 Suppress

在 Java 代碼中，如果需要消除一些編譯時(shí)的警告，通常使用 @SuppressWarnings("xxx") 來(lái)進(jìn)行解決的，而在 Kotlin 中，不能使用這個(gè)注解，需要使用Kotlin中內(nèi)置的 @Suppress("xxx") 帶替代。

例如，做 SDK 開(kāi)發(fā)的時(shí)候，通常有很多對(duì)外 API ，正常情況下，不調(diào)用的時(shí)候，會(huì)有如下類(lèi)似警告：

hello

對(duì)于有強(qiáng)迫癥的來(lái)說(shuō)這很難受，為了消除這種警告我們可以這樣：

@Suppress("unused")
fun hello() {
 println("hello")
}

如果是Java代碼則寫(xiě)成這樣：

@SuppressWarnings("unused")
public void hello(){
 
}

又例如，有時(shí)候需要做一些類(lèi)型轉(zhuǎn)換時(shí):

hello

此時(shí)為了消除這種警告，我們可以這樣操作：

fun unChecked(){
 val list: List<Any> = emptyList()

 @Suppress("UNCHECKED_CAST")
 list as List<String>
}

如果在Java代碼中則需要寫(xiě)成 @SuppressWarnings("unchecked")

Kotlin 中，Suppress 支持消除的警告有很多，可以通過(guò)源碼查閱更多相關(guān)參數(shù)信息，例如：

hello

總結(jié)

其實(shí)這兩種注解使用起來(lái)都不難，主要是平常 Java 代碼寫(xiě)習(xí)慣了，切換到 Kotlin 之后，很多 API 并不熟悉，需要在開(kāi)發(fā)過(guò)程中慢慢了解與積累，俗話說(shuō)好記性不如爛筆頭就是這么個(gè)道理。

好了，以上就是這篇文章的全部?jī)?nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，謝謝大家對(duì)腳本之家的支持。

最新評(píng)論