RoboGuice या "Android इंजेक्शनों पर अड़ गया"

RoboGuice एक पुस्तकालय है जो आपको Android पर एप्लिकेशन विकसित करते समय Contexts और Dependency Injection का पूरा लाभ उठाने की अनुमति देता है।
जैसा कि आप अनुमान लगा सकते हैं, RoboGuice Google Guice पर आधारित है।
मुझे तुरंत कहना होगा कि "इंजेक्शन" शब्द के अनुवाद के रूप में मैं "इंजेक्शन" शब्द का उपयोग करूंगा।

इंजेक्शन क्यों?

मुझे लगता है कि कई पाठकों को तुरंत एक सवाल होगा: “मोबाइल प्लेटफ़ॉर्म पर सीडीआई के साथ ये कठिनाइयाँ क्यों हैं? निश्चित रूप से यह सब बहुत जगह लेता है और धीरे-धीरे काम करता है। ”
मैं विपरीत के ऐसे पाठकों को समझाने की कोशिश करूंगा, अर्थात् मोबाइल प्लेटफॉर्म पर सीडीआई बहुत व्यवहार्य है और डेवलपर्स के जीवन को बहुत सरल करता है।

गीतात्मक विषयांतर

एक्सएमएल के उत्साह और व्यापक उपयोग के युग के बाद, sobering तब आया जब हर कोई XML फ़ाइलों के "फुटबैग" से थक गया था। नए दृष्टिकोणों के लिए खोज शुरू हुई, जो कॉन्फ़िगरेशन कोड की मात्रा को कम करेगा और विकास को गति देगा। ऐसा ही एक आउटपुट एनोटेशन आधारित सीडीआई था। दूसरे को कन्वेंशन दृष्टिकोण द्वारा कॉन्फ़िगरेशन या कोडिंग पर कन्वेंशन कहा जा सकता है। डेवलपर्स ने इसे पसंद किया, विचारों का विकास हुआ, कई सीडीआई कार्यान्वयन दिखाई दिए, कई बड़े पुस्तकालयों ने सीडीआई का उपयोग एनोटेशन के माध्यम से करना शुरू कर दिया।
परिणामस्वरूप, JSI को JSR-330 , साथ ही साथ ( JSR-299 ) के रूप में जावा के लिए मानकीकृत किया गया, आधिकारिक तौर पर Java EE 6 में शामिल किया गया।
निजी तौर पर, मैंने पहली बार सीम लाइब्रेरी में सीडीआई देखा। और वह दृष्टिकोण की सादगी और लालित्य से सुखद आश्चर्यचकित था। विकास के समय की बचत, कॉन्फ़िगरेशन को सरल बनाना, कुल मात्रा को कम करना और, तदनुसार, संभावित त्रुटियां।
समय के साथ, एनोटेशन लगभग हर जगह घुस गए। XML उन्माद के बाद, एनोटेशन का युग आ गया है। और यह बहुत अजीब होगा अगर वे एंड्रॉइड पर नहीं पहुंचे।

तो यह एक मोबाइल प्लेटफॉर्म पर क्यों है?

उत्तर सरल है: विकास को तेज और आसान बनाने के लिए, और कोड क्लीनर और अधिक विश्वसनीय है।
निराधार नहीं होने के लिए, चलिए रोबोगुइज़ गेट स्टार्टेड से एक उदाहरण लेते हैं।
यह वही है जो एक नियमित गतिविधि वर्ग दिखता है:

class AndroidWay extends Activity { TextView name; ImageView thumbnail; LocationManager loc; Drawable icon; String myName; public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); name = (TextView) findViewById(R.id.name); thumbnail = (ImageView) findViewById(R.id.thumbnail); loc = (LocationManager) getSystemService(Activity.LOCATION_SERVICE); icon = getResources().getDrawable(R.drawable.icon); myName = getString(R.string.app_name); name.setText( "Hello, " + myName ); } } 

यहाँ 19 लाइनें हैं। onCreate() विधि में कोड की 5 पंक्तियाँ वर्ग फ़ील्ड का एक प्रारंभिक आरंभ है, और केवल एक अंतिम पंक्ति, शब्दार्थ भार वहन करती है: name.setText ()। गतिविधि कक्षाओं के अधिक जटिल कार्यान्वयन में ऑब्जेक्ट्स को इनिशियलाइज़ करने के लिए और भी अधिक कोड हो सकते हैं।
अब RoboGuice क्या अनुमति देता है के साथ तुलना करें:

 class RoboWay extends RoboActivity { @InjectView(R.id.name) TextView name; @InjectView(R.id.thumbnail) ImageView thumbnail; @InjectResource(R.drawable.icon) Drawable icon; @InjectResource(R.string.app_name) String myName; @Inject LocationManager loc; public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); name.setText( "Hello, " + myName ); } } 

