前言

今天猛然想起一個注解在使用上的問題，就一直在網上搜索資料，問題倒是沒解決，但是看到了一篇非常好的博客，正好是我這里缺少的，寫的很不錯，所以直接轉載。

在之前的demo中，為了完成編譯注解的功能，我們引入了com.google.auto.service:auto-service:1.0-rc2，這篇博客就是重點介紹了里面的api。

原文博客鏈接：http://blog.csdn.net/github_35180164/article/details/52171135。

正文

Element和TypeMirror

我覺得這兩個是開發注解處理器最重要的兩個概念，理解這兩個的概念和使用是非常有必要的。

這兩個都是接口，先來看一下Element的定義：

/** * 表示一個程序元素，比如包、類或者方法，有如下幾種子接口： * ExecutableElement：表示某個類或接口的方法、構造方法或初始化程序（靜態或實例），包括注解類型元素 ； * PackageElement：表示一個包程序元素； * TypeElement：表示一個類或接口程序元素； * TypeParameterElement：表示一般類、接口、方法或構造方法元素的形式類型參數； * VariableElement：表示一個字段、enum 常量、方法或構造方法參數、局部變量或異常參數 */ public interface Element extends AnnotatedConstruct { /** * 返回此元素定義的類型 * 例如，對于一般類元素 C<N extends Number>，返回參數化類型 C<N> */ TypeMirror asType(); /** * 返回此元素的種類：包、類、接口、方法、字段...,如下枚舉值 * PACKAGE, ENUM, CLASS, ANNOTATION_TYPE, INTERFACE, ENUM_CONSTANT, FIELD, PARAMETER, LOCAL_VARIABLE, EXCEPTION_PARAMETER, * METHOD, CONSTRUCTOR, STATIC_INIT, INSTANCE_INIT, TYPE_PARAMETER, OTHER, RESOURCE_VARIABLE; */ ElementKind getKind(); /** * 返回此元素的修飾符,如下枚舉值 * PUBLIC, PROTECTED, PRIVATE, ABSTRACT, DEFAULT, STATIC, FINAL, * TRANSIENT, VOLATILE, SYNCHRONIZED, NATIVE, STRICTFP; */ Set<Modifier> getModifiers(); /** * 返回此元素的簡單名稱,例如 * 類型元素 java.util.Set<E> 的簡單名稱是 "Set"； * 如果此元素表示一個未指定的包，則返回一個空名稱； * 如果它表示一個構造方法，則返回名稱 "<init>"； * 如果它表示一個靜態初始化程序，則返回名稱 "<clinit>"； * 如果它表示一個匿名類或者實例初始化程序，則返回一個空名稱 */ Name getSimpleName(); /** * 返回封裝此元素的最里層元素。 * 如果此元素的聲明在詞法上直接封裝在另一個元素的聲明中，則返回那個封裝元素； * 如果此元素是頂層類型，則返回它的包； * 如果此元素是一個包，則返回 null； * 如果此元素是一個泛型參數，則返回 null. */ Element getEnclosingElement(); /** * 返回此元素直接封裝的子元素 */ List<? extends Element> getEnclosedElements(); /** * 返回直接存在于此元素上的注解 * 要獲得繼承的注解，可使用 getAllAnnotationMirrors */ @Override List<? extends AnnotationMirror> getAnnotationMirrors(); /** * 返回此元素針對指定類型的注解（如果存在這樣的注解），否則返回 null。注解可以是繼承的，也可以是直接存在于此元素上的 */ @Override <A extends Annotation> A getAnnotation(Class<A> annotationType); } 復制代碼

Element 代表程序的元素，在注解處理過程中，編譯器會掃描所有的Java源文件，并將源碼中的每一個部分都看作特定類型的 Element。它可以代表包、類、接口、方法、字段等多種元素種類，具體看getKind()方法中所指代的種類，每個Element 代表一個靜態的、語言級別的構件。

Element 有五個直接子接口，它們分別代表一種特定類型的元素，如下：

PackageElement 表示一個包程序元素 TypeElement 表示一個類或接口程序元素 VariableElement 表示一個字段、enum 常量、方法或構造方法參數、局部變量或異常參數 ExecutableElement 表示某個類或接口的方法、構造方法或初始化程序（靜態或實例），包括注解類型元素 TypeParameterElement 表示一般類、接口、方法或構造方法元素的泛型參數

