Подключение к mysql при помощи android api, json’a и php

Введение

Всем привет. Сегодня изучал поисковик с таким запросом «как работать с MySQL в ADT Bundle» и, если честно сказать, совершенно ничего не нашел. Решил написать об этом здесь.
Этот урок может помочь любому, от начинающего разработчика под Android, до профи, который начал работать с БД в своем приложении.

Создание проекта в Eclipse (далее ADT)

Итак, поехали. Заходим, создаем новое приложение в нашем ADT под названием AndroMySQL, активити используем: mainActivite.

Создание backend

Нам нужно написать серверную часть. В своем уроке я буду использовать для работы серверной части PHP, MySQL, PHPMyAdmin, Linux Debian.

Шаг 1

Ставим сервер, я использовал хостера VPS. Купил сервер за 300 рублей и на нем работал. Вы можете сделать также, а можете просто установить пакет Denwer.

Шаг 2

Теперь, когда наш сайт (далее site.ru) доступен, мы можем приступить к делу и взяться за написание серверной части нашего проекта.
Заходим в корень site.ru (через FTP/SFTP или проводник) и создаем там файл andro.php. В итоге созданный файл должен быть виден по такой ссылке: www.site.ru/andro.php. Далее создаем файл add_prod.php (аналогично первому файлу add_prod.php должен быть доступен по ссылке www.site.ru/add_prod.php).

Шаг 3

Заходим в наш PHPMyAdmin (чаще всего это site.ru/phpmyadmin) и создаем новую базу под название andro. В этой базе нам нужно создать таблицу под названием products, которая будет состоять из сущностей: id_product, title, short, price.

id_product — номер продукта (значение типа int, длина 128, AUTOINCREMENT);
title — название продукта (значение типа VarChar, длина 512);
short — описание продукта (значение типа VarChar, длина 2048);
price — цена продукта (значение типа int, длина 128).

Шаг 4

Открываем файл andro.php для редактирования (для уменьшения вероятности появления ошибки сделайте кодировку файла ANSI). В этом файле нам нужно будет прописать функционал получения данных из нашей БД и вывод их в формате JSON (если вам неизвестно — эта аббревиатура, то для начала прочитайте о нем). Итак, файл должен быть такого содержания:

//Для начала подключаемся к серверу MySQL
$connect = mysql_connect("server_ip","user","password"); // Подключаемся к БД, данные для подключения введите свои
//Выбираем базу данных в которой будем работать
$msDB = mysql_select_db("andro"); // Мы выбрали бд andro, так как мы её используем в нашем уроке
// Строим SQL запрос для БД
$query = "SELECT * FROM products WHERE 1"; //Оброщаемся к таблице products и получаем все сущности таблицы, WHERE 1 обозначает, что выводить нужно все, можно любую там цифру ввести, можно вообще пустым оставить
//Выполняем наш SQL
$result = mysql_query($query); // Переменная result получает ресурс (заметьте ресурс, не массив) с данными вернувшимися от бд
if(mysql_num_rows($query) >= 1) { // Проверяем есть ли хоть одна запись в бд по данному запросу
	$iter = 0; // Создаем переменную для дальнейшего создания массива
	$arr = Array(); //Создаем пустой массив в который будем дополнять наши данные о продуктах
//Функция mysql_fetch_assoc строит ассоциативный массив из полученных данных, но построение и присвоение может осуществляться только по одной записи. Именно по этой причине нам придется считывать по одиночно записи и добавлять их в наш массив.
	while($data = mysql_fetch_assoc($query)) { //Достаем строку и присваиваем темповой переменной data
		$arr['products'][$iter] = $data; //Дополняем наш массив arr данными из бд
		++$iter; //увеличиваем счетчик
//Это не единственный вариант создания данного массива, можно также использовать функцию php - array_push, но мы пойдем по такому пути
	} //Заканчиваем цикл
//Функция json_encode(array mixed_value[,parameters]) эта функция преобразует массив данных в JSON строку
	print json_encode($arr); //Преобразовываем наш массив в JSON
} // Закрываем IF

mysql_close($connect); // Закрываем соединение с базой

Пока не заходим на andro.php через сайт, так как значений у нас в БД еще нет, поэтому отредактируем ранее созданный файл add_prod.php.

Шаг 5

Открываем файл add_prod.php для редактирования (также про кодировку не забываем). Содержимое файла должно быть таким:

<form action="" method="get">
Название: <input type="text" name="title" /><br>
Описание: <input type="text" name="short" /><br>
Цена: <input type="text" name="price" /><br>
<input type="hidden" name="add" value="yes" />
<input type="submit" value="Добавить запись" />
</form>
<?
$connect = mysql_connect("server_ip_mysql","user","password"); // Подключаемся к бд
$MsSDB = mysql_select_db("andro"); // Выбираем бд

