Введение в этот раздел:

Из предыдущих уроков о запросах данных, разборе данных, загрузке/скачивании файлов и т. д. у вас должно было сложиться базовое понимание взаимодействия с серверами. В этом разделе рассматривается вызов WebService из Android, что на самом деле несколько похоже на платформы данных, предоставляющие API-сервисы с необработанными данными, такие как Juhe Data (聚combineData)! WebService использует XML и SOAP и может выполнять взаимодействие с удалёнными машинами по протоколу HTTP! Что ж, не будем больше откладывать, начнём этот раздел~


1. Введение в WebService

PS: Если после прочтения введения выше вам всё ещё не ясно, то забудьте об этом. Раньше наша компания использовала C# для создания WebService! В этом разделе мы не будем обсуждать, как создать WebService; нам нужно только знать, как получить сервисы, предоставляемые WebService, разобрать возвращённые данные XML и затем отобразить соответствующие данные на нашем Android-устройстве!


2. Где получить сервисы WebService

В интернете есть много сайтов, которые предоставляют WebService. Сначала найдите эти сайты, а затем получите соответствующие сервисы! Здесь мы выберем WebXml и Yunju 36wu в качестве примеров, чтобы объяснить всем. Их официальные сайты:

webXml:http://www.webxml.com.cn/zh_cn/index.aspx

Раньше они были бесплатными, но теперь все стали коммерческими. Многие услуги требуют оплаты, но вы можете их попробовать. Этот сайт предоставляет 16 различных веб-сервисов. Вы можете искать соответствующие сервисы и вызывать разные интерфейсы в зависимости от ваших потребностей!

Связанные страницы webXml:

Описание соответствующего количества использований:

Yunju 36wu:http://www.36wu.com/Service

Он также предоставляет множество сервисов. Многие мобильные приложения используют здешние интерфейсы, например Rainbow Bus, Mobile Weather и т. д. Однако этот тоже взимает плату =-=, но вы можете попробовать. Однако вы можете отправлять только 20 запросов в час; нажмите, чтобы подать заявку на использование, получите ключ — и готово! Выберите любой из них!


3. Подготовка сторонних JAR-пакетов

Во-первых, если вы хотите вызывать WebService на платформе Android, вам потребуется сторонняя библиотека: ksoap2. На платформе Android мы используем ksoap2 Android — эффективный и лёгкий пакет для разработки SOAP!

Адрес скачивания JAR-пакета:https://code.google.com/p/ksoap2-android/wiki/HowToUse?tm=2

Возможно, он недоступен в Китае. Здесь мы предоставляем всем две ссылки Baidu Cloud для скачивания:

Версия 2.54:

Версия 3.30:

Если вам повезло получить доступ к адресу загрузки JAR, вы увидите следующий интерфейс:


4. Получение некоторых связанных параметров

Сначала найдите службу, которую нам нужно получить, а затем запишите соответствующие параметры:NameSpace(Namespace),SoapActionа такжеURLсамо собой разумеется. Остальные параметры находятся так:

Например, здесь мы ищем параметры запроса погоды. Перейдя внутрь, мы можем увидеть такой документ с параметрами:

Например, здесь нам нужна функциональность запроса погоды:

Сначала перепишите обведённые SoapAction и NameSpace! Конечно, мы можем протестировать на этой странице. Также, поскольку мы бесплатные пользователи, id можно оставить пустым и сразу пропустить. После ввода нажмите кнопку Invoke, и откроется такая страница:

Хе-хе, это возвращённый XML, и нам нужно распарсить такой XML. Кроме того, .gif здесь обозначает значок погоды!

Аналогично давайте также отметим SoapAction, NameSpace и связанные параметры для запроса местоположения по номеру телефона!

А также возвращённые XML-данные:


5. Регистрация и включение связанных веб-служб

Нажмите «My Web Server», затем нажмите «Try It». WebXml предоставляет нам пятидневную бесплатную пробную версию. Давайте включим два нужных нам сервера!

Хорошо, не забудьте записать наш собственный ключ~


6. Примеры кода для вызова WebService

Итак, далее давайте напишем код, чтобы проверить процесс вызова WebService:

Скриншот результата выполнения:

P.S.: Это старый номер =-=, не пытайтесь по нему звонить; теперь он принадлежит кому-то другому. Также у сервиса погоды, похоже, есть некоторые ограничения; иногда его не удаётся получить. Вероятно, из-за некоторых ограничений, наложенных WebXml. В конце концов, это пробная версия...