在開發中Element可根據實際情況強轉為以上5種中的一種，它們都帶有各自獨有的方法，來看個簡單的例子：

package com.example; // PackageElement import java.util.List; public class Sample // TypeElement <T extends List> { // TypeParameterElement private int num; // VariableElement String name; // VariableElement public Sample() {} // ExecuteableElement public void setName( // ExecuteableElement String name // VariableElement ) {} } 復制代碼

源碼中的每個部分都作為一個Element，而TypeElement對應著一種更具體的類型元素。根據上面的表格可以知道，一種特定的元素一般不止指代一種元素種類(ElementKind)，比如TypeElement可以指代類或接口，要知道一個元素的準確的種類需要調用getKind()方法，該方法返回一個ElementKind枚舉值來表示具體種類，如下：

public enum ElementKind { /** A package. */ PACKAGE, /** An enum type. */ ENUM, /** A class not described by a more specific kind (like {@code ENUM}). */ CLASS, /** An annotation type. */ ANNOTATION_TYPE, /** An interface not described by a more specific kind */ INTERFACE, // Variables /** An enum constant. */ ENUM_CONSTANT, /** A field not described by a more specific kind */ FIELD, /** A parameter of a method or constructor. */ PARAMETER, /** A local variable. */ LOCAL_VARIABLE, /** A parameter of an exception handler. */ EXCEPTION_PARAMETER, // Executables /** A method. */ METHOD, /** A constructor. */ CONSTRUCTOR, /** A static initializer. */ STATIC_INIT, /** An instance initializer. */ INSTANCE_INIT, /** A type parameter. */ TYPE_PARAMETER, /** An implementation-reserved element. This is not the element you are looking for. */ OTHER, /** * A resource variable. * @since 1.7 */ RESOURCE_VARIABLE; } 復制代碼

上面管ElementKind稱作元素的種類，因為它和元素的類型TypeMirror很容易混掉。TypeMirror表示的是 Java 編程語言中的類型，比如上面例子中的字段String name，它的元素種類為FIELD，而它的元素類型為DECLARED表示一個類類型，這里對應Java 編程語言中的類型為java.lang.String。Element代表的是源代碼上的元素，TypeMirror代表的是Element對應Java 編程語言中的類型。

/** * 表示 Java 編程語言中的類型 */ public interface TypeMirror { /** * 返回此類型的種類，一個 TypeKind 枚舉值： */ TypeKind getKind(); } 復制代碼

TypeMirror和Element一樣有一個getKind()方法來獲取具體的類型，方法返回一個枚舉值，如下：

public enum TypeKind { /** The primitive type {@code boolean}. */ BOOLEAN, /** The primitive type {@code byte}. */ BYTE, /** The primitive type {@code short}. */ SHORT, /** The primitive type {@code int}. */ INT, /** The primitive type {@code long}. */ LONG, /** The primitive type {@code char}. */ CHAR, /** The primitive type {@code float}. */ FLOAT, /** The primitive type {@code double}. */ DOUBLE, /** The pseudo-type corresponding to the keyword {@code void}. */ VOID, /** A pseudo-type used where no actual type is appropriate. */ NONE, /** The null type. */ NULL, /** An array type. */ ARRAY, /** A class or interface type. */ DECLARED, /** A class or interface type that could not be resolved. */ ERROR, /** A type variable. */ TYPEVAR, /** A wildcard type argument. */ WILDCARD, /** A pseudo-type corresponding to a package element. */ PACKAGE, /** A method, constructor, or initializer. */ EXECUTABLE, /** An implementation-reserved type. This is not the type you are looking for. */ OTHER, /** A union type. */ UNION, /** An intersection type. */ INTERSECTION; } 復制代碼

可以看到和ElementKind所描述的是不同的方面。不知道這樣說明的清不清楚，其實這種概念上的東西自己用幾次會有更好理解，這東西就說到這。

Element的直接子接口

這里列一下5個Element子接口常用方法，大部分描述是從JDK PAI手冊中截取。這東西你也沒必要一次看完，大概了解一下，等到需要用的時候能夠知道有這么個東西就行了。

/** * 表示一個類或接口程序元素 */ public interface TypeElement { /** * 返回此類型元素的嵌套種類 * 某一類型元素的嵌套種類 (nesting kind)。類型元素的種類有四種：top-level（頂層）、member（成員）、local（局部）和 anonymous（匿名） */ NestingKind getNestingKind(); /** * 返回此類型元素的完全限定名稱。更準確地說，返回規范 名稱。對于沒有規范名稱的局部類和匿名類，返回一個空名稱. * 一般類型的名稱不包括對其形式類型參數的任何引用。例如，接口 java.util.Set<E> 的完全限定名稱是 "java.util.Set" */ Name getQualifiedName(); /** * 返回此類型元素的直接超類。如果此類型元素表示一個接口或者類 java.lang.Object，則返回一個種類為 NONE 的 NoType */ TypeMirror getSuperclass(); /** * 返回直接由此類實現或直接由此接口擴展的接口類型 */ List<? extends TypeMirror> getInterfaces(); /** * 按照聲明順序返回此類型元素的形式類型參數 */ List<? extends TypeParameterElement> getTypeParameters(); } 復制代碼

PackageElement

/** * 表示一個包程序元素. */ public interface PackageElement { /** * 返回此包的完全限定名稱。該名稱也是包的規范名稱 */ Name getQualifiedName(); /** * 如果此包是一個未命名的包，則返回 true，否則返回 false */ boolean isUnnamed(); } 復制代碼

ExecutableElement

/** * 表示某個類或接口的方法、構造方法或初始化程序（靜態或實例），包括注解類型元素 */ public interface ExecutableElement { /** * 獲取按照聲明順序返回形式類型參數元素 */ List<? extends TypeParameterElement> getTypeParameters(); /** * 獲取返回的類型元素 */ TypeMirror getReturnType(); /** * 獲取形參元素 */ List<? extends VariableElement> getParameters(); /** * 如果此方法或構造方法接受可變數量的參數，則返回 true，否則返回 false */ boolean isVarArgs(); /** * 按聲明順序返回此方法或構造方法的 throws 子句中所列出的異常和其他 throwable */ List<? extends TypeMirror> getThrownTypes(); /** * 如果此 executable 是一個注解類型元素，則返回默認值。如果此方法不是注解類型元素，或者它是一個沒有默認值的注解類型元素，則返回 null */ AnnotationValue getDefaultValue(); } 復制代碼

VariableElement

/** * 表示一個字段、enum 常量、方法或構造方法參數、局部變量或異常參數 */ public interface VariableElement { /** * 如果此變量是一個被初始化為編譯時常量的 static final 字段，則返回此變量的值。否則返回 null。 * 該值為基本類型或 String，如果該值為基本類型，則它被包裝在適當的包裝類中（比如 Integer）。 * 注意，并非所有的 static final 字段都將具有常量值。特別是，enum 常量不 被認為是編譯時常量。要獲得一個常量值，字段的類型必須是基本類型或 String */ Object getConstantValue(); } 復制代碼

TypeParameterElement

/** * 表示一般類、接口、方法或構造方法元素的泛型參數. */ public interface TypeParameterElement { /** * 返回由此類型參數參數化的一般類、接口、方法或構造方法 */ Element getGenericElement(); /** * 返回此類型參數的邊界。它們是用來聲明此類型參數的 extends 子句所指定的類型。 * 如果沒有使用顯式的 extends 子句，則認為 java.lang.Object 是唯一的邊界 */ List<? extends TypeMirror> getBounds(); } 復制代碼

注解處理器的輔助接口

在自定義注解處理器的初始化接口，可以獲取到以下4個輔助接口：

public class MyProcessor extends AbstractProcessor { private Types typeUtils; private Elements elementUtils; private Filer filer; private Messager messager; @Override public synchronized void init(ProcessingEnvironment processingEnv) { super.init(processingEnv); typeUtils = processingEnv.getTypeUtils(); elementUtils = processingEnv.getElementUtils(); filer = processingEnv.getFiler(); messager = processingEnv.getMessager(); } } 復制代碼

其中Filer之前有用過，一般我們會用它配合JavaPoet來生成我們需要的.java文件，這里就不再提它的用法。

Messager

Messager提供給注解處理器一個報告錯誤、警告以及提示信息的途徑。它不是注解處理器開發者的日志工具，而是用來寫一些信息給使用此注解器的第三方開發者的。在官方文檔中描述了消息的不同級別中非常重要的是Kind.ERROR，因為這種類型的信息用來表示我們的注解處理器處理失敗了。很有可能是第三方開發者錯誤的使用了注解。這個概念和傳統的Java應用有點不一樣，在傳統Java應用中我們可能就拋出一個異常Exception。如果你在process()中拋出一個異常，那么運行注解處理器的JVM將會崩潰（就像其他Java應用一樣），使用我們注解處理器第三方開發者將會從javac中得到非常難懂的出錯信息，因為它包含注解處理器的堆棧跟蹤（Stacktace）信息。因此，注解處理器就有一個Messager類，它能夠打印非常優美的錯誤信息。除此之外，你還可以連接到出錯的元素。在像現在的IDE（集成開發環境）中，第三方開發者可以直接點擊錯誤信息，IDE將會直接跳轉到第三方開發者項目的出錯的源文件的相應的行。

看下接口代碼：

public interface Messager { void printMessage(Diagnostic.Kind kind, CharSequence msg); void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e); void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a); void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a, AnnotationValue v); } 復制代碼

