compile files('libs/android-query-full.0.26.8.jar')
The following graphics illustrate how data flow when you start the app:
The primary function of a dictionary is to provide the meaning of a particular word. Unfortunately, common dictionaries are limited to one word input. The VocaDB Dictionary app supports text or sentence inputs.
When you make a request, the API provides different return types based on four input types: normal word, idioms, non-English word, and text.
try {
// Check first the return type
int returnType = json.getInt("type");
switch (returnType) {
// Word not found
case 0:
wordNotFound(json); // or no authority
break;
// Normal word
case 1:
normalWord(json);
break;
// Normal idiom
case 2:
normalIdiom(json);
break;
// Non-english word
case 3:
nonEnglishWord(json);
break;
// Extract words
case 4:
extractWordList(json);
break;
}
} catch (JSONException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
English is the default language of the input text (source language or slang) and the search result (target language or tlang). However, the search result can be set to another language.
The app also has a reverse search function. When enabled, the system allows a non-English input text with search result in English.
The following code initialize all language and set the corresponding drawable flag based on source language (slang) and target language (tlang).
/**
* Method that get stored language from shared preference
*/
private void initLanguage() {
// Get language values from share pref
sourceLang = prefs.getString("source_language", "");
targetLang = prefs.getString("target_language", "");
// Check if slang and tlang exists
if (sourceLang.equals(""))
sourceLang = "en";
if (targetLang.equals(""))
targetLang = "en";
// Check target lang and set map image value
if (targetLang.equals("ar"))
languageDrawable = R.drawable.lang_arabic;
else if (targetLang.equals("hy"))
languageDrawable = R.drawable.lang_armenian;
else if (targetLang.equals("bn"))
languageDrawable = R.drawable.lang_bengali;
else if (targetLang.equals("bg"))
languageDrawable = R.drawable.lang_bulgaria;
else if (targetLang.equals("zh-CN"))
languageDrawable = R.drawable.lang_chinese_simplified;
else if (targetLang.equals("zh-TW"))
languageDrawable = R.drawable.lang_chinese_traditional;
else if (targetLang.equals("hr"))
languageDrawable = R.drawable.lang_croatian;
else if (targetLang.equals("cs"))
languageDrawable = R.drawable.lang_czech;
else if (targetLang.equals("da"))
languageDrawable = R.drawable.lang_danish;
else if (targetLang.equals("nl"))
languageDrawable = R.drawable.lang_dutch;
else if (targetLang.equals("en"))
languageDrawable = R.drawable.lang_en;
else if (targetLang.equals("tl"))
languageDrawable = R.drawable.lang_filipino;
else if (targetLang.equals("fi"))
languageDrawable = R.drawable.lang_finnish;
else if (targetLang.equals("fr"))
languageDrawable = R.drawable.lang_french;
else if (targetLang.equals("ka"))
languageDrawable = R.drawable.lang_georgian;
else if (targetLang.equals("de"))
languageDrawable = R.drawable.lang_german;
else if (targetLang.equals("el"))
languageDrawable = R.drawable.lang_greek;
else if (targetLang.equals("hi"))
languageDrawable = R.drawable.lang_hindi;
else if (targetLang.equals("hu"))
languageDrawable = R.drawable.lang_hungarian;
else if (targetLang.equals("id"))
languageDrawable = R.drawable.lang_indonesian;
else if (targetLang.equals("it"))
languageDrawable = R.drawable.lang_italian;
else if (targetLang.equals("ja"))
languageDrawable = R.drawable.lang_japanese;
else if (targetLang.equals("ko"))
languageDrawable = R.drawable.lang_korean;
else if (targetLang.equals("ms"))
languageDrawable = R.drawable.lang_malay;
else if (targetLang.equals("no"))
languageDrawable = R.drawable.lang_norwegian;
else if (targetLang.equals("fa"))
languageDrawable = R.drawable.lang_persian;
else if (targetLang.equals("pl"))
languageDrawable = R.drawable.lang_polish;
else if (targetLang.equals("pt"))
languageDrawable = R.drawable.lang_portuguese;
else if (targetLang.equals("ro"))
languageDrawable = R.drawable.lang_romanian;
else if (targetLang.equals("ru"))
languageDrawable = R.drawable.lang_russian;
else if (targetLang.equals("sl"))
languageDrawable = R.drawable.lang_slovenian;
else if (targetLang.equals("es"))
languageDrawable = R.drawable.lang_spanish;
else if (targetLang.equals("sv"))
languageDrawable = R.drawable.lang_swedish;
else if (targetLang.equals("ta"))
languageDrawable = R.drawable.lang_tamil;
else if (targetLang.equals("th"))
languageDrawable = R.drawable.lang_thai;
else if (targetLang.equals("tr"))
languageDrawable = R.drawable.lang_turkish;
else if (targetLang.equals("uk"))
languageDrawable = R.drawable.lang_ukrainian;
else if (targetLang.equals("vi"))
languageDrawable = R.drawable.lang_swedish;
else
languageDrawable = R.drawable.lang_en; // Default flag
languageImageView = (ImageView)findViewById(R.id.language_imageview);
// Change button image source
languageImageView.setImageResource(languageDrawable);
}
The app has an English level selection which filters the words and idioms to be extracted from a text as well as their corresponding definitions.
If elementary level is selected, for example, it will only extract words and idioms for elementary language learners.
The app will extract with no filter if nothing is selected.
The app can also translate texts to a desired language. Just click 
for Google Translate and 
for MS Bing.
Make sure that the target language is set to a non-English language.
The app allows users to add new words and idioms and to contribute definitions to improve the database. This feature requires user e-mail and security code.
To show the User Participation dialog, simply call the showUserParticipationDialog() function.
/**
* Method to show User Participation Box
*/
public void showUserParticipationDialog(String search, int fromAdapter)
{
// Instantiate dialog
final DialogHelper dialog = new DialogHelper(MainActivity.this, R.style.modalDialog);
// Set dialog layout
dialog.setContentView(R.layout.dialog_user_participation);
// Set modal screen size
int width = ViewGroup.LayoutParams.MATCH_PARENT;
int height = ViewGroup.LayoutParams.MATCH_PARENT;
dialog.getWindow().setLayout(width, height);
// Set title for the dialog
dialog.setTitle("User Participation");
// Show dialog
dialog.show();
// Find views
final EditText word = (EditText) dialog.findViewById(R.id.word_edittext);
final EditText wordMeaning = (EditText) dialog.findViewById(R.id.word_meaning_edittext);
final EditText partOfSpeech = (EditText) dialog.findViewById(R.id.part_of_speech_edittext);
final EditText clientsEmail = (EditText) dialog.findViewById(R.id.clients_email_edittext);
final EditText securityCode = (EditText) dialog.findViewById(R.id.security_code_edittext);
ImageView closeImageView = (ImageView) dialog.findViewById(R.id.close_imageview);
Button submit = (Button) dialog.findViewById(R.id.submit_button);
// Set prefilled value to word
if (!TextUtils.isEmpty(sourceEditText.getText().toString()) && fromAdapter == 0)
word.setText(searchWord);
else
word.setText(search);
// Button click event
submit.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// Get edittext values
String wordStr = word.getText().toString();
String wordMeaningStr = wordMeaning.getText().toString();
String partOfSpeechStr = partOfSpeech.getText().toString();
String clientsEmailStr = clientsEmail.getText().toString();
String securityCodeStr = securityCode.getText().toString();
// Check first if there are no empty fields
if (TextUtils.isEmpty(wordStr)){
word.setError(getString(R.string.error_field_required));
focusView = word;
cancel = true;
}
if (TextUtils.isEmpty(wordMeaningStr)){
wordMeaning.setError(getString(R.string.error_field_required));
focusView = wordMeaning;
cancel = true;
}
if (TextUtils.isEmpty(partOfSpeechStr)){
partOfSpeech.setError(getString(R.string.error_field_required));
focusView = partOfSpeech;
cancel = true;
}
if (TextUtils.isEmpty(clientsEmailStr)){
clientsEmail.setError(getString(R.string.error_field_required));
focusView = clientsEmail;
cancel = true;
} else if (!vocaDBUtils.isEmailValid(clientsEmailStr)) {
clientsEmail.setError(getString(R.string.error_invalid_email));
focusView = clientsEmail;
cancel = true;
}
if (TextUtils.isEmpty(securityCodeStr)){
securityCode.setError(getString(R.string.error_field_required));
focusView = securityCode;
cancel = true;
}
// Check if security code is correct
else if (!securityCodeStr.equals("2637")) {
securityCode.setError(getString(R.string.error_invalid_security_code));
focusView = securityCode;
cancel = true;
}
if (cancel) {
// There was an error; don't attempt register and focus the first
// form field with an error.
focusView.requestFocus();
cancel = false;
} else {
String url = Constants.USER_PARTICIPATION_URL;
Map params = new HashMap();
params.put("apikey", Constants.DICTIONARY_API_KEY);
params.put("word", wordStr);
params.put("means", wordMeaningStr);
params.put("pos", partOfSpeechStr);
params.put("email", clientsEmailStr);
params.put("tlang", targetLang);
AQUtility.debug("Parameters", params);
aq.ajax(url, params, JSONArray.class, new AjaxCallback() {
@Override
public void callback(String url, JSONArray _ja, AjaxStatus _status) {
AQUtility.debug("User Participation Response", _ja);
word.setText("");
wordMeaning.setText("");
partOfSpeech.setText("");
clientsEmail.setText("");
securityCode.setText("");
// Prompt user for success
new AlertUtility(MainActivity.this).alertInfo(
"User Participation",
"Thank you for your participation.",
getString(R.string.ok),
null);
// Close dialog
dialog.dismiss();
}
});
}
}
});
// Set close button click listener
closeImageView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// Close dialog
dialog.dismiss();
}
});
}
The app also has a puzzle feature for easy memorization of searched words. The color of each letter changes when clicked.
To show puzzle, simply call the createPuzzle() function.
/**
* Method to create puzzle
*
* @param word
*/
private void createPuzzle(final String word) {
AQUtility.debug("Puzzle word count:", word.length());
// Remove all existing views in the layout
puzzleLayout.removeAllViews();
String[] str = word.split("");
List textList = new ArrayList(wordCount);
for(int i = 0; i <= word.length(); i++) {
AQUtility.debug("Puzzle word count:", word.length());
AQUtility.debug("Puzzle word char:", str[i]);
final TextView letterTextView = new TextView(MainActivity.this);
LinearLayout.LayoutParams param = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.WRAP_CONTENT,
LinearLayout.LayoutParams.WRAP_CONTENT);
param.rightMargin = 5;
letterTextView.setLayoutParams(param);
letterTextView.setTextColor(Color.LTGRAY);
letterTextView.setTextSize(getResources().getDimension(R.dimen.text_puzzle));
letterTextView.setTypeface(null, Typeface.BOLD);
letterTextView.setPadding(0, 10, 0, 10);
letterTextView.setGravity(Gravity.CENTER);
letterTextView.setText(str[i]);
letterTextView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if (letterTextView.getCurrentTextColor() == Color.RED)
letterTextView.setTextColor(Color.LTGRAY);
else
letterTextView.setTextColor(Color.RED);
}
});
puzzleLayout.addView(letterTextView);
textList.add(letterTextView);
}
// Add speaker imageview
ImageView speakerImageView = new ImageView(MainActivity.this);
speakerImageView.setImageDrawable(getResources().getDrawable(R.drawable.ic_speaker_dark_big));
LinearLayout.LayoutParams param = new LinearLayout.LayoutParams(45,45);
speakerImageView.setLayoutParams(param);
speakerImageView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
wordCount = VocaDBUtils.countWords(word);
Log.d("Word count", String.valueOf(wordCount));
// Check first if input is not empty
if (wordCount > 0) {
if (isInternetPresent()) {
if (isPlaying) {
mediaPlayer.stop();
mediaPlayer.reset();
}
try {
isPlaying = true;
// Check first if audio already exists in the local directory
if(!new File(Environment.getExternalStorageDirectory().toString() + Constants.AUDIO_PATH + searchValue.toLowerCase() + ".mp3").exists()) {
new DownloadFileFromURL("audio").execute(Constants.MEDIA_URL + searchValue.toLowerCase() + ".mp3");
mediaPlayer.setDataSource(Constants.MEDIA_URL + searchValue.toLowerCase() + ".mp3");
} else {
// Load audio from local directory
mediaPlayer.setDataSource(Environment.getExternalStorageDirectory().toString() + Constants.AUDIO_PATH + searchValue.toLowerCase() + ".mp3");
}
mediaPlayer.prepareAsync();
} catch (IllegalArgumentException e) {
isPlaying = false;
e.printStackTrace();
} catch (SecurityException e) {
isPlaying = false;
e.printStackTrace();
} catch (IllegalStateException e) {
isPlaying = false;
e.printStackTrace();
} catch (IOException e) {
isPlaying = false;
e.printStackTrace();
}
} else {
// Check if tts is in play/pause mode
if (!play) {
play = true;
textToSpeech = new TextToSpeech(getApplicationContext(),
new TextToSpeech.OnInitListener() {
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
@Override
public void onInit(int status) {
Log.d("MP Status", String.valueOf(status));
if (status != TextToSpeech.ERROR) {
Locale locale = new Locale(db.getLanCode(prefs.getString("default_language", "")));
textToSpeech.setLanguage(locale);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
ttsGreater21(searchValue);
} else {
ttsUnder20(searchValue);
}
}
}
});
} else {
textToSpeech.stop();
play = false;
}
}
} else {
Toast.makeText(MainActivity.this, "No word or text", Toast.LENGTH_SHORT).show();
}
}
});
puzzleLayout.addView(speakerImageView);
}
// API Keys public static final String DICTIONARY_API_KEY = "YOUR_API_KEY";
// API URLs public static final String BASE_URL = "https://www.vocadb.com/v2_dic/"; public static final String DICTIONARY_API_URL = BASE_URL + "api_vocadb_dic.php"; public static final String DEFINITION_API_URL = BASE_URL + "api_dic_exam_def.php"; public static final String EXAMPLE_DEF_TRANS_API_URL = BASE_URL + "api_dic_exam_def_trans.php"; public static final String USER_PARTICIPATION_URL = BASE_URL + "api_dic_request_word.php";
x-voca-apikey, along with your API key.
httpPost.addHeader("x-voca-apikey", YOUR_API_KEY);
UTF-8 encoding type to the request.httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
https://www.vocadb.com/v2_dic/api_dic_vocadb.php?apikey=YOUR_KEY&slang=en&tlang=en&level=2&q=arrest&d=1
