Android खोज संवाद का उपयोग करना। सरल आवेदन उदाहरण

यह लेख उन लोगों के लिए है जो पहले से ही एंड्रॉइड के लिए अपना हैलोवर्ल्ड लिख चुके हैं और जानते हैं कि गतिविधि और आशय क्या है, साथ ही साथ वह स्थान जहां पर स्थित है और लेआउट की आवश्यकता क्यों है। अन्यथा, आप इस सामग्री को पढ़ सकते हैं, उदाहरण के लिए, developer.android.com पर।



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

सिद्धांत की बिट

Android खोज संवाद (इसके बाद "खोज संवाद" के रूप में संदर्भित) खोज ढांचे का उपयोग करके प्रबंधित किया जाता है। इसका मतलब है कि डेवलपर को यह सोचने की ज़रूरत नहीं है कि इसे कैसे आकर्षित किया जाए या किसी खोज क्वेरी को कैसे पकड़ा जाए। SearchManager आपके लिए काम करेगा।



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

• कॉन्फ़िगरेशन xml फ़ाइल (इसमें संवाद के बारे में जानकारी है)
• गतिविधि जो खोज क्वेरी प्राप्त करेगी, खोज और प्रदर्शन परिणाम दिखाएगी
• खोज डायलॉग को कॉल करने का तंत्र (चूंकि सभी एंड्रॉइड डिवाइस पर केस में खोज बटन नहीं है)

कॉन्फ़िगरेशन फ़ाइल

चलो एक कॉन्फ़िगरेशन फ़ाइल बनाकर शुरू करते हैं, क्योंकि यह सबसे आसान हिस्सा है। बेशक, आपको पहले से तैयार करने की जरूरत है, एक नई परियोजना बनाएं, गतिविधि (मैं गतिविधि "मुख्य" का उपयोग करता हूं और परियोजना का नाम "SearchExample" है)। कॉन्फ़िगरेशन के लिए आवश्यक सभी सामग्री निम्नलिखित के साथ अपनी परियोजना के रेस / xml / उपनिर्देशिका में एक searchable.xml फ़ाइल बनाने के लिए है।

<? xml version ="1.0" encoding ="utf-8" ? >

< searchable xmlns:android ="http://schemas.android.com/apk/res/android"

android:label ="@string/app_name"

android:hint ="@string/search_hint"

>

</ searchable >



* This source code was highlighted with Source Code Highlighter .

एकमात्र आवश्यक विशेषता एंड्रॉइड है: लेबल, और इसे एक स्ट्रिंग को संदर्भित करना होगा जो कि एप्लिकेशन के नाम के समान है। दूसरी विशेषता, एंड्रॉइड: संकेत, का उपयोग खाली संवाद में एक स्ट्रिंग प्रदर्शित करने के लिए किया जाता है। उदाहरण के लिए, यह "वीडियो खोज" या "संपर्क खोज" आदि हो सकता है। यह विशेषता इंगित करती है कि कौन सा डेटा खोजा जा रहा है। यह जानना भी महत्वपूर्ण है कि खोज योग्य तत्व कई अन्य विशेषताओं का समर्थन करता है, अधिक विवरण यहां पाया जा सकता है ।

एक गतिविधि बनाएँ

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



हम गतिविधि इंटरफ़ेस का वर्णन निम्नानुसार करते हैं (फ़ाइल रेस / लेआउट / main.xml में स्थित है)।

<? 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" >

< LinearLayout

android:orientation ="horizontal"

android:layout_width ="fill_parent"

android:layout_height ="wrap_content"

android:gravity ="top" >

< EditText

android:id ="@+id/text"

android:layout_width ="wrap_content"

android:layout_height ="wrap_content"

android:hint ="@string/text"

android:layout_weight ="100.0" />

< Button

android:id ="@+id/add"

android:layout_width ="wrap_content"

android:layout_height ="wrap_content"

android:text ="@string/add" />

</ LinearLayout >

< ListView

android:id ="@android:id/list"

android:layout_width ="fill_parent"

android:layout_height ="wrap_content" />

< TextView

android:layout_gravity ="left"

android:id ="@android:id/empty"

android:layout_width ="fill_parent"

android:layout_height ="fill_parent"

android:text ="@string/no_records" />

</ LinearLayout >



* This source code was highlighted with Source Code Highlighter .

यह इस तरह दिखता है:







हमें सूची आइटम की उपस्थिति के लिए भी लेआउट की आवश्यकता है, हम इसे सरलतम तरीके से वर्णन करेंगे (फ़ाइल res / लेआउट / record.xml में है)

<? xml version ="1.0" encoding ="utf-8" ? >

< TextView

android:id ="@+id/text1"

xmlns:android ="http://schemas.android.com/apk/res/android"

android:layout_width ="wrap_content"

android:layout_height ="wrap_content"

/>



* This source code was highlighted with Source Code Highlighter .