方法都比較好懂，主要需要指定打印的信息類型和描述字符串。

Types Types是一個用來處理TypeMirror的工具，看下代碼就好了，提供的方法如下：

/** * 一個用來處理TypeMirror的工具 */ public interface Types { /** * 返回對應于類型的元素。該類型可能是 DeclaredType 或 TypeVariable。如果該類型沒有對應元素，則返回 null. */ Element asElement(TypeMirror t); /** * 測試兩個 TypeMirror 對象是否表示同一類型. * 警告：如果此方法兩個參數中有一個表示通配符，那么此方法將返回 false */ boolean isSameType(TypeMirror t1, TypeMirror t2); /** * 測試一種類型是否是另一個類型的子類型。任何類型都被認為是其本身的子類型. * * @return 當且僅當第一種類型是第二種類型的子類型時返回 true * @throws IllegalArgumentException 如果給定一個 executable 或 package 類型 */ boolean isSubtype(TypeMirror t1, TypeMirror t2); /** * 測試一種類型是否可以指派給另一種類型. * * @return 當且僅當第一種類型可以指派給第二種類型時返回 true * @throws IllegalArgumentException 如果給定一個 executable 或 package 類型 */ boolean isAssignable(TypeMirror t1, TypeMirror t2); /** * 測試一個類型參數是否包含 另一個類型參數. * * @return 當且僅當第一種類型包含第二種類型時返回 true * @throws IllegalArgumentException 如果給定一個 executable 或 package 類型 */ boolean contains(TypeMirror t1, TypeMirror t2); /** * 測試一個方法的簽名是否是另一個方法的子簽名. * * @return 當且僅當第一個簽名是第二個簽名的子簽名時返回 true */ boolean isSubsignature(ExecutableType m1, ExecutableType m2); /** * 返回類型的直接超類型。interface 類型將出現在列表的最后（如果有）. * * @return 直接超類型；如果沒有，則返回一個空列表 * @throws IllegalArgumentException 如果給定一個 executable 或 package 類型 */ List<? extends TypeMirror> directSupertypes(TypeMirror t); /** * 返回刪除狀態的類型. * * @return 刪除狀態的給定類型 * @throws IllegalArgumentException 如果給定一個 package 類型 */ TypeMirror erasure(TypeMirror t); /** * 返回給定基本類型的裝箱 (boxed) 值類型的類。即應用 boxing 轉換. * * @param p 要轉換的基本類型 * @return 類型 p 的裝箱值類型的類 */ TypeElement boxedClass(PrimitiveType p); /** * 返回給定類型的拆箱 (unboxed) 值類型（基本類型）。即應用 unboxing 轉換. * * @param t 要拆箱的類型 * @return 類型 t 的拆箱值類型 * @throws IllegalArgumentException 如果給定類型無法進行 unboxing 轉換 */ PrimitiveType unboxedType(TypeMirror t); /** * 對類型應用 capture 轉換. * * @return 應用 capture 轉換的結果 * @throws IllegalArgumentException 如果給定 executable 或 package 類型 */ TypeMirror capture(TypeMirror t); /** * 返回基本類型. * * @param kind 要返回的基本類型的種類 * @return 一個基本類型 * @throws IllegalArgumentException 如果 kind 不是基本種類 */ PrimitiveType getPrimitiveType(TypeKind kind); /** * 返回 null 類型。該類型是 null 的類型. */ NullType getNullType(); /** * 返回在實際類型不適用的地方所使用的偽類型。 * 要返回的類型的種類可以是 VOID 或 NONE。對于包，可以使用 Elements.getPackageElement(CharSequence).asType() 替代. * * @param kind 要返回的類型的種類 * @return 種類 VOID 或 NONE 的偽類型 * @throws IllegalArgumentException 如果 kind 無效 */ NoType getNoType(TypeKind kind); /** * 返回具有指定組件類型的數組類型. * * @throws IllegalArgumentException 如果組件類型對于數組無效 */ ArrayType getArrayType(TypeMirror componentType); /** * 返回新的通配符類型參數。可以指定通配符邊界中的一個，也可以都不指定，但不能都指定. * * @param extendsBound 擴展（上）邊界；如果沒有，則該參數為 null * @param superBound 超（下）邊界；如果沒有，則該參數為 null * @return 新的通配符 * @throws IllegalArgumentException 如果邊界無效 */ WildcardType getWildcardType(TypeMirror extendsBound, TypeMirror superBound); /** * 返回對應于類型元素和實際類型參數的類型。例如，如果給定 Set 的類型元素和 String 的類型鏡像，那么可以使用此方法獲取參數化類型 Set<String>. * * 類型參數的數量必須等于類型元素的形式類型參數的數量，或者等于 0。如果等于 0，并且類型元素是泛型，則返回該類型元素的原始類型. * * 如果返回一個參數化類型，則其類型元素不得包含在一般外部類中。 * 例如，首先使用此方法獲取類型 Outer<String>，然后調用 getDeclaredType(DeclaredType, TypeElement, TypeMirror...)， * 可以構造參數化類型 Outer<String>.Inner<Number>. * * @param typeElem 類型元素 * @param typeArgs 實際類型參數 * @return 對應于類型元素和實際類型參數的類型 * @throws IllegalArgumentException 如果給定的類型參數太多或太少，或者提供不合適的類型參數或類型元素 */ DeclaredType getDeclaredType(TypeElement typeElem, TypeMirror... typeArgs); /** * 根據給定的包含類型，返回對應于類型元素和實際類型參數的類型（它是給定包含類型的成員）.例子如上 * 如果包含類型是一個參數化類型，則類型參數的數量必須等于 typeElem 的形式類型參數的數量。 * 如果包含類型不是參數化的，或者為 null，則此方法等效于 getDeclaredType(typeElem, typeArgs）. * * @param containing 包含類型；如果沒有，則該參數為 null * @param typeElem 類型元素 * @param typeArgs 實際類型參數 * @return 對應于類型元素和實際類型參數的類型，該類型包含在給定類型中 * @throws IllegalArgumentException 如果給定的類型參數太多或太少，或者提供了不合適的類型參數、類型元素或包含類型 */ DeclaredType getDeclaredType(DeclaredType containing, TypeElement typeElem, TypeMirror... typeArgs); /** * 當元素被視為給定類型的成員或者直接由給定類型包含時，返回該元素的類型。 * 例如，被視為參數化類型 Set<String> 的成員時，Set.add 方法是參數類型為 String 的 ExecutableType. * * @param containing 包含類型 * @param element 元素 * @return 從包含類型來看的元素的類型 * @throws IllegalArgumentException 如果元素對于給定類型無效 */ TypeMirror asMemberOf(DeclaredType containing, Element element); } 復制代碼