if($_GET["add"] == "yes") {
	
foreach($_GET as $key => $value) { // Присваиваем две временные переменные для обработки пришедших данных
$_GET[$key] = addslashes($value); // Обрабатываем все данные
}
	$query = mysql_query("INSERT INTO products (title,short,price) VALUES ('$_GET[title]','$_GET[short]','$_GET[price]')"); //Выполняем запрос
}
?>

Шаг 6

Теперь нужно перейти на www.site.ru/add_prod.php и добавить записи (количество на ваше усмотрение).

Шаг 7

После добавления зайдите на www.site.ru/andro.php и в результате на странице должно получиться что-то вроде этого.

Итак, мы закончили с серверной частью, теперь перейдем к так называемому frontend'у или к части приложения Android.

Создание приложения Android

Итак, в начале урока мы уже создали форму для дальнейшей разработки, давайте перейдем в ADT.

Шаг 1

Перейдем в activity_main.xml и добавим туда это:

<RelativeLayout 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: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=".MainActivity" >

    <ListView
        android:id="@+id/listView1"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentLeft="true"
        android:layout_alignParentTop="true"
        android:layout_marginLeft="19dp"
        android:layout_marginTop="15dp" >
    </ListView>

</RelativeLayout>

Далее создадим еще один layout под название list_item.xml (для создания нового layout перейдите в File->New->Android XML File. Resource Type: Layot, Project: AndroMySQL, File: list_item, Root Element: LinearLayout) и добавим в него это:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:padding="10dp"
    android:paddingLeft="10dp"
    android:paddingRight="10dp" >
 
    <!-- Поле названия-->
 
    <TextView
        android:id="@+id/name"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:paddingBottom="2dip"
        android:paddingTop="6dip"
        android:textColor="#43bd00"
        android:textSize="16sp"
        android:textStyle="bold" />
 
    <!-- Поле описание -->
    <TextView
        android:id="@+id/short"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:paddingBottom="2dip"
        android:textColor="#acacac" />
 
   <!-- Поле цены -->
   <TextView
        android:id="@+id/price"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:paddingBottom="0dip"
        android:textColor="#acacac" />

 
</LinearLayout>

Шаг 2

Для работы нам нужен новый класс (class) для получения JSON сформированной строки из нашего andro.php. Переходим в File->New->Class, там вводим:
Source folder: AndroMySQL/src,
Package: com.example.andromysql (или ваш класс),
Name: ServiceHandler,
Super Class: java.lang.Object

В ServiceHandler.java добавляем текст:

package com.example.andromysql; //подключаем наш проект
 
//Подключаем библиотеки нужные для работы нашего нового класса
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.util.List;
 
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.utils.URLEncodedUtils;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.util.EntityUtils;
 
public class ServiceHandler {
 
    static String response = null;
    public final static int GET = 1;
    public final static int POST = 2;
 
    public ServiceHandler() {
 
    }
 
    /**
     * Making service call
     * @url - ссылка на запрос
     * @method - http метод для получения значений
     * */
    public String makeServiceCall(String url, int method) {
        return this.makeServiceCall(url, method, null);
    }
 
    /**
     * Making service call
     * @url - url для запроса
     * @method - http метод для получения значений
     * @params - http параметры
     * */
    public String makeServiceCall(String url, int method,
            List<NameValuePair> params) {
        try {
            //Клиент HTTP
            DefaultHttpClient httpClient = new DefaultHttpClient();
            HttpEntity httpEntity = null;
            HttpResponse httpResponse = null;
             
            // Проверяем HTTP на метод POST
            if (method == POST) {
                HttpPost httpPost = new HttpPost(url);
                // добавляем параметры
                if (params != null) {
                    httpPost.setEntity(new UrlEncodedFormEntity(params));
                }
 
                httpResponse = httpClient.execute(httpPost);
 
            } else if (method == GET) {
                // конкатерируем параметры к URL
                if (params != null) {
                    String paramString = URLEncodedUtils
                            .format(params, "utf-8");
                    url += "?" + paramString;
                }
                HttpGet httpGet = new HttpGet(url);
 
                httpResponse = httpClient.execute(httpGet);
 
            }
            httpEntity = httpResponse.getEntity();
            response = EntityUtils.toString(httpEntity);
 
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        } catch (ClientProtocolException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
         
        return response;
 
    }
}

Сохраняем наш класс и переходим в MainActivity.java

Шаг 3

В MainActivity.java нам нужно добавить такое содержимое:

package com.example.andromysql;

//Подключаем нужные библиотеки
import java.util.ArrayList;
import java.util.HashMap;

import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;

import android.app.ListActivity;
import android.app.ProgressDialog;
import android.os.AsyncTask;
import android.os.Bundle;
import android.util.Log;
import android.widget.ListAdapter;
import android.widget.ListView;
import android.widget.SimpleAdapter;

public class MainActivity extends ListActivity {
	 