अब onCreate() लिए अधिक संक्षिप्त और आसान है; न्यूनतम टेम्प्लेट कोड, एप्लिकेशन लॉजिक के बारे में अधिकतम कोड।

पहला इंजेक्शन

"पहला इंजेक्शन" को और अधिक व्यवहार्य बनाने के लिए, मैं developer.android.com से इंजेक्शन पर एक अच्छा परिचित उदाहरण इंजेक्ट करूँगा: नोटपैड ट्यूटोरियल । यह अलमारियों पर पूरी तरह से सॉर्ट किया गया है, इसके स्रोत कोड उपलब्ध हैं और यह सीडीआई के विचारों को संशोधित करने और लागू करने के लिए पर्याप्त होगा।
एक परियोजना में रोबोग्यूइस का उपयोग शुरू करने के लिए, आपको क्लासपैथ में दो पुस्तकालयों को जोड़ने की जरूरत है: रोबोग्यूइस और गार्ड-2.0-no_aop.jar (लेकिन गार्ड-3.0 नहीं)।
इसे मावेन में एक निर्भरता के रूप में भी जोड़ा जा सकता है (हाँ, एंडोर्ड परियोजना और मावेन काफी संगत हैं, लेकिन यह एक अलग लेख के लिए एक विषय है):

 <dependency> <groupId>org.roboguice</groupId> <artifactId>roboguice</artifactId> <version>1.1</version> </dependency> 

फिर आपको एक वर्ग बनाने की जरूरत है जो RoboApplication से विरासत में RoboApplication :

 public class NotepadApplication extends RoboApplication { } 

और इसे AndroidManifest.xml में पंजीकृत करें:

 <application android:name="com.android.demo.notepad3.NotepadApplication"> 

अब थोड़ा NoteEdit क्लास को फिर से NoteEdit । NotesDbAdapter से विरासत में मिला संसाधन इंजेक्शन और NotesDbAdapter जोड़ें।
यह था:

 public class NoteEdit extends RoboActivity { private NotesDbAdapter mDbHelper; private EditText mTitleText; private EditText mBodyText; private Long mRowId; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.note_edit); setTitle(R.string.edit_note); mDbHelper = new NotesDbAdapter(this); mDbHelper.open(); mTitleText = (EditText) findViewById(R.id.title); mBodyText = (EditText) findViewById(R.id.body); Button confirmButton = (Button) findViewById(R.id.confirm); ... } ... } 

यह बन गया:

 public class NoteEdit extends RoboActivity { @Inject NotesDbAdapter mDbHelper; @InjectView(R.id.title) EditText mTitleText; @InjectView(R.id.title) EditText mBodyText; @InjectView(R.id.confirm) Button confirmButton; @InjectResource(R.string.edit_note) String title; private Long mRowId; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.note_edit); setTitle(title); mDbHelper.open(); ... } ... } 

हम Notepadv3 भी Notepadv3 संशोधित Notepadv3 । RoboListActivity से RoboListActivity में RoboListActivity , RoboListActivity के लिए एक इंजेक्शन जोड़ें और NotesDbAdapter onCreate() से इस NotesDbAdapter के आरंभ को हटा दें।

 public class Notepadv3 extends RoboListActivity { ... @Inject private NotesDbAdapter mDbHelper; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.notes_list); mDbHelper.open(); fillData(); registerForContextMenu(getListView()); } ... } 

और हम NotesDbAdapter कंस्ट्रक्टर को अपडेट करते हैं NotesDbAdapter Context RoboGuice के साथ स्वचालित रूप Context प्रतिस्थापित हो।

  @Inject public NotesDbAdapter(Context ctx) { this.mCtx = ctx; } 

भागो, जांचें - यह काम करता है!
कोड कम हो गया, कार्यक्षमता बनी रही, पठनीयता बढ़ी।
यह ध्यान देने योग्य है कि RoboGuice न केवल Context वर्ग का इंजेक्शन बना सकता है, बल्कि कई अन्य एंड्रॉइड सेवाओं का भी समावेश करता है, जिसमें शामिल हैं Application , Activity और विभिन्न सेवाएं। पूरी सूची यहां उपलब्ध है ।

