upload support annotation demo

Android Support Annotaion Demo

Author: RealMoMo

annotationdemo/.gitignore

@@ -0,0 +1 @@
+/build

annotationdemo/build.gradle

@@ -0,0 +1,36 @@
+apply plugin: 'com.android.application'
+
+android {
+    compileSdkVersion 27
+
+
+
+    defaultConfig {
+        applicationId "com.realmo.annotation"
+        minSdkVersion 19
+        targetSdkVersion 27
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
+
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+
+}
+
+dependencies {
+    implementation fileTree(include: ['*.jar'], dir: 'libs')
+    implementation 'com.android.support:appcompat-v7:27.1.1'
+    implementation 'com.android.support.constraint:constraint-layout:1.1.2'
+    testImplementation 'junit:junit:4.12'
+    androidTestImplementation 'com.android.support.test:runner:1.0.2'
+    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
+
+}

annotationdemo/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

annotationdemo/src/androidTest/java/com/realmo/annotation/ExampleInstrumentedTest.java

@@ -0,0 +1,26 @@
+package com.realmo.annotation;
+
+import android.content.Context;
+import android.support.test.InstrumentationRegistry;
+import android.support.test.runner.AndroidJUnit4;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+
+import static org.junit.Assert.*;
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
+ */
+@RunWith(AndroidJUnit4.class)
+public class ExampleInstrumentedTest {
+    @Test
+    public void useAppContext() {
+        // Context of the app under test.
+        Context appContext = InstrumentationRegistry.getTargetContext();
+
+        assertEquals("com.realmo.annotation", appContext.getPackageName());
+    }
+}

annotationdemo/src/main/AndroidManifest.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.realmo.annotation">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+        <activity android:name=".MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

annotationdemo/src/main/java/com/realmo/annotation/MainActivity.java

@@ -0,0 +1,126 @@
+package com.realmo.annotation;
+
+
+import android.support.annotation.WorkerThread;
+import android.support.v7.app.AppCompatActivity;
+import android.os.Bundle;
+import android.util.Log;
+import android.view.View;
+
+import com.realmo.annotation.callsuper.Son;
+import com.realmo.annotation.checkresult.CheckResultAnnotation;
+import com.realmo.annotation.intdef.User;
+import com.realmo.annotation.nullannotation.NullAnnotation;
+import com.realmo.annotation.other.OtherAnnotation;
+import com.realmo.annotation.res.ResAnnotation;
+import com.realmo.annotation.thread.ThreadAnnotation;
+import com.realmo.annotation.value_constraints.ValueConstraintsAnnotation;
+
+import java.lang.reflect.Method;
+
+public class MainActivity extends AppCompatActivity {
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.activity_main);
+
+
+    }
+
+
+    public void test(View view) {
+        //1.IntDef & StringDef
+        testIntDefAnnotation();
+
+        //2.Res Annotation
+        //testResAnnotation();
+
+        //3.Null Annotation
+        //testNullAnnotation();
+
+        //4.Thread Annotaion
+        //testThreadAnnotation();
+
+        //5.Value Constraints Annotation
+        //testValueConstraintsAnnotation();
+
+        //6.CallSuper Annotation
+        //testCallSuperAnnotation();
+
+        //7.CheckResult Annotation
+        //testCheckResultAnnotation();
+
+        //8.Other Annotation
+        //testOtherAnnotation();
+    }
+
+
+    private void testIntDefAnnotation(){
+        User user = new User();
+       // user.setUserType(1); //编译器会有警告提示，但不影响实际运行。
+        user.setUserType(User.UserType.IT_WORKER);
+
+        Log.d("realmo","intdef user type:"+user.getUserType()); //input 1
+
+    }
+
+
+
+
+    private void testResAnnotation(){
+        ResAnnotation resAnnotation = new ResAnnotation();
+    }
+
+    private void testNullAnnotation(){
+        NullAnnotation nullAnnotation = new NullAnnotation();
+
+        nullAnnotation.setNonNull(null);  //编译器会有提示，但不影响实际运行。
+        nullAnnotation.setNullable(null);
+        //so @Nonnull @Nullable 只是看看
+        Log.d("realmo","nonnull:"+nullAnnotation.getNonNull()); //null
+        Log.d("realmo","nullable:"+nullAnnotation.getNullable()); //null
+
+    }
+
+    @WorkerThread  //加此注解 除WorkerThread其他均报警告提示，但不影响实际运行
+    private void testThreadAnnotation(){
+        ThreadAnnotation threadAnnotation = new ThreadAnnotation();
+        threadAnnotation.workOnMainThread();        //log main
+        threadAnnotation.workOnUiThread();          //log main
+        threadAnnotation.workOnBinderThread();      //log main
+        threadAnnotation.workOnWorkerThread();      //log main
+    }
+
+
+    private void testValueConstraintsAnnotation(){
+        ValueConstraintsAnnotation vcAnnotation = new ValueConstraintsAnnotation();
+
+        vcAnnotation.setSizeString("1");
+        vcAnnotation.setSizeString("333"); //编译器会有提示，但不影响实际运行。
+
+        vcAnnotation.setIntRange(10);
+        vcAnnotation.setIntRange(11);      //编译器会有提示，但不影响实际运行。
+
+        vcAnnotation.setFloatRange(10f);
+        vcAnnotation.setFloatRange(10.1f);  //编译器会有提示，但不影响实际运行。
+    }
+
+
+    private void testCallSuperAnnotation(){
+        //具体见Father&Son类
+        Son son = new Son();
+        son.getMemberName();
+    }
+
+    private void testCheckResultAnnotation(){
+        CheckResultAnnotation crAnnotation = new CheckResultAnnotation();
+    }
+
+
+    private void testOtherAnnotation(){
+        OtherAnnotation otherAnnotation = new OtherAnnotation();
+    }
+
+
+}

