(Tutorial Android) Simplify Code With Androidannotations


AndroidAnnotations ialah sebuah framework open source yang diklaim bisa mempercepat pengembangan aplikasi Android. Selain itu juga menulis code menjadi lebih mudah dan ringkas (less code) dan gampang untuk di-maintenance. AndroidAnnotations ini memakai annotations yang berfungsi menggantikan boilerplate code yang umum pada project Android.

Lalu, apa itu Annotation? Annotation ialah sebuah meta tag yang memperlihatkan info ihwal code aktivitas tetapi tidak berpenngaruh secara pribadi pada code dan bukan bab dari code aktivitas itu sendiri.

Beberapa fitur yang dimiliki oleh AndroidAnnotations :

- Dependency Injection : kita sanggup menginjeksi pada kelas yang membutuhkan ibarat inject views, extras, system services, resource dan lain-lain.
- Simplified threading model : annotation sanggup dipakai untuk menjalankan method di UI thread maupun background thread.
- Event binding : Event handling memakai annotation.
- REST Client : Request ke REST cukup dengan menciptakan client interface.
- AndroidAnnotations akan mengenerate subsclasses pada dikala compile.
- Size kurang dari 150kb !

Daftar annotation yang tersedia bisa dilihat di https://github.com/excilys/androidannotations/wiki/AvailableAnnotations 

Pada tutorial kali ini aku akan coba membuatkan info sedikit ihwal AndroidAnnotations.

Configuration

Langkah pertama ialah melaksanakan konfigurasi AndroidAnnotations dan library-library yang kita perlukan di gradle.