खुराक बढ़ाएँ

RoboGuice की क्षमताओं को प्रदर्शित करने के लिए, हम NotesDbAdapter क्लास को NotesDbAdapter करेंगे। मेरी राय में, यह बहुत अधिक NotesDbAdapter है और खुद NotesDbAdapter और NotesDbAdapter अपघटन की आवश्यकता है। जैसे-जैसे प्रोजेक्ट बढ़ता है, DatabaseHelper निश्चित रूप से कई वर्गों द्वारा उपयोग किया जाएगा। उदाहरण के लिए, TasksDbAdapter दिखाई देता है। खासकर जब से मैं व्यक्तिगत रूप से mDbHelper.open(); लिए मजबूर कॉल पसंद नहीं करता हूं mDbHelper.open(); । इस विधि को दो स्थानों पर बुलाया जाना चाहिए। महान प्रलोभन इस कॉल करने के लिए भूल जाओ और एक गलती पाने के लिए। तो चलिए शुरू करते हैं।
चलिए NotesDbAdapter साथ शुरू करते हैं। यहाँ अतिरिक्त क्षेत्रों का एक समूह है:

• Context mCtx , जिसका उपयोग केवल DatabaseHelper को इनिशियलाइज़ करने के लिए किया जाता है
• DatabaseHelper mDbHelper अपने आप में DatabaseHelper mDbHelper , क्योंकि केवल SQLiteDatabase mDb वास्तव में उपयोग किया जाता है
• स्थैतिक क्षेत्र: DATABASE_CREATE, DATABASE_VERSION, DATABASE_NAME , जिनका DATABASE_CREATE, DATABASE_VERSION, DATABASE_NAME से / से नोट्स सहेजने और प्राप्त करने के तर्क से बहुत कम लेना-देना है।

वास्तव में, मैं केवल SQLiteDatabase mDb छोड़ना SQLiteDatabase mDb । बाकी को हटा दें। NotesDbAdapter सिंगलटन NotesDbAdapter ।
कुल हम निम्नलिखित लक्ष्य है:

 @Singleton public class NotesDbAdapter { public static final String KEY_TITLE = "title"; public static final String KEY_BODY = "body"; public static final String KEY_ROWID = "_id"; private static final String TAG = "NotesDbAdapter"; private static final String DATABASE_TABLE = "notes"; @Inject private SQLiteDatabase mDb; public NotesDbAdapter() { } ... } 