Код реализации:

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private EditText edit_param;
    private Button btn_attribution;
    private Button btn_weather;
    private TextView txt_result;

    private String city;
    private String number;
    private String result;


    //定义获取手机信息的SoapAction与命名空间,作为常量
    private static final String AddressnameSpace = "http://WebXml.com.cn/";
    //天气查询相关参数
    private static final String Weatherurl = "http://webservice.webxml.com.cn/WebServices/WeatherWS.asmx";
    private static final String Weathermethod = "getWeather";
    private static final String WeathersoapAction = "http://WebXml.com.cn/getWeather";
    //归属地查询相关参数
    private static final String Addressurl = "http://webservice.webxml.com.cn/WebServices/MobileCodeWS.asmx";
    private static final String Addressmethod = "getMobileCodeInfo";
    private static final String AddresssoapAction = "http://WebXml.com.cn/getMobileCodeInfo";


    //定义一个Handler用来更新页面:
    private Handler handler = new Handler() {
        public void handleMessage(Message msg) {
            switch (msg.what) {
                case 0x001:
                    txt_result.setText("结果显示:\n" + result);
                    Toast.makeText(MainActivity.this, "获取天气信息成功", Toast.LENGTH_SHORT).show();
                    break;
                case 0x002:
                    txt_result.setText("结果显示:\n" + result);
                    Toast.makeText(MainActivity.this, "号码归属地查询成功", Toast.LENGTH_SHORT).show();
                    break;
            }

        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        bindViews();
    }

    private void bindViews() {
        edit_param = (EditText) findViewById(R.id.edit_param);
        btn_attribution = (Button) findViewById(R.id.btn_attribution);
        btn_weather = (Button) findViewById(R.id.btn_weather);
        txt_result = (TextView) findViewById(R.id.txt_result);
        btn_attribution.setOnClickListener(this);
        btn_weather.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_weather:
                new Thread() {
                    @Override
                    public void run() {
                        getWether();
                    }
                }.start();
                break;
            case R.id.btn_attribution:
                new Thread(new Runnable() {
                    public void run() {
                        getland();
                    }
                }).start();
                break;
        }
    }


    //定义一个获取某城市天气信息的方法:
    public void getWether() {
        result = "";
        SoapObject soapObject = new SoapObject(AddressnameSpace, Weathermethod);
        soapObject.addProperty("theCityCode:", edit_param.getText().toString());
        soapObject.addProperty("theUserID", "dbdf1580476240458784992289892b87");
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
        envelope.bodyOut = soapObject;
        envelope.dotNet = true;
        envelope.setOutputSoapObject(soapObject);
        HttpTransportSE httpTransportSE = new HttpTransportSE(Weatherurl);
        System.out.println("天气服务设置完毕,准备开启服务");
        try {
            httpTransportSE.call(WeathersoapAction, envelope);
//            System.out.println("调用WebService服务成功");
        } catch (Exception e) {
            e.printStackTrace();
//            System.out.println("调用WebService服务失败");
        }

        //获得服务返回的数据,并且开始解析
        SoapObject object = (SoapObject) envelope.bodyIn;
        System.out.println("获得服务数据");
        result = object.getProperty(1).toString();
        handler.sendEmptyMessage(0x001);
        System.out.println("发送完毕,textview显示天气信息");
    }


    //定义一个获取号码归属地的方法:
    public void getland() {
        result = "";
        SoapObject soapObject = new SoapObject(AddressnameSpace, Addressmethod);
        soapObject.addProperty("mobileCode", edit_param.getText().toString());
        soapObject.addProperty("userid", "dbdf1580476240458784992289892b87");
        SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
        envelope.bodyOut = soapObject;
        envelope.dotNet = true;
        envelope.setOutputSoapObject(soapObject);
        HttpTransportSE httpTransportSE = new HttpTransportSE(Addressurl);
        //    System.out.println("号码信息设置完毕,准备开启服务");
        try {
            httpTransportSE.call(AddresssoapAction, envelope);
            //System.out.println("调用WebService服务成功");
        } catch (Exception e) {
            e.printStackTrace();
            //System.out.println("调用WebService服务失败");
        }

        //获得服务返回的数据,并且开始解析
        SoapObject object = (SoapObject) envelope.bodyIn;//System.out.println("获得服务数据");
        result = object.getProperty(0).toString();//System.out.println("获取信息完毕,向主线程发信息");
        handler.sendEmptyMessage(0x001);
        //System.out.println("发送完毕,textview显示天气信息");
    }


}

Также не забудьте импортировать пакет и разрешение на доступ в Интернет!

<uses-permission android:name="android.permission.INTERNET"/>

Скачать справочный код:

WebServiceDemo.zip:Скачать WebServiceDemo.zip


Итоги этого раздела:

На этом завершается раздел о том, как использовать WebService на стороне Android. В следующем разделе мы познакомимся с компонентом Android, похожим на браузер, — WebView. Оставайтесь с нами~ Спасибо~!