من خبرتي المتواضعة ببرمجة الأندرويد فقد جربت سابقا استخدام طلبات ال POST request إلى صفحة PHP بسيرفر الويب لإرسال البيانات واستقبالها، ربما قد تجدي نفعا معك أو يستفيد منها أشخاص آخرون.

هذا كلاس خاص قمت بتصميمه لمشروع تجريبي من أجل عمليات الاتصال بسيرفر الويب بالاسم ServerLink، وهو يعتمد في عمله على الكلاس AsyncTask بمكتبات التطوير، يضاف الكلاس مباشرة إلى مشروع الأندرويد مع تعديل معرف الحزمة ال package إلى المعرف الخاص بتطبيقك، كمثال إذا أردت ارسال سلسلة تحتوي اسمك إلى السيرفر فإنك تكتب الصيغة التالية:

new ServerLink(this, "hello", "Muhammad");

المعامل الأول مؤشر لل Activity التي قامت بإنشاء كائن الاتصال، حتى يستطيع الأخير الوصول لها وعرض التحديثات التي تظهر لمستخدم التطبيق أوغيره عبر متغير activity الخاص كما سيتبين تباعا.

المعامل الثاني يعمل كمفتاح أو دليل لنوع اجراء الاتصال، القيمة hello ترشد الكائن لإجراء الاتصال بواسطة الكلاس الداخلي RunHello

المعامل الثالث يمثل الرسالة أو المحتوى الذي يتوجب على الإجراء إرساله للسيرفر، هنا توجد قيمة واحدة وهي اسمك، لارسال قيمة أخرى ببساطة أضفها كمعاملات إضافية، أي أنك لست مقيدا، فقط تأكد من برمجة الكلاس الداخلي المخصص للإجراء لاستيعاب هذه القيم.

هذا هو كود كلاس الاتصال ServerLink

package com.test.app;

import android.app.Activity;
import android.os.AsyncTask;
import android.view.View;
import android.widget.ProgressBar;
import android.widget.Toast;

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.protocol.HTTP;
import org.apache.http.util.EntityUtils;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class ServerLink
{
    //server name or IP address of your web server
    private static String server = "http://192.168.10.2";
    private Activity activity;

    ServerLink(Activity activity, String toDo, String... params) {
        this.activity = activity;

        switch (toDo) {

            case "hello":
                new RunHello().execute(params);
                break;

        //you can put other "case" here ended by "break"
        }
    }

    private class RunHello extends AsyncTask <String, Void, HttpEntity> {
        private ProgressBar pb = (ProgressBar) activity.findViewById(R.id.progressBar);

        protected void onPreExecute() {
            pb.setVisibility(View.VISIBLE);
        }

        protected HttpEntity doInBackground(String... params) {

            HttpClient client = new DefaultHttpClient();
        // "hello.php" is the page that will handel POST request
            HttpPost post = new HttpPost(ServerLink.server + "hello.php");
            try {
                List<NameValuePair> pairs = new ArrayList<NameValuePair>();
                    pairs.add(new BasicNameValuePair("thename", params[0]));
                    post.setEntity(new UrlEncodedFormEntity(pairs, HTTP.UTF_8));

                HttpResponse response = client.execute(post);
                return response.getEntity();
            } catch (IOException e) {
                e.printStackTrace();
                return null;
            }
        }

        protected void onPostExecute(HttpEntity ent) {
            pb.setVisibility(View.GONE);
            try {
                if(ent != null) {
                    Toast.makeText(activity, EntityUtils.toString(ent), Toast.LENGTH_SHORT).show();
                } else {
                    Toast.makeText(activity, "can not reach the server", Toast.LENGTH_SHORT).show();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

نأتي لبعض من التفصيل

المتغير server يحوي عنوان سيرفر الويب، المتغير toDo يمثل القيمة أو المفتاح الذي يحدد نوع الإجراء المطلوب وأي من الكلاسات الداخلية ينفذ وذلك من خلال جملة switch ، هنا مبرمجة على أنها إن استقبلت المفتاح "hello" فإن الكلاس الداخلي RunHello سوف ينفذ.

لاحظ أنه عند انشاء كائن من الكلاس الداخلي الخاص بالإجراء فإنه يمرر المعامل params، وهي عبارة عن مصفوفة بها القيم التي تود ارسالها بطلب ال POST لسيرفر الويب، فمثلا params[0] تحتوي القيمة "Muhammad" ، وإن أرسلت قيمة ثانية وثالثة عند انشاء كائن الاتصال فستجدهما في params[1] و params[2] وهكذا.

HttpPost post = new HttpPost(ServerLink.server + "hello.php");

هنا تم برمجة الإجراء الداخلي RunHello على أن يرسل القيم بالمصفوفة params إلى صفحة hello.php الموجودة بسيرفر الويب لمعالجتها.

pairs.add(new BasicNameValuePair("thename", params[0]));

أما هنا فقد تم ربط القيمة params[0] بالمسى thename، وهو الاسم الذي سيستقبله سيرفر الويب ك $_POST['thename'] وستكون قيمته "Muhammad"

if(ent != null) {
                    Toast.makeText(activity, EntityUtils.toString(ent), Toast.LENGTH_SHORT).show();
                } else {
                    Toast.makeText(activity, "can not reach the server", Toast.LENGTH_SHORT).show();
                }

هنا اختبار لوجود رد من السيرفر، سيعرض رد السيرفر إن وجد على شكل رسالة Toast بواسطة EntityUtils.toString(ent) وإلا فسيعرض "can not reach the server" ، رد السيرفر يكون بكود PHP على شكل echo أو print مثلا. بالطبع يمكنك بدل أن تعرض رسالة القيام بتفاعل ما على واجهة المستخدم مثل عرض النتيجة في EditText أو TextView بالواجهة، والوصول للواجهة يكون عن طريق المتغير activity ، في هذا المثال افترض وجود ProgressBar بالواجهة تحت المعرف R.id.progressBar وتم ربطه بالمؤشر pb ، ثم إظهاره عند بدء الإجراء وإخفائه عند الإنتهاء كالتالي:

private ProgressBar pb = (ProgressBar) activity.findViewById(R.id.progressBar);
pb.setVisibility(View.VISIBLE);
pb.setVisibility(View.GONE);

أخيرا:

يمكنك إنشاء أكثر من كلاس داخلي كإجراءات مختلفة مع سيرفر الويب، مثلا كإرسال رقم معرف لسجل ما بقاعدة بيانات MySQL واستقبال بيانات السجل وعرضها بالتطبيق، حيث سيكون هنالك ملف PHP وسيط بين التطبيق وبين قاعدة البيانات، الأمر أشبه بأسلوب العمل مع الواجهات البرمجية API