Elements Elements是一個用來處理Element的工具，提供的方法如下：

/** * 一個用來處理Element的工具 */ public interface Elements { /** * 返回已給出其完全限定名稱的包. * * @param name 完全限定的包名稱；對于未命名的包，該參數為 "" * @return 指定的包；如果沒有找到這樣的包，則返回 null */ PackageElement getPackageElement(CharSequence name); /** * 返回已給出其規范名稱的類型元素. * * @param name 規范名稱 * @return 指定的類型元素；如果沒有找到這樣的元素，則返回 null */ TypeElement getTypeElement(CharSequence name); /** * 返回注釋元素的值，包括默認值. * 此值是以映射的形式返回的，該映射將元素與其相應的值關聯。只包括那些注釋中明確存在其值的元素，不包括那些隱式假定其默認值的元素。 * 映射的順序與值出現在注釋源中的順序匹配 * * @see AnnotationMirror#getElementValues() * @param a 要檢查的注釋 * @return 注釋元素的值，包括默認值 */ Map<? extends ExecutableElement, ? extends AnnotationValue> getElementValuesWithDefaults(AnnotationMirror a); /** * 返回元素的文檔（"Javadoc"）注釋文本 * * @param e 將被檢查的元素 * @return 元素的文檔注釋；如果沒有，則返回 null */ String getDocComment(Element e); /** * 如果元素已過時，則返回 true，否則返回 false. * * @param e 將被檢查的元素 * @return 如果元素已過時，則返回 true，否則返回 false */ boolean isDeprecated(Element e); /** * 返回類型元素的二進制名稱. * * @param type 將被檢查的類型元素 * @return 二進制名稱 */ Name getBinaryName(TypeElement type); /** * 返回元素的包。包的包是它本身. * * @param type 將被檢查的元素 * @return 元素的包 */ PackageElement getPackageOf(Element type); /** * 返回類型元素的所有成員，不管是繼承的還是直接聲明的。對于一個類，結果還包括其構造方法，但不包括局部類或匿名類. * * 注意，使用 ElementFilter 中的方法可以隔離某個種類的元素. * * @param type 將被檢查的類型 * @return 類型的所有成員 */ List<? extends Element> getAllMembers(TypeElement type); /** * 返回元素的所有注釋，不管是繼承的還是直接存在的. * * @param e 將被檢查的元素 * @return 元素的所有注釋 */ List<? extends AnnotationMirror> getAllAnnotationMirrors(Element e); /** * 測試一個類型、方法或字段是否隱藏了另一個類型、方法或字段. * * @param hider 第一個元素 * @param hidden 第二個元素 * @return 當且僅當第一個元素隱藏了第二個元素時返回 true */ boolean hides(Element hider, Element hidden); /** * 測試一個方法（作為給定類型的成員）是否重寫了另一個方法。當非抽象方法重寫抽象方法時，還可以說成是前者實現 了后者. * * @param overrider 第一個方法，可能是 overrider * @param overridden 第二個方法，可能被重寫 * @param type 第一個方法是其成員的類型 * @return 當且僅當第一個方法重寫第二個方法時返回 true */ boolean overrides(ExecutableElement overrider, ExecutableElement overridden, TypeElement type); /** * 返回表示基本值或字符串的常量表達式 文本。返回文本的形式是一種適合于表示源代碼中的值的形式. * * @param value 基本值或字符串 * @return 常量表達式的文本 * @throws IllegalArgumentException 如果參數不是基本值或字符串 * * @see VariableElement#getConstantValue() */ String getConstantExpression(Object value); /** * 按指定順序將元素的表示形式打印到給定 writer。此方法的主要用途是診斷。輸出的具體格式沒有 指定并且是可以更改的. * * @param w 輸出打印到的 writer * @param elements 要打印的元素 */ void printElements(java.io.Writer w, Element... elements); /** * 返回與參數具有相同字符序列的名稱. * * @param cs 將以名稱形式返回的字符序列 * @return 返回與參數具有相同字符序列的名稱 */ Name getName(CharSequence cs); /** * 如果類型是一個泛型接口則返回 true，否則返回 false * * @param type 將被檢查的類型 * @return 如果類型是一個泛型接口則返回 true，否則返回 false * @since 1.8 */ boolean isFunctionalInterface(TypeElement type); } 復制代碼

總結

篇幅稍微有點長，大家可以耐心的看，看完之后，對之前的demo的理解肯定又上升了一個水平。可能在復制的過程中，排版出現了一些變化，如果覺得不太美觀的話，可以去查看原文。

總結

以上是生活随笔為你收集整理的深入理解编译注解（四）常用接口介绍的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。