साथ ही, उस संसाधन फ़ाइल के बारे में भी न भूलें जहाँ हमारी लाइनें संग्रहीत हैं (रिस / मान / स्ट्रिंग्स.xml में फ़ाइल)

<? xml version ="1.0" encoding ="utf-8" ? >

< resources >

< string name ="app_name" > SearchExample </ string >

< string name ="add" > Add </ string >

< string name ="text" > Enter text </ string >

< string name ="no_records" > There are no records in the table </ string >

< string name ="search_hint" > Search the records </ string >

< string name ="search" > Search </ string >

</ resources >



* This source code was highlighted with Source Code Highlighter .

मैं आपको याद दिलाता हूं कि जब कोई उपयोगकर्ता किसी खोज को करता है, तो SearchManager के लिए यह आवश्यक है कि वह हमारी गतिविधि के लिए खोज अनुरोध के साथ एक इरादे भेजे। SearchManager को यह जानने के लिए कि उसके इरादे को कहाँ भेजा जाए, आपको इसे घोषणा में घोषित करने की आवश्यकता है। इसलिए, AndroidManifest.xml पर जाएं, और इसे बदल दें ताकि गतिविधि टाइप खोज के इरादों को स्वीकार कर सके। इसके अलावा, हम अपनी कॉन्फ़िगरेशन फ़ाइल searchable.xml को लागू करते हैं। तो, कुछ इस तरह दिखाई देगा:

<? xml version ="1.0" encoding ="utf-8" ? >

< manifest xmlns:android ="http://schemas.android.com/apk/res/android"

package ="com.example.search"

android:versionCode ="1"

android:versionName ="1.0" >

< application android:icon ="@drawable/icon" android:label ="@string/app_name" >

< activity android:name =".Main"

android:label ="@string/app_name" >

< intent-filter >

< action android:name ="android.intent.action.MAIN" />

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

</ intent-filter >

< intent-filter >

< action android:name ="android.intent.action.SEARCH" />

</ intent-filter >

< meta-data

android:name ="android.app.searchable"

android:resource ="@xml/searchable"

/>

</ activity >



</ application >

< uses-sdk android:minSdkVersion ="5" />



</ manifest >



* This source code was highlighted with Source Code Highlighter .

अब, आप पहले से ही जांच सकते हैं कि आपने सब कुछ सही ढंग से किया है या नहीं। आप एमुलेटर पर संवाद को कॉल कर सकते हैं, उदाहरण के लिए, खोज बटन पर क्लिक करके। ठीक है, या यदि आप डिवाइस पर जांच करते हैं, तो "मेनू" को दबाए रखें। यह कुछ इस तरह दिखना चाहिए:

कोई खोज करते समय

हमने अपनी गतिविधि की घोषणा करने और AndroidManifest.xml में आवश्यक परिवर्तन करने के बाद, हम स्वयं खोज पर विचार कर सकते हैं। इसमें तीन चरण शामिल हैं:

• अनुरोध प्राप्त करें
• डेटा खोज
• आउटपुट परिणाम

अनुरोध प्राप्त करें

चूंकि SearchManager हमारी गतिविधि के लिए एक प्रकार की खोज खोज भेजता है, गतिविधि शुरू होने पर आपको इस प्रकार के एक इरादे की जांच करनी होगी। फिर, यदि हमें वांछित आशय मिलता है, तो हम इसमें से एक्स्ट्रा निकाल सकते हैं और खोज कर सकते हैं।

डेटा खोज

चूंकि विभिन्न अनुप्रयोगों के लिए डेटा संग्रहण संरचना का प्रकार भिन्न हो सकता है, इसलिए उनके लिए तरीके अलग हैं। हमारे मामले में, SQLite डेटाबेस टेबल पर LIKE क्वेरी के साथ क्वेरी निष्पादित करना सबसे आसान है। बेशक, FTS3 का उपयोग करना बेहतर है, यह बहुत तेज है, आप SQLite.org पर FTS3 के बारे में अधिक पढ़ सकते हैं। आदर्श रूप से, आपको हमेशा यह विचार करना चाहिए कि खोज में लंबा समय लग सकता है, इसलिए आप किसी प्रकार का ProgressDialog बना सकते हैं, ताकि हमारा इंटरफ़ेस लटका न रहे और उपयोगकर्ता यह जान सके कि एप्लिकेशन काम कर रहा है।

आउटपुट परिणाम

सामान्य तौर पर, आउटपुट परिणाम एक यूआई समस्या होती है, लेकिन जब से हम लिस्ट व्यू का उपयोग करते हैं, हमारे लिए समस्या बस एडेप्टर को अपडेट करके हल की जाती है।

स्रोत कोड