KEY_TITLE, KEY_BODY, KEY_ROWID, DATABASE_TABLE, TAG शेष हैं, क्योंकि वे NotesDbAdapter लिए सबसे अधिक प्रासंगिक हैं।
नई कक्षा में कोई open() पद्धति नहीं है। आइए इस विधि के तर्क को डेटाबेसहेल्पर में स्थानांतरित करें।
अब हमें SQLiteDatabase mDb प्राप्त करने की आवश्यकता SQLiteDatabase mDb । जाहिर है, DatabaseHelper को यह करना चाहिए। उसे ऐसा करने का तरीका सिखाने के लिए, हम com.google.inject.Provider इंटरफ़ेस को लागू करते हैं, जो कि get() विधि का उपयोग करके किसी विशेष निर्मित वस्तु को लौटाता है।
इसके अलावा, हम कंस्ट्रक्टर में एप्लिकेशन संदर्भ इंजेक्ट करते हैं।
परिणामस्वरूप, DatabaseHelper क्लास इस तरह दिखेगा:

 @Singleton public class DatabaseHelper extends SQLiteOpenHelper implements Provider<SQLiteDatabase>{ private static final String TAG = "DatabaseHelper"; private static final String DATABASE_CREATE = "create table notes (_id integer primary key autoincrement, " + "title text not null, body text not null);"; private static final String DATABASE_NAME = "data"; private static final int DATABASE_VERSION = 2; private SQLiteDatabase mDb; @Inject public DatabaseHelper(Context context) { super(context, DATABASE_NAME, null, DATABASE_VERSION); } public SQLiteDatabase get() { if (mDb == null || !mDb.isOpen()) { mDb = getWritableDatabase(); } return mDb; } @Override public void onCreate(SQLiteDatabase db) { db.execSQL(DATABASE_CREATE); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { ... } } 

अब RoboGuice को बताते हैं कि SQLiteDatasia वर्ग प्रदाता वर्ग DatabaseHelper हेल्पर द्वारा प्रदान किया जाता है। ऐसा करने के लिए, एक कॉन्फ़िगरेशन क्लास बनाएं, तथाकथित मॉड्यूल, और इसे सिस्टम में पंजीकृत करें ( NotepadApplication )

 public class NotepadModule extends AbstractAndroidModule { @Override protected void configure() { bind(SQLiteDatabase.class).toProvider(DatabaseHelper.class); } } 

 public class NotepadApplication extends RoboApplication { @Override protected void addApplicationModules(List<Module> modules) { modules.add(new NotepadModule()); } } 

भागो, कोशिश करो - यह काम करता है!

NotepadModule.configure() अन्य प्रकार के बाइंड करने के लिए NotepadModule.configure() विधि का विस्तार कर सकते हैं, उदाहरण के लिए, विशिष्ट इंटरफ़ेस विवरण प्रतिस्थापित कर रहे हैं:

  protected void configure() { bind(SQLiteDatabase.class).toProvider(DatabaseHelper.class); bind(FilterDao.class).to(FilterDaoHttp.class); bind(ItemDao.class).annotatedWith(Http.class).to(ItemDaoHttp.class); } 

दूसरे शब्दों में, Google Guice के सभी प्रकार के बाइंडिंग उपलब्ध हैं ।

यह कुछ शब्दों और परीक्षणों को जोड़ने के लायक है। RoboGuice में यूनिट परीक्षण की सुविधा और गति प्रदान करने के लिए कई वर्ग हैं। RoboUnitTestCase उन कक्षाओं के लिए परीक्षण प्रदान करता है जो एंड्रॉइड पारिस्थितिकी तंत्र पर निर्भर नहीं हैं। RoboActivityUnitTestCase गतिविधियों के लिए यूनिट परीक्षण चलाने की अनुमति देता है। भविष्य में, मैं अलग-अलग दृष्टिकोणों और पुस्तकालयों की तुलना के साथ एंड्रॉइड के तहत परीक्षण के बारे में एक अलग लेख लिखना चाहूंगा। एंड्रॉइड के तहत परीक्षण करना उतना आसान नहीं है जितना कि हैबर के विकास के कारण।

अंतिम निदान

इसलिए, हम इंजेक्शन के लाभों के बारे में अंतिम निदान करेंगे:
+ वस्तुओं को आरंभ करने और जीवन चक्र के प्रबंधन के लिए जिम्मेदार कोड को कम करना
+ अधिक व्यापार तर्क कोड
+ वस्तुओं की संयोजकता को कम करना
+ निर्भरता कॉन्फ़िगरेशन और ऑब्जेक्ट आरंभीकरण के लिए न्यूनतम स्थान
+ सिस्टम ऑब्जेक्ट्स और रिसोर्सेज के उपयोग और प्रतिस्थापन में आसानी (कॉन्टेक्स्ट, अप्लायसेशन, शेयर्डप्रीफेरेंस, रिसोर्सेज, आदि)
+ परिणामस्वरूप, विकास में तेजी लाने और त्रुटियों को कम करना

- एक अतिरिक्त पुस्तकालय अनुप्रयोग के आकार को बढ़ाता है।
विवादास्पद माइनस। guice-2.0-no_aop.jar और roboguice-1.1.1.jar का आकार लगभग 545 Kb है, जो सरल अनुप्रयोगों के लिए काफी है, लेकिन बड़े और जटिल लोगों के लिए काफी स्वीकार्य है।
- उत्पादकता में कमी
साथ ही एक मूट प्वाइंट। निस्संदेह, इंजेक्शन में कुछ समय लगता है। हालांकि, इस पर बिताया गया समय छोटा है और मुख्य रूप से उस समय लॉन्च किया जाता है जब आवेदन लॉन्च किया जाता है। यदि आप लूप और एनिमेशन में इंजेक्शन का उपयोग नहीं करते हैं, तो उपयोगकर्ता एक प्रदर्शन परिवर्तन को नोटिस नहीं करेगा। इसके अलावा, स्मार्टफोन और DalvikVM का प्रदर्शन लगातार बढ़ रहा है।

मेरा व्यक्तिगत निदान: रोबोग्यूइस का उपयोग उनकी परियोजनाओं में किया जाना चाहिए। पेशेवरों निश्चित रूप से विपक्ष पल्ला झुकना।