androidannotations的使用——適合新手

最近新入職一家公司，公司的項目中使用了androidannotations，于是花了些時間查看github，然后整理出以下資料。

androidannotations是一個提升開發(fā)速度的開源框架，它可以節(jié)約出時間，讓你專注于真正重要的事情；同時，通過簡化你的代碼，也可以便于后期的維護。

首先，我們來看看AndroidAnnotations使用前和使用后的兩端代碼。

Before

public class BookmarksToClipboardActivity extends Activity {
  BookmarkAdapter adapter;
  ListView bookmarkList;
  EditText search;
  BookmarkApplication application;
  Animation fadeIn;
  ClipboardManager clipboardManager;
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    requestWindowFeature(Window.FEATURE_NO_TITLE);
    getWindow().setFlags(FLAG_FULLSCREEN, FLAG_FULLSCREEN);
    setContentView(R.layout.bookmarks); 
    bookmarkList = (ListView) findViewById(R.id.bookmarkList);
    search = (EditText) findViewById(R.id.search);
    application = (BookmarkApplication) getApplication();
    fadeIn = AnimationUtils.loadAnimation(this, anim.fade_in);
    clipboardManager = (ClipboardManager) getSystemService(CLIPBOARD_SERVICE);
 
    View updateBookmarksButton1 = findViewById(R.id.updateBookmarksButton1);
    updateBookmarksButton1.setOnClickListener(new OnClickListener() {
      @Override
      public void onClick(View v) {
        updateBookmarksClicked();
      }
    });
 
    View updateBookmarksButton2 = findViewById(R.id.updateBookmarksButton2);
    updateBookmarksButton2.setOnClickListener(new OnClickListener() {
 
      @Override
      public void onClick(View v) {
        updateBookmarksClicked();
      }
    });
 
    bookmarkList.setOnItemClickListener(new OnItemClickListener() {
      @Override
      public void onItemClick(AdapterView<?> p, View v, int pos, long id) {
        Bookmark selectedBookmark = (Bookmark) p.getAdapter().getItem(pos);
        bookmarkListItemClicked(selectedBookmark);
      }
    });
 
    initBookmarkList();
  }
 
  void initBookmarkList() {
    adapter = new BookmarkAdapter(this);
    bookmarkList.setAdapter(adapter);
  }
 
  void updateBookmarksClicked() {
    UpdateBookmarksTask task = new UpdateBookmarksTask();
 
    task.execute(search.getText().toString(), application.getUserId());
  }

  private static final String BOOKMARK_URL = //
  "http://www.bookmarks.com/bookmarks/{userId}?search={search}";
  class UpdateBookmarksTask extends AsyncTask<String, Void, Bookmarks> {
    @Override
    protected Bookmarks doInBackground(String... params) {
      String searchString = params[0];
      String userId = params[1];
 
      RestTemplate client = new RestTemplate();
      HashMap<String, Object> args = new HashMap<String, Object>();
      args.put("search", searchString);
      args.put("userId", userId);
      HttpHeaders httpHeaders = new HttpHeaders();
      HttpEntity<Bookmarks> request = new HttpEntity<Bookmarks>(httpHeaders);
      ResponseEntity<Bookmarks> response = client.exchange( //
          BOOKMARK_URL, HttpMethod.GET, request, Bookmarks.class, args);
      Bookmarks bookmarks = response.getBody();
 
      return bookmarks;
    }
 
    @Override
    protected void onPostExecute(Bookmarks result) {
      adapter.updateBookmarks(result);
      bookmarkList.startAnimation(fadeIn);
    }
    
  }
 
  void bookmarkListItemClicked(Bookmark selectedBookmark) {
    clipboardManager.setText(selectedBookmark.getUrl());
  }

}

After

@Fullscreen
@EActivity(R.layout.bookmarks)
@WindowFeature(Window.FEATURE_NO_TITLE)
public class BookmarksToClipboardActivity extends Activity {
  
  BookmarkAdapter adapter;
  
  @ViewById
  ListView bookmarkList;
 
  @ViewById
  EditText search;
  
  @App
  BookmarkApplication application;
  
  @RestService
  BookmarkClient restClient;
 
  @AnimationRes
  Animation fadeIn;
  
  @SystemService
  ClipboardManager clipboardManager;
 
  @AfterViews
  void initBookmarkList() {
    adapter = new BookmarkAdapter(this);
    bookmarkList.setAdapter(adapter);
  }
  
  @Click({R.id.updateBookmarksButton1, R.id.updateBookmarksButton2})
  void updateBookmarksClicked() {
    searchAsync(search.getText().toString(), application.getUserId());
  }
  
  @Background
  void searchAsync(String searchString, String userId) {
    Bookmarks bookmarks = restClient.getBookmarks(searchString, userId);
    updateBookmarks(bookmarks);
  }
 
  @UiThread
  void updateBookmarks(Bookmarks bookmarks) {
    adapter.updateBookmarks(bookmarks);
    bookmarkList.startAnimation(fadeIn);
  }
  
  @ItemClick
  void bookmarkListItemClicked(Bookmark selectedBookmark) {
    clipboardManager.setText(selectedBookmark.getUrl());
  }
 
}