अंत में, मैं टिप्पणियों के साथ दो वर्गों का पूर्ण स्रोत कोड देता हूं। पहला है Main, ListActivity का वंशज, इसका उपयोग डेटाबेस को पॉप्युलेट करने और परिणामों को आउटपुट करने के लिए किया जाता है। दूसरा वर्ग RecordDbHelper है, यह डेटाबेस के साथ बातचीत के लिए एक इंटरफ़ेस लागू करता है। सबसे महत्वपूर्ण तरीके रिकॉर्ड्स जोड़ रहे हैं और LIKE क्वेरी का उपयोग करके मैच ढूंढ रहे हैं।



Main.java फ़ाइल

package com.example.search;



import android.app.ListActivity;

import android.app.SearchManager;

import android.content.Intent;

import android.database.Cursor;

import android.os.Bundle;

import android.view.Menu;

import android.view.MenuInflater;

import android.view.MenuItem;

import android.view.View;

import android.widget.Button;

import android.widget.EditText;

import android.widget.SimpleCursorAdapter;



public class Main extends ListActivity {

private EditText text;

private Button add;

private RecordsDbHelper mDbHelper;



@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.main);

//

mDbHelper = new RecordsDbHelper( this );

//

mDbHelper.open();

// Intent

Intent intent = getIntent();

// Intent

if (Intent.ACTION_SEARCH.equals(intent.getAction())) {

//

String query = intent.getStringExtra(SearchManager.QUERY);

//

showResults(query);

}



add = (Button) findViewById(R.id.add);

text = (EditText) findViewById(R.id.text);

add.setOnClickListener( new View.OnClickListener() {

public void onClick(View view) {

String data = text.getText().toString();

if (!data.equals( "" )) {

saveTask(data);

text.setText( "" );

}

}

});

}



private void saveTask( String data) {

mDbHelper.createRecord(data);

}



private void showResults( String query) {

//

Cursor cursor = mDbHelper.fetchRecordsByQuery(query);

startManagingCursor(cursor);

String [] from = new String [] { RecordsDbHelper.KEY_DATA };

int [] to = new int [] { R.id.text1 };



SimpleCursorAdapter records = new SimpleCursorAdapter( this ,

R.layout.record, cursor, from , to);

//

setListAdapter(records);

}

// ( res/menu/main_menu.xml)

public boolean onCreateOptionsMenu(Menu menu) {

MenuInflater inflater = getMenuInflater();

inflater.inflate(R.menu.main_menu, menu);

return true ;

}



public boolean onOptionsItemSelected(MenuItem item) {

switch (item.getItemId()) {

case R.id.search_record:

onSearchRequested();

return true ;

default :

return super.onOptionsItemSelected(item);

}

}

}



* This source code was highlighted with Source Code Highlighter .

फ़ाइल रिकॉर्ड्सDHHperper.java

package com.example.search;



import android.content.ContentValues;

import android.content.Context;

import android.database.Cursor;

import android.database.SQLException;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteOpenHelper;

import android.util.Log;



public class RecordsDbHelper {



public static final String KEY_DATA = "data" ;

public static final String KEY_ROWID = "_id" ;



private static final String TAG = "RecordsDbHelper" ;

private DatabaseHelper mDbHelper;

private SQLiteDatabase mDb;



private static final String DATABASE_CREATE = "CREATE TABLE records(_id INTEGER PRIMARY KEY AUTOINCREMENT, "

+ "data TEXT NOT NULL);" ;



private static final String DATABASE_NAME = "data" ;

private static final String DATABASE_TABLE = "records" ;

private static final int DATABASE_VERSION = 1;



private final Context mCtx;



private static class DatabaseHelper extends SQLiteOpenHelper {



DatabaseHelper(Context context) {

super(context, DATABASE_NAME, null , DATABASE_VERSION);

}



@Override

public void onCreate(SQLiteDatabase db) {



db.execSQL(DATABASE_CREATE);

}



@Override

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

Log.w(TAG, "Upgrading database from version " + oldVersion + " to "

+ newVersion + ", which will destroy all old data" );

db.execSQL( "DROP TABLE IF EXISTS tasks" );

onCreate(db);

}

}



public RecordsDbHelper(Context ctx) {

this .mCtx = ctx;

}



public RecordsDbHelper open() throws SQLException {

mDbHelper = new DatabaseHelper(mCtx);

mDb = mDbHelper.getWritableDatabase();

return this ;

}



public void close() {

mDbHelper.close();

}



//

public long createRecord( String data) {

ContentValues initialValues = new ContentValues();

initialValues.put(KEY_DATA, data);

return mDb.insert(DATABASE_TABLE, null , initialValues);

}



// LIKE

public Cursor fetchRecordsByQuery( String query) {

return mDb.query( true , DATABASE_TABLE, new String [] { KEY_ROWID,

KEY_DATA }, KEY_DATA + " LIKE" + "'%" + query + "%'" , null ,

null , null , null , null );

}

}



* This source code was highlighted with Source Code Highlighter .

निष्कर्ष

लेख लिखने के लिए developer.android.com प्रलेखन का उपयोग करें।

पूरा प्रोजेक्ट code.google.com पर लिया जा सकता है।