    private ProgressDialog pDialog;
 
    // URL где хранится наш отформатированный JSON
    private static String url = "http://www.develsi.com/view.php"; // поменяйте значение на свое
 
    // JSON Теги, чтобы в будущем оброщаться в методах
    private static final String TAG_PRODUCTS = "products";
    private static final String TAG_ID = "id_product";
    private static final String TAG_NAME = "title";
    private static final String TAG_SHORT = "short";
    private static final String TAG_PRICE = "price";
 
    // JSONArray - тип данных : массив из JSON строки
    JSONArray products = null;
 
    // Hashmap для ListView
    ArrayList<HashMap<String, String>> productList;
 
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        contactList = new ArrayList<HashMap<String, String>>();
 
        ListView lv = getListView();
        
     // Вызываем асинхронное получение JSON
        new GetContacts().execute();
    }
    
    
    /**
     * Асинхронный класс для получения JSON строки с HTTP страницы
     * */
    private class GetContacts extends AsyncTask<Void, Void, Void> {
 
        @Override
        protected void onPreExecute() {
            super.onPreExecute();
            // Показываем диалог загрузки на время получения данных
            pDialog = new ProgressDialog(MainActivity.this);
            pDialog.setMessage("Загрузка...");
            pDialog.setCancelable(false);
            pDialog.show();
 
        }
 
        @Override
        protected Void doInBackground(Void... arg0) {
            // Создаем экземпляр класса ServiceHandler
            ServiceHandler sh = new ServiceHandler();
 
            // Делаем запрос на наш url и получаем ответ в переменную типа String sh
            String jsonStr = sh.makeServiceCall(url, ServiceHandler.GET);
 
            Log.d("Response: ", "> " + jsonStr);// Выводим в консоль результат, то что пришло с сервера
 //Лучше читать, что именно пришло, так как бывают ошибки из-за лишних символов, пробел и перенос строки - это тоже символ.

            if (jsonStr != null) { //Проверяем не пустой ли нам пришел ответ
                try {
                    JSONObject jsonObj = new JSONObject(jsonStr); // Создаем переменную типа JSONObject
                     
                    // Получаем массив продуктов из нашего объекта
                    products = jsonObj.getJSONArray(TAG_PRODUCTS);
 
                    // Проходим по всем продуктом циклом, для создания ассоциативного массива
                    for (int i = 0; i < products.length(); i++) {
                        JSONObject p = products.getJSONObject(i);
                         //Создаем некоторые переменные для дальнейшей работы
                        String id = p.getString(TAG_ID); // достаем номер продукта
                        String name = p.getString(TAG_NAME); //достаем название продукта
                        String email = p.getString(TAG_SHORT); //достаем описание продукта
                        String address = p.getString(TAG_PRICE); //достаем цену продукта
 
                        // Временная переменная hashmap для одиночной записи продукта
                        HashMap<String, String> product = new HashMap<String, String>();
 
                        // Добовляем значения в наш HashMap в виде key => value
                        product.put(TAG_ID, id); 
                        product.put(TAG_NAME, name);
                        product.put(TAG_EMAIL, email);
 
                        // Добовляем продукты в наш лист продуктов
                        productList.add(product);
                    }
                } catch (JSONException e) {
                    e.printStackTrace();
                }
            } else {
                Log.e("ServiceHandler", "Не удалось получить никаких данных из адреса");
            }
 
            return null;
        }
 
        @Override
        protected void onPostExecute(Void result) {
            super.onPostExecute(result);
            // Закрываем наш диалог загрузки
            if (pDialog.isShowing())
                pDialog.dismiss();
            /**
             * Обновляем запарсенные данные JSON в наш ListView
             * */
            ListAdapter adapter = new SimpleAdapter(
                    MainActivity.this, contactList,
                    R.layout.list_item, new String[] { TAG_NAME, TAG_SHORT }, new int[] { R.id.name,
                            R.id.short});
 // Я не стал использовать в примере еще 2 переменные так как мне это не нужно на данный момент, но если вы желаете включить их в показ, то просто добавьте строку TAG_PRICE в new String[] {...} и R.id.price в new int[] {...}

            setListAdapter(adapter); // Теперь через адаптер добовляем наш получившийся массив в ListView
        }
 
    }
    
    
}

Итог

После всех этих трудоемких шагов вы можете запустить ваше приложение на тестовом девайсе, предварительно включив сервер и проверив, выдает ли страница andro.php JSON код. Если вы все выполнили правильно, в итоге у вас должно получится так:
1. Запускаете приложение.
2. Открывается диалог загрузки.
3. Диалог загрузки пропадает и появляется список названий и описаний продуктов.
4. При нажатии кнопки назад происходит выход из приложения.

Спасибо всем за внимание.

Автор: ctaciv

Источник