Top-level 
dependencies {     ...     classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' }
Module-level 
apply plugin: 'com.android.application' apply plugin: 'android-apt' def AAVersion = '4.1.0' def AppVersion = '23.3.0'  android {     compileSdkVersion 23     buildToolsVersion "23.0.3"      defaultConfig {         applicationId "com.wimso.android_aa"         minSdkVersion 15         targetSdkVersion 23         versionCode 1         versionName "1.0"     }     buildTypes {         release {             minifyEnabled false             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'         }     } }  repositories {     mavenCentral()     mavenLocal()     maven {         url 'https://repo.spring.io/libs-milestone'     } } android {     packagingOptions {         exclude 'META-INF/notice.txt'         exclude 'META-INF/license.txt'     } }  apt {     arguments {         androidManifestFile variant.outputs[0]?.processResources?.manifestFile         // if you have multiple outputs (when using splits), you may want to have other index than 0         // you should set your package name here if you are using different application IDs         // resourcePackageName "your.package.name"         // You can set optional annotation processing options here, like these commented options:         // logLevel 'INFO'         // logFile '/var/log/aa.log'     } }  dependencies {     compile fileTree(dir: 'libs', include: ['*.jar'])     testCompile 'junit:junit:4.12'     compile "com.android.support:appcompat-v7:$AppVersion"     compile "com.android.support:design:$AppVersion"     compile "com.android.support:cardview-v7:$AppVersion"      apt "org.androidannotations:androidannotations:$AAVersion"     compile "org.androidannotations:androidannotations-api:$AAVersion"      apt "org.androidannotations:rest-spring:$AAVersion"     compile "org.androidannotations:rest-spring-api:$AAVersion"      compile 'org.springframework.android:spring-android-rest-template:2.0.0.M3'     compile 'com.google.code.gson:gson:2.7' }

Creating Layout

Disini tidak ada yang berbeda ketika menciptakan layout, sama ibarat menciptakan layout di Android pada umumnya. Buat sebuah layout dengan nama activity_main.xml. Tambahkan beberapa komponen ibarat TextView, EditText dan Button.
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"     xmlns:tools="http://schemas.android.com/tools"     android:layout_width="match_parent"     android:layout_height="match_parent"     android:orientation="vertical"     android:paddingBottom="@dimen/activity_vertical_margin"     android:paddingLeft="@dimen/activity_horizontal_margin"     android:paddingRight="@dimen/activity_horizontal_margin"     android:paddingTop="@dimen/activity_vertical_margin"     tools:context="com.wimso.android_aa.MainActivity">      <LinearLayout         android:layout_width="match_parent"         android:layout_height="wrap_content"         android:orientation="horizontal">          <EditText             android:id="@+id/post_text"             android:layout_width="wrap_content"             android:layout_height="wrap_content"             android:layout_weight="1"             android:hint="Post ID undefined1 - 100)"/>          <Button             android:id="@+id/btn_post"             android:layout_width="wrap_content"             android:layout_height="wrap_content"             android:text="SHOW POST"/>      </LinearLayout>      <LinearLayout         android:layout_width="match_parent"         android:layout_height="wrap_content"         android:layout_marginTop="@dimen/activity_vertical_margin"         android:orientation="vertical">          <TextView             android:id="@+id/post_title"             android:layout_width="wrap_content"             android:layout_height="wrap_content"             android:textAppearance="?android:attr/textAppearanceMedium"/>          <TextView             android:id="@+id/post_body"             android:layout_width="wrap_content"             android:layout_height="wrap_content"             android:layout_marginTop="5dp"             android:textAppearance="?android:attr/textAppearanceSmall"/>      </LinearLayout>   </LinearLayout>

Enhanced Activity and Injecting Views

Mendefinisikan layout pada Activity biasanya dengan cara memanggil method setContentView() yang ada di dalam method onCreate(). Nah, kalau di AndroidAnnotations cara mendefinisikannya sanggup diringkas dengan memakai annotation @EActivity.

@EActivity : annotation yang memperlihatkan bahwa suatu activity akan di enhanced oleh AndroidAnnotations.

Memanggil komponen tidak memakai findViewById ibarat pada umumnya. Tapi dengan menginjeksi view memakai annotation @ViewById.

@ViewById : annotation yang memperlihatkan injeksi dari component view pada layout.
 *Perlu diperhatikan bahwa ketika field disisipi annotation @ViewById ini field masih kosong dan field dihentikan private.

Ketika onCreate() dipanggil, maka field @ViewById bekerjsama masih kosong, jadi kita sanggup mengeset valuenya pada method yang ditambahin annotation @AfterViews.

@AfterViews : annotation yang memperlihatkan bahwa method harus dipanggil sehabis views binding. *yak, kurang lebih begitu :v

Tapi intinya, kita sanggup mengeset value sebuah field dari @ViewById dengan cara memanggil annotation @AfterViews.

Berikut misalnya pada MainActivity : 
@EActivity(R.layout.activity_main) public class MainActivity extends AppCompatActivity {      @ViewById(R.id.post_text) EditText postText;     @ViewById(R.id.post_title) TextView postTitle;     @ViewById(R.id.post_body) TextView postBody;     @RestService ApiService apiService;      private ProgressDialog progressDialog;      @AfterViews     public void bindViews() {         // Default Text         postText.setText("1");         progressDialog = new ProgressDialog(this);         progressDialog.setMessage("Loading...");         progressDialog.setCancelable(true);     }      }

Event Binding

AndroidAnnotations menyediakan annotation untuk menhandel event listener. Contohnya untuk menhandel event click memakai annotation @Click.

@Click : annotation yang memperlihatkan method di activity bisa memanggil event click pada view.

Contohnya penggunaannya : 
@Click(R.id.btn_post) void getPostClicked() {     // do something }

REST Client

Untuk melaksanakan request ke REST API yakni dengan menciptakan client interface. REST API sanggup bekerja dengan annotation @Rest. Pada kasus ini kita memakai REST Client Spring Android  yang terintegrasi dengan AndroidAnnotations.

Contohnya : 
@Rest(rootUrl = "https://jsonplaceholder.typicode.com", converters = { GsonHttpMessageConverter.class }) public interface ApiService {      @Get("/posts/{id}")     Post getPost(@Path String id);  }
rootUrl merupakan base url nya, sedangkan converters wajib di definisikan. Converters ini berfungsi menconvert hasil respon yang di sanggup yang lalu sanggup di mapping. Pada pola di atas kita memakai converter dari GSON.

Request ke REST API sanggup berupa GET atau POST, gunakan @Get atau @Post untuk mendefinisikan sebuah request GET atau POST.

Background Task

Annotation @Background dan @UiThread sanggup dipakai untuk menjalankan Background Task. Annotation @Background bekerja sama halnya ibarat AsyncTask. Sedangkan @UiThread berjalan secara background untuk menangani jikalau ada perubahan pada UI.

@Background : annotation yang memperlihatkan sebuah method berjalan di thread selain ui thread.
@UiThread : annotation yang memperlihatkan sebuah method berjalan di thread ui.

Contoh penggunaan annotation @Background yaitu untuk melaksanakan proses request data ke REST API. Kemudian respon yang diterima di jalankan di @UiThread sehingga UI ter-update.
@Background void requestPost(String id) {     Post post = apiService.getPost(id);     updateViews(post); }  @UiThread void updateViews(Post post) {     progressDialog.dismiss();      if(post == null) {         Toast.makeText(this, "Cannot load data", Toast.LENGTH_SHORT).show();         return;     }      postTitle.setText(post.getTitle());     postBody.setText(post.getBody()); }
Nah sehabis aku menjelaskan panjang lebar di atas, mari kita ke tahap implementasi selanjutnya.

Buat kelas POJOS sebagai berikut. 
package com.wimso.android_aa.model;  /**  * Created by Wim on 9/21/16.  */ public class Post {      private int userId;     private int id;     private String title;     private String body;      public int getUserId() {         return userId;     }      public void setUserId(int userId) {         this.userId = userId;     }      public int getId() {         return id;     }      public void setId(int id) {         this.id = id;     }      public String getTitle() {         return title;     }      public void setTitle(String title) {         this.title = title;     }      public String getBody() {         return body;     }      public void setBody(String body) {         this.body = body;     } }
Lengkapi source code MainActivity berikut : 
package com.wimso.android_aa;  import android.app.ProgressDialog; import android.support.v7.app.AppCompatActivity; import android.text.TextUtils; import android.widget.EditText; import android.widget.TextView; import android.widget.Toast;  import com.wimso.android_aa.model.Post; import com.wimso.android_aa.network.ApiService;  import org.androidannotations.annotations.AfterViews; import org.androidannotations.annotations.Background; import org.androidannotations.annotations.Click; import org.androidannotations.annotations.EActivity; import org.androidannotations.annotations.UiThread; import org.androidannotations.annotations.ViewById; import org.androidannotations.rest.spring.annotations.RestService;  @EActivity(R.layout.activity_main) public class MainActivity extends AppCompatActivity {      @ViewById(R.id.post_text) EditText postText;     @ViewById(R.id.post_title) TextView postTitle;     @ViewById(R.id.post_body) TextView postBody;      @RestService ApiService apiService;      private ProgressDialog progressDialog;      @AfterViews     public void bindViews() {         // Default Text         postText.setText("1");          progressDialog = new ProgressDialog(this);         progressDialog.setMessage("Loading...");         progressDialog.setCancelable(true);     }      @Click(R.id.btn_post)     void getPostClicked() {         progressDialog.show();          if(!TextUtils.isEmpty(postText.getText())) {             requestPost(postText.getText().toString());         }     }      @Background     void requestPost(String id) {         Post post = apiService.getPost(id);         updateViews(post);     }      @UiThread     void updateViews(Post post) {         progressDialog.dismiss();          if(post == null) {             Toast.makeText(this, "Cannot load data", Toast.LENGTH_SHORT).show();             return;         }          postTitle.setText(post.getTitle());         postBody.setText(post.getBody());     }  }
Setelah itu, Build → Make Project. Maka Android Studio akan men-generate kelas MainActivity menjadi subclass dengan nama MainActivity_. Setiap subclass mempunyai nama yang sama dengan embel-embel sufix _ (undescore).

Langkah terakhir ialah register MainActivity di AndroidManifest.xml. Activity yang diregister ialah subclassnya yang terdapat suffix _ (undescore). 
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android"     package="com.wimso.android_aa">      <uses-permission android:name="android.permission.INTERNET"/>      <application         android:allowBackup="true"         android:icon="@mipmap/ic_launcher"         android:label="@string/app_name"         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>
Selesai, build dan jalankan maka alhasil sebagai berikut :


Source code lengkap sanggup dilihat di https://github.com/andronut/Android-AA

Sekian tutorial kali ini. Terima kasih sudah menyimak.
Semoga bermanfaat. :)

Comments

Post a Comment

Popular posts from this blog

Pewarnaan Objek Geometri Di Java 2D

Image
Pewarnaan (filling) sanggup diterapkan ke dalam pembuatan objek geometri. Objek geometri sanggup digambar dengan method fill atau draw . Untuk menambahkan warna pada objek geometri, kita sanggup menambahkan method dari kelas Graphics. void setColor(Color c)  Objek Color didefinisikan sebagai sebuah warna. Kelas Color secara default memakai rentan warna RGB. Berikut ini yaitu pola penggunaan Color di Java 2D. /** * * @author Wim Sonevel */ import java.awt.*; import java.awt.geom.*; import javax.swing.*; public class SegiPanjangWarna extends JApplet { public static void main(String[] args) { JFrame frame = new JFrame(); frame.setTitle("Persegi Panjang Warna"); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); JApplet applet = new SegiPanjangWarna(); applet.init(); frame.getContentPane().add(applet); frame.pack(); frame.setVisible(true); } @Override public void init() { JPan...
Read more

Tugas Komplemen Terakhir

(Ainun Najib) 1. Buat sebuah aplikasi berbasis GUI untuk registrasi siswa gres : - hitung nilai tes untuk mata pelajaran tertentu dan jikalau rata-rata <  70 maka gagal - inputkan data-data siswa dan simpan dalam database - tampilkan data dalam bentuk tabel - data sanggup disimpan, diedit, dihapus dan dicari (Moh. Fachrudin) 2. Buat sebuah aplikasi berbasis GUI untuk registrasi musyrif gres : - hitung nilai tes b.arab, b.ing, Afkar, dan Al-Quran dan jikalau rata - rata < 70 maka gagal - inputkan data-data siswa dan simpan dalam database - tampilkan data dalam bentuk tabel - data sanggup disimpan, diedit, dihapus dan dicari (Aulia) 3. Buat sebuah aplikasi berbasis GUI untuk menghitung nilai selesai suatu matakuliah dan berikan nilai huruf.    - Rumus nilai selesai = kiprah 20% + uts 30% + uas 50 %    - Berikan nilai karakter :       46-55 Nilai C         56-65 Nilai C+  ...
Read more

Konsep Oop Encapsulation

Image
Encapsulation biasa disebut dengan Information Hidding. Encapsulation merupakan kombinasi dari data dan method pada paket suatu kelas dan menyembunyikan implementasi detail dari user terhadap object. Hak jalan masuk diatur dalam sebuah access modifier yang diantaranya yakni : - private : hanya sanggup diakses oleh kelas itu sendiri - protected : hanya sanggup diakses dalam package dan kelas turunannya - public : sanggup diakses dimanapun - default : hanya sanggup diakses dalam package saja Manfaat dari encapsulation : - Modularitas : Source code dari sebuah class sanggup dikelola secara independen dari source code class yang lain. Perubahan internal pada sebuah class tidak akan besar lengan berkuasa bagi class yang menggunakannya. - Information Hiding : Penyembunyian gosip yang tidak perlu diketahui objek lain. Untuk mengakses gosip sanggup memakai mediator method yang dikenal dengan setter dan getter. Sebagai contoh, buatlah 3 kelas masing-masing di package yang berbed...
Read more