Подключение к веб-сервисам с Android Wear

 https://www.worldtides.info/api?heights⪫=34.057&lon=151.152&length=21600&step=21600&key=af967f62-eb62-4574-b75e-a9056859055e 

Все, что вам нужно, это одно текущее значение, чтобы вернуться к носимым.

Подготовка к вызову API и заполнению данных

Прежде чем вы сможете подключиться к API, вам нужно создать конечную конечную точку, URL-адрес, загруженный при попытке собрать данные. Чтобы сделать процесс более чистым, добавьте новый класс APIInformation который будет обрабатывать установку и получение свойств.

 /*Class that holds information for API call*/ public class APIInformation { private String APIEndpoint; private Map<String, String> APIArguments = new HashMap<>(); private String APIUrl; //endpoint (main url to the target API) public void setAPIEndpoint(String endpoint){ this.APIEndpoint = endpoint; } public String getAPIEndpoint(){ return APIEndpoint; } //set a single API argument to the arg list public void setAPIArgument(String key, String value){ this.APIArguments.put(key, value); } //gets a single API argument from the arg list public String getAPIArgument(String key){ String value = APIArguments.get(key); return value; } //set a bunch of API arguments to the arg list public void setAPIArguments(HashMap<String, String> arguments){ this.APIArguments = arguments; } //gets all the API arguments as a HashMap public Map<String, String> getAPIArguments(){ return APIArguments; } //creates the final API url based on endpoint, key and arguments public void setAPIUrl(){ StringBuilder builder = new StringBuilder(); builder.append(this.APIEndpoint); //loop through all arguments Map<String,String> arguments = this.getAPIArguments(); if(arguments.size() != 0){ Integer counter = 1; builder.append("?"); for ( Map.Entry<String, String> entry : arguments.entrySet()){ String key = entry.getKey(); String value = entry.getValue(); //check for empty keys or values (some arguments don't need values passed) if(value.isEmpty() && !key.isEmpty()){ builder.append(key); }else{ builder.append(key + "=" + value); } if(counter != arguments.size()){ builder.append("&"); } counter++; } } this.APIUrl = builder.toString(); } //gets the final API url to call public String getAPIUrl(){ return this.APIUrl; } } 

Класс обрабатывает создание конечной конечной точки API путем сложения всех переданных аргументов и объединения их с базой API. Более простым способом было бы жестко закодировать окончательный URL, чтобы обойти необходимость в другом классе. Хотя это будет работать, целью отдельного класса является создание наборов информации для выполнения ряда других подключений к API. Например, вам может понадобиться собрать все ближайшие станции отчетности, а затем получить их прогнозируемые приливные высоты за день.

Для примера создайте новый метод с именем setUpAPIInformation внутри MainActivity который заполнит новый объект APIInformation .

 //populates information for API protected APIInformation setUpAPIInformation(){ APIInformation apiInformation = new APIInformation(); apiInformation.setAPIEndpoint("http://www.worldtides.info/api"); HashMap arguments = new HashMap<String, String>(); arguments.put("key", "1d3d0a79-5d7d-48d3-9e80-a5383e53eba2"); arguments.put("heights",""); //we want the heights only arguments.put("lat", "-34.057440"); //cronulla sydney arguments.put("lon", "151.152190"); //cronulla sydney arguments.put("step", "21600"); //6 hours arguments.put("length", "21600"); //6 hours //determine the next time period (after right now) Long currentTime = System.currentTimeMillis(); String time = String.valueOf(currentTime / 1000L); arguments.put("start", time); apiInformation.setAPIArguments(arguments); apiInformation.setAPIUrl(); return apiInformation; } 

Еще лучше то, что вы получаете следующий период прилива, добавляя текущую системную дату в API.

Когда все эти параметры будут готовы, выполните их внутри пользовательской AsyncTask чтобы подключиться к API и получить информацию.

Подключение к API с помощью асинхронной задачи

Чтобы не блокировать пользовательский интерфейс, необходимо выполнить запрос API в фоновом потоке.

Вы можете использовать класс AsyncTask для выполнения задач в фоновом потоке. Вы не используете AsyncTask напрямую, а расширяете свой собственный класс. Чтобы упростить процесс, создайте класс APIAsyncTask как внутренний класс MainActivity , это обеспечит легкий доступ к пользовательскому интерфейсу для обновлений.

Обсуждение AsyncTask — это целая тема, но в ее основе лежат три важных метода:

• OnPreExecute : не используется в этом примере
• doInBackground : выполняет фоновый поток и подключается к API, получая информацию для обработки.
• OnPostExecute : OnPostExecute после завершения фоновой задачи. Здесь вы собираете данные из API, формируете ответное сообщение с помощью DataApi и отправляете его в сеть Google Play для сбора.

 //main async task to connect to API and collect a response public class APIAsyncTask extends AsyncTask<APIInformation, String, HashMap> { //execute before we start protected void onPreExecute() { super.onPreExecute(); } //execute background task protected HashMap doInBackground(APIInformation... params) { APIInformation apiInformation = params[0]; boolean isOnline = isOnline(); HashMap result; if(isOnline()){ //perform a HTTP request APIUrlConnection apiUrlConnection = new APIUrlConnection(); //get the result back and process result = apiUrlConnection.GetData(apiInformation.getAPIUrl()); }else{ //we're not online, flag the error Log.d("debug", "Error, not currently online, cant connect to API"); result = new HashMap(); result.put("type", "failure"); result.put("data", "Not currrently online, can't connect to API"); } return result; } //update progress protected void onProgressUpdate(String... values) { super.onProgressUpdate(values); } //Execute once we're done protected void onPostExecute(HashMap result) { super.onPostExecute(result); //build message back to the wearable (either with data or a failure message) PutDataMapRequest putDataMapRequest = PutDataMapRequest.create("/responsemessage"); putDataMapRequest.getDataMap().putLong("time", new Date().getTime()); //success (we collected data from the API) if(result.get("type") == "success"){ //get the json response data string String data = (String) result.get("data"); //create a new json object try{ JSONObject jsonObject = new JSONObject(data); if(jsonObject.has("heights")){ JSONArray heights = (JSONArray) jsonObject.get("heights"); //loop through all 'heights' objects to get data for(int i = 0; i < heights.length(); i++){ JSONObject heightObject = heights.getJSONObject(i); Integer unixTime = Integer.parseInt(heightObject.getString("dt")); String height = heightObject.getString("height"); //need to process the values to make them readable. String heightTrimmed = height.substring(0, 5); //convert date unix string to a human readable format Date date = new Date(unixTime * 1000L); DateFormat format = new SimpleDateFormat("dd/MM/yyyy hh:mm a"); String dateFormatted = format.format(date); //add data to be passed back to the wearable putDataMapRequest.getDataMap().putString("unixTime", dateFormatted); putDataMapRequest.getDataMap().putString("height", heightTrimmed); } }else{ Log.d("error", "there was no height parm returned from the API"); putDataMapRequest.getDataMap().putString("error", "There was an issue processing the JSON object returned from API"); } }catch(Exception e){ Log.d("error", "error creating the json object: " + e.getMessage()); putDataMapRequest.getDataMap().putString("error", "There was an issue processing the JSON object returned from API"); } } //failure (couldn't connect to the API or collect data) else if(result.get("type") == "failure"){ Log.d("error", "There was an issue connecting to the API."); putDataMapRequest.getDataMap().putString("error", result.get("error").toString()); } //finalise message and send it off (either success or failure) PutDataRequest putDataRequest = putDataMapRequest.asPutDataRequest(); putDataRequest.setUrgent(); PendingResult<DataApi.DataItemResult> pendingResult = Wearable.DataApi.putDataItem(googleClient, putDataRequest); } } 

Внутри метода doInBackgroundTask используйте класс APIUrlConnection для подключения к конечной конечной точке API.

 APIUrlConnection apiUrlConnection = new APIUrlConnection(); result = apiUrlConnection.GetData(apiInformation.getAPIUrl()); 

Соберите информацию или сообщение об ошибке и передайте его в метод onPreExecute для обработки.

Когда вы возвращаетесь из метода GetData , у вас есть хэш-карта с двумя ключами. Первый ключ, type , представляет, если нам удалось или не удалось подключиться к API. Второй ключ, data , содержит либо сообщение об ошибке, либо длинную строку возвращаемого содержимого в кодировке JSON для дальнейшего уточнения.

Получение ответа API с помощью HttpUrlConnection

Как только вы получите конечную точку API, вы можете начать соединение. Для подключения к веб-службам Android предоставляет класс HttpUrlConnection в сочетании с объектом BufferedReader для извлечения данных. Этот процесс будет извлекать результат из API символ за символом и строка за строкой, пока не останется больше информации для чтения. Получив всю информацию, вы можете передать ее в метод AsyncTask для обработки и преобразования в объект JSON.

 /*takes an API request (url) and performs it*/ public class APIUrlConnection { //gets data based on URL, passed back something public HashMap GetData(String url){ HashMap result = new HashMap<String, String>(); BufferedReader bufferedReader = null; try{ //use the URL to create a new connection and read content URL APIUrl = new URL(url); HttpURLConnection httpURLConnection = (HttpURLConnection) APIUrl.openConnection(); StringBuilder stringBuilder = new StringBuilder(); bufferedReader = new BufferedReader(new InputStreamReader(httpURLConnection.getInputStream())); int responseCode = httpURLConnection.getResponseCode(); String responseMessage = httpURLConnection.getResponseMessage(); String line; while ((line = bufferedReader.readLine()) != null){ stringBuilder.append(line); } //add back result data result.put("type", "success"); result.put("data", stringBuilder.toString()); }catch(Exception e){ e.printStackTrace(); //return error result.put("type", "failure"); result.put("data", "there was an error reading in data from the API: " + e.getMessage()); }finally { //close input steam and finish if(bufferedReader != null){ try{ bufferedReader.close(); } catch(Exception e){ e.printStackTrace(); } } } return result; } } 

Преобразование результата в JSON и обработка

Следующий этап — преобразование строки JSON в объект. JSONObect элемент верхнего уровня в объект с помощью JSONObect .Поскольку это может потенциально иметь несколько возвращенных наборов информации внутри этого объекта, вам необходимо преобразовать промежуточные результаты в JSONArray. Затем выполните цикл по каждому из результатов, чтобы извлечь информацию о приливе.

  try{ JSONObject jsonObject = new JSONObject(data); if(jsonObject.has("heights")){ JSONArray heights = (JSONArray) jsonObject.get("heights"); //loop through all 'heights' objects to get data for(int i = 0; i < heights.length(); i++){ //get the specific object from the set JSONObject heightObject = heights.getJSONObject(i); //get time and height values Integer unixTime = Integer.parseInt(heightObject.getString("dt")); String height = heightObject.getString("height"); } } }catch(Exception e){ //error processing } 

Именно с этого момента вы имеете дело непосредственно с источником API. Этот процесс будет заметно отличаться в зависимости от того, что предоставляет API. Обычно они предоставляют документацию по ответам, чтобы вы могли понять, как обрабатывать данные.

В этом случае вы собираете информацию о дате и высоте следующей волны. Вам дается дата в необработанном формате Unix и высота в виде длинного целого числа, поэтому вам нужно уточнить их оба во что-то полезное, чтобы потом вернуться к носимым.

Передача информации обратно в носимый

Как только вы преобразовали информацию, добавьте их к putDataMapRequestобъекту, готовому отправить обратно на носимый предмет. У вас должна быть строка даты и высота над уровнем моря для периода прилива. Оба из них будут переданы в носимый через DataApi и putStringметод

 //add data to be passed back to the wearable putDataMapRequest.getDataMap().putString("unixTime", dateFormatted); putDataMapRequest.getDataMap().putString("height", heightTrimmed); 

Теперь отправьте элемент данных, готовый к тому, чтобы он был собран с носимого устройства.

 //finalise message and send it off (either success or failure) PutDataRequest putDataRequest = putDataMapRequest.asPutDataRequest(); putDataRequest.setUrgent(); PendingResult<DataApi.DataItemResult> pendingResult = Wearable.DataApi.putDataItem(googleClient, putDataRequest); 

Следующие шаги с Android Wear

По мере развития платформ подключение к веб-сервисам и обработка микроданных станут основными составляющими носимого опыта. По мере того, как все больше людей будут пользоваться носимыми устройствами и IoT в целом, появится целый ряд великолепных новых аппаратных устройств, которые в полной мере используют Интернет.

В то время как приложение занимается только извлечением приливных данных, вы можете адаптировать концепции к любому веб-сервису. Возможно, вы захотите создать приложение, которое подключается к информации о расписании, чтобы планировать и координировать расписание поездов (с уведомлениями и вибрациями, чтобы вы никогда не опоздали на поезд). Носимые устройства имеют преимущество, заключающееся в предоставлении самых необходимых вещей, а это означает, что пользователь, как правило, находится на расстоянии одного клика от данных.

Если вы заинтересованы в разработке Android Wear, есть несколько способов расширить идеи, которые я использовал в этом руководстве.

• Реализуйте службу прослушивания для мобильных устройств и макетов износа, чтобы ни один из них не был открыт для синхронизации данных.
• Вытащите диапазон содержимого и предоставьте прокручиваемый список информации. Например диапазон периодов прилива с простым графиком.
• Предварительно получить информацию о загрузке. Вы можете хранить свои результаты, чтобы иметь к ним доступ в автономном режиме без необходимости подключения к мобильному телефону для получения новой информации.
• Воспользуйтесь расширенными уведомлениями и носимыми специальными функциями, чтобы сделать ваше приложение более интерактивным.

Если у вас есть какие-либо вопросы или комментарии, я хотел бы услышать их ниже .