@Rest("http://www.bookmarks.com")
public interface BookmarkClient {
  
  @Get("/bookmarks/{userId}?search={search}")
  Bookmarks getBookmarks(@Path String search, @Path String userId);
 
}

從上面的天后兩端代碼可以看出，使用androidannotations框架后，代碼明顯簡潔了很多，讓人一目了然。

看到上面的效果，相信你迫不及待地要了解androidannotations的用法了吧？下面我就介紹下androidannotations的簡單用法，談到開源框架的使用，首先當然要先配置，那么androidannotations是如何配置呢？

  • 首先，在項目下的build.gradle中添加以下配置
    buildscript {
        repositories {
          mavenCentral()
        }
        dependencies {
            // replace with the current version of the Android plugin
            classpath 'com.android.tools.build:gradle:2.3.0'
        }
    }
    
    repositories {
        mavenCentral()
        mavenLocal()
    }
  • 其次，在module下的build.gradle中添加以下配置
    def AAVersion = "4.3.0" 
    dependencies {
        annotationProcessor "org.androidannotations:androidannotations:$AAVersion"
        compile "org.androidannotations:androidannotations-api:$AAVersion"
    }

    android {
        compileSdkVersion 25
        buildToolsVersion "25.0.2"
        
        defaultConfig {
            minSdkVersion 9
            targetSdkVersion 25
        }
    }
    
其中，AAVersion定義了androidannotations最新版本號，在依賴中秩序應用這個變量即可，當然你也可以直接在依賴中填寫版本號。

基本配置我們已經弄好了，那么，接下來，我們就需要將androidannotations應用到我們的項目中

  • 首先，創(chuàng)建一個activity

     import android.app.Activity;
 import android.widget.EditText;
 import android.widget.TextView;
 
 import org.androidannotations.annotations.Click;
 import org.androidannotations.annotations.EActivity;
 import org.androidannotations.annotations.ViewById;
 
 @EActivity(R.layout.main)
 public class MyActivity extends Activity {
 
     @ViewById(R.id.myInput)
     EditText myInput;
        
     @ViewById(R.id.myTextView)
     TextView textView;
         
     @Click
     void myButton() {
          String name = myInput.getText().toString();
          textView.setText("Hello "+name);
     }
 }

  • 布局文件

     <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent"
     >
     <EditText  
         android:id="@+id/myInput"
         android:layout_width="fill_parent" 
         android:layout_height="wrap_content" 
         />
     <Button  
         android:id="@+id/myButton"
         android:layout_width="fill_parent" 
         android:layout_height="wrap_content" 
         android:text="Click me!"
         />        
     <TextView  
         android:id="@+id/myTextView"
         android:layout_width="fill_parent" 
         android:layout_height="wrap_content" 
         />    
 </LinearLayout>

  • AndroidMainfest.xml文件中聲明activity，但是activity不在是像以前直接寫類名，而是必須在類名后加上""后綴，因為，當我們編譯運行的時候，as會自動生成一個MainActivity的子類MainActivity，實際上工作的類也是這個類。（生成的類在as中是看不到的，可以在電腦上項目路徑下的build目錄中找到）

     <activity android:name=".MainActivity_">
     <intent-filter>
         <action android:name="android.intent.action.MAIN" />

         <category android:name="android.intent.category.LAUNCHER" />
     </intent-filter>
 </activity>

注：startActivity的時候，也不能直接用MainActivity，而應用該清單文件中聲明的也就是加上后綴名的Activity，也就是加上后綴名的Activity，在2.4以及以后的版本后，我們也可以使用以下代碼來實現跳轉activity

    // Starting the activity
    MyListActivity_.intent(context).start();
    
    // Building an intent from the activity
    Intent intent = MyListActivity_.intent(context).get();
    
    // You can provide flags
    MyListActivity_.intent(context).flags(FLAG_ACTIVITY_CLEAR_TOP).start();
    
    // You can even provide extras defined with @Extra in the activity
    MyListActivity_.intent(context).myDateExtra(someDate).start();

從上面的講解中，我們應該可以看出androidannotations的特點，歸納起來就是以下五點：

  • 依賴注入：可以注入view，service，activity，resource

     @EActivity
 public class MyActivity extends Activity {
   // ...
 }

  • 簡化線程模型：可以在方法上注釋為ui線程或者background線程

     void myMethod() {
     someBackgroundWork("hello", 42);
 }
 
 @Background
 void someBackgroundWork(String aParam, long anotherParam) {
     [...]
 }

  • 事件綁定：注釋方法來操作view的時間，而不在需要匿名listener類

     @Click（id=）   
 void myButton() {
     String name = myInput.getText().toString();
     textView.setText("Hello "+name);
 }

  • 輕松的客戶端：創(chuàng)建一個客戶端接口，androidannotations會生成實現類

  • 可見：在androidannotations生成子類的時候，你可以去產看代碼來觀察它是如何工作。

到這，我們大概了解了android的基本使用方法，當然這只是最初步的使用，想要了解更多androidannotations的使用方法，請點擊下面鏈接：
androidannotations的更多使用方法
項目地址

最后編輯于 ：
?著作權歸作者所有,轉載或內容合作請聯系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成，瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發(fā)布，文章內容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容