Android खोज संवाद का उपयोग करना। भाग 2 - हाल की क्वेरी सुझाव

पहले भाग में महारत हासिल करने वालों को पढ़ने के लिए लेख की सिफारिश की जाती है। लेख बताता है कि अपने आवेदन को कैसे संशोधित किया जाए ताकि हाल की खोजों के लिए सुझावों को संवाद में जोड़ा जाए। कोड और सिद्धांत (पहले भाग में आवश्यक एक के अलावा) को समझने के लिए, सामग्री प्रदाताओं के ज्ञान की आवश्यकता होती है। आप इसे आधिकारिक गाइड से प्राप्त कर सकते हैं ।

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

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



जब खोज प्रबंधक खोज के लिए जिम्मेदार और खोज के लिए संकेत प्रदान करने के लिए हमारी गतिविधि को परिभाषित करता है, तो क्रियाओं के निम्नलिखित अनुक्रम होते हैं:

1. जब खोज प्रबंधक खोज क्वेरी का पाठ प्राप्त करता है, तो वह संकेत प्रदान करने वाले सामग्री प्रदाता को अपना अनुरोध भेजता है।
2. सामग्री प्रदाता खोज क्वेरी के पाठ से मेल खाने वाले संकेत की ओर इशारा करते हुए एक कर्सर लौटाता है।
3. खोज प्रबंधक कर्सर का उपयोग करके टूलटिप्स प्रदर्शित करता है

संकेतों की सूची प्रदर्शित होने के बाद, निम्नलिखित हो सकता है:

• यदि उपयोगकर्ता अनुरोध के पाठ को बदलता है, तो उपरोक्त सभी चरणों को दोहराया जाएगा।
• यदि उपयोगकर्ता खोज शुरू करता है, तो संकेतों को अनदेखा किया जाता है।
• यदि उपयोगकर्ता एक टूलटिप का चयन करता है, तो इस टूलटिप के पाठ के साथ एक अनुरोध के रूप में एक इरादे को गतिविधि तक पहुंचाया जाता है।

इसलिए, संकेतों को लागू करने के लिए, हमें निम्नलिखित की आवश्यकता है:

• एक कंटेंट प्रोवाइडर बनाएं जो SearchRecentSuggestionsProvider से इनहेरिट करेगा और इसे घोषणा में घोषित करेगा
• सामग्री प्रदाता के बारे में जानकारी जोड़कर कॉन्फ़िगरेशन xml संवाद फ़ाइल बदलें
• सक्रियता को संशोधित करें ताकि यह खोज शुरू होने पर हर बार प्रश्नों को सहेजे

एक सामग्री प्रदाता बनाएँ

हमारे लिए आवश्यक सभी एक सामग्री प्रदाता है, जो SearchRecentSuggestionsProvider वर्ग का वंशज है। यह वर्ग व्यावहारिक रूप से डेवलपर के लिए सभी कार्यों को करता है और हमें जो भी आवश्यक है वह एक निर्माता को लिखना है।



फ़ाइल सुझाव

package com.example.search;



import android.content.SearchRecentSuggestionsProvider;



public class SuggestionProvider extends SearchRecentSuggestionsProvider {

public final static String AUTHORITY = "com.example.search.SuggestionProvider" ;

public final static int MODE = DATABASE_MODE_QUERIES;



public SuggestionProvider() {

setupSuggestions(AUTHORITY, MODE);

}

}



* This source code was highlighted with Source Code Highlighter .

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

public final static int MODE = DATABASE_MODE_QUERIES | DATABASE_MODE_2LINES;



* This source code was highlighted with Source Code Highlighter .

अब यह मत भूलो कि आपको हमारे सामग्री प्रदाता को घोषणा में घोषित करने की आवश्यकता है।



AndroidManifest.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 >

< provider android:name =".SuggestionProvider"

android:authorities ="com.example.search.SuggestionProvider" />

</ application >

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



</ manifest >



* This source code was highlighted with Source Code Highlighter .

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

युक्तियों के लिए हमारे सामग्री प्रदाता का उपयोग करने के लिए संवाद के लिए, आपको मापदंडों को जोड़ने की आवश्यकता है Android: searchSuggestAuthority और android: searchSuggestSelection to it



फ़ाइल खोजा। 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"

android:searchSuggestAuthority ="com.example.search.SuggestionProvider"

android:searchSuggestSelection =" ?" >

</ searchable >



* This source code was highlighted with Source Code Highlighter .

Android का मान: searchSuggestAuthority पैरामीटर को पूरी तरह से सामग्री प्रदाता के प्राधिकरण स्ट्रिंग से मेल खाना चाहिए।

Android का मान: searchSuggestSelection पैरामीटर एक स्पेस के बाद रखा गया प्रश्न चिह्न होना चाहिए, क्योंकि यह डेटाबेस से चयन करने के लिए एक तर्क है और प्रश्न चिह्न को उपयोगकर्ता द्वारा दर्ज किए गए टेक्स्ट द्वारा स्वचालित रूप से बदल दिया जाता है।

गतिविधि बदलें

हमें केवल क्वेरी टेक्स्ट को सहेजने की आवश्यकता है, इसके लिए SearchRecentSuggestions वर्ग का एक उदाहरण बनाया गया है और saveRecentQuery () विधि कहा जाता है । ऐसा हर बार होता है जब कोई इंटेंट डेटा की खोज करने के अनुरोध के साथ किसी गतिविधि में आता है। दो मापदंडों को saveRecentQuery () विधि से पास किया जाता है, पहला आवश्यक है और खोज स्ट्रिंग का प्रतिनिधित्व करता है, दूसरा वैकल्पिक है, यह आवश्यक है यदि आप टूलटिप में पाठ की दूसरी पंक्ति प्रदर्शित करने के लिए DATABASE_MODE_2LINES का उपयोग करते हैं।



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



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.provider.SearchRecentSuggestions;

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);

// SearchRecentSuggestions

SearchRecentSuggestions suggestions = new SearchRecentSuggestions( this ,

SuggestionProvider.AUTHORITY, SuggestionProvider.MODE);

//

suggestions.saveRecentQuery(query, null );

//

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 ;

case R.id.clear_recent_suggestions:

//

SearchRecentSuggestions suggestions = new SearchRecentSuggestions( this ,

SuggestionProvider.AUTHORITY, SuggestionProvider.MODE);

suggestions.clearHistory();

return true ;

default :

return super.onOptionsItemSelected(item);

}

}

}



* This source code was highlighted with Source Code Highlighter .

निष्कर्ष

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

पूरी संशोधित परियोजना code.google.com पर है