annotationdemo/src/main/java/com/realmo/annotation/callsuper/Father.java

@@ -0,0 +1,22 @@
+package com.realmo.annotation.callsuper;
+
+import android.support.annotation.CallSuper;
+import android.util.Log;
+
+/**
+ * @author Realmo
+ * @version 1.0.0
+ * @name Demo
+ * @email momo.weiye@gmail.com
+ * @time 2018/7/12 10:18
+ * @describe
+ */
+public class Father {
+
+    protected String name = "Father";
+
+    @CallSuper
+    public void getMemberName(){
+        Log.d("realmo",Father.class.getSimpleName()+" member name:"+name);
+    }
+}

annotationdemo/src/main/java/com/realmo/annotation/callsuper/Son.java

@@ -0,0 +1,21 @@
+package com.realmo.annotation.callsuper;
+
+import android.util.Log;
+
+/**
+ * @author Realmo
+ * @version 1.0.0
+ * @name Demo
+ * @email momo.weiye@gmail.com
+ * @time 2018/7/12 10:18
+ * @describe
+ */
+public class Son extends Father {
+
+    private String name = "Son";
+    @Override
+    public void getMemberName() {
+        super.getMemberName(); //父类该方法加了CallSuper,需调用父类方法。否则，报警告
+        Log.d("realmo",Son.class.getSimpleName()+" member name:"+name);
+    }
+}

annotationdemo/src/main/java/com/realmo/annotation/checkresult/CheckResultAnnotation.java

@@ -0,0 +1,30 @@
+package com.realmo.annotation.checkresult;
+
+import android.support.annotation.CheckResult;
+
+/**
+ * @author Realmo
+ * @version 1.0.0
+ * @name Demo
+ * @email momo.weiye@gmail.com
+ * @time 2018/7/12 10:28
+ * @describe
+ */
+public class CheckResultAnnotation {
+
+
+    /**
+     * Denotes that the annotated method returns a result that it typically is
+     * an error to ignore. This is usually used for methods that have no side effect,
+     * so calling it without actually looking at the result usually means the developer
+     * has misunderstood what the method does.
+     * <p>
+     * Example:
+     * <pre>{@code
+     *  public @CheckResult String trim(String s) { return s.trim(); }
+     *  ...
+     *  s.trim(); // this is probably an error
+     *  s = s.trim(); // ok
+     * }</pre>
+     */
+}