안드로이드 네트워크 연결하기 (Network On Main Thread Exception 처리)

안드로이드에서 네트워크 연결하기 위해 자바에서처럼 코딩하면 십중팔구는 다음과 같은 오류 메시지를 만난다. 

android.os.NetworkOnMainThreadException

메시지를 살펴보면 Main Thread에서 네트워크를 호출하면서 발생한 오류라고 나온다. 

즉, 안드로이드에서 Main Thread에서는 네트워크 연결을 하지 못하도록 한 것이다. 

아마도 안드로이드 앱에서 네트워크 호출하면서 에러가 발생한 것을 사용자들이 안드로이드의 오류로 인식하기 때문에 그런 듯 하다. 

AsyncTask 쓰레드 클래스 이해

그럼 안드로이드에서는 어떻게 네트워크에 연결할 수 있을까? 

AsyncTask라는 쓰레드 클래스를 상속받아 네트워크 연결하는 부분을 만들면 된다. 

AsyncTask는 상속시 3개의 Generic Type의 매개변수가 필요한데, 

첫번째는 쓰레드를 실행하는 메소드(doInBackground)에서 사용할 매개변수이며,

두번째는 쓰레드가 업데이트될때마다 호출되는 메소드(onProgressUpdate)에서 사용할 Progress 이고, 

세번째는 쓰레드가 완료되면 실행되는 메소드(onPostExecute)에서 사용할 Result의 타입을 나타낸다.

AsyncTask에서 오버라이드할 수 있는 메소드를 호출 순서대로 나열하면 다음과 같다. 

onPreExecute() -> doInBackground(Params... params) -> 

onProgressUpdate(Progress... values) -> onPostExecute(Result result)

아래 살펴볼 예제에서는 간단하게 donInBackground에서 네트워크 연결을 하고, 

onPostExecute에서 화면에 출력하도록 구성했다. 

안드로이드 네트워크 연결 예제

인터넷 접근 권한 설정

먼저 앱에서 네트워크에 접속하기 위한 시스템 권한을 설정한다. 

AndroidManifest.xml 파일에 다음과 같이 설정하면 된다. 

가끔 아래 태그의 위치를 잘못 놓는 경우가 있는데, 부모 엘리먼트는 <manifest>라는 것을 꼭 기억해 두기 바란다. 

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

android.permission.INTERNET은 인터넷 접속을 위한 권한 설정이고, 

android.permission.ACCESS_NETWORK_STATE는 인터넷 접속이 가능한지 체크하기 위해 네트워크 상태를 볼 수 있는 권한이다. 

레이아웃 설정

예제를 위한 레이아웃을 다음과 같이 설정한다.  (activity_json.xml)

<LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context="kr.co.acronym.mini.JsonActivity"> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="서버 호출하기"/> <Button android:layout_width="wrap_content" android:layout_height="wrap_content" android:id="@+id/btnSend" android:layout_marginTop="10dp" android:text="SEND" android:onClick="sendData"/> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_marginTop="10dp" android:text="JSON 결과"/> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_marginTop="10dp" android:id="@+id/jsonData" /> </LinearLayout>

레이아웃은 단순하다. "SEND" 버튼을 클릭하면 웹으로 연결해서 결과값을 가져와서 맨 아래의 텍스트뷰에 뿌려주는 것이다.

SEND 버튼의 클릭 이벤트 처리를 위해서  18번째 줄에 android:onClick="sendData" 를 추가했다. 

액티비티 코딩

"SEND" 버튼을 클릭했을 때 처리를 다음과 같이 구성한다. (JsonActivity.java)

// Called when send button is clicked public void sendData(View view) { // set the server URL String url = "http://www.word.pe.kr/keyword/testJson.php"; // call data from web URL try { ConnectivityManager conManager = (ConnectivityManager)getSystemService(Context.CONNECTIVITY_SERVICE); NetworkInfo netInfo = conManager.getActiveNetworkInfo(); if (netInfo != null && netInfo.isConnected()) { new DownloadJson().execute(url); } else { Toast toast = Toast.makeText(getApplicationContext(), "Network isn't connected", Toast.LENGTH_LONG); toast.show(); } } catch (Exception e) { e.printStackTrace(); } }

12번째 줄을 보면 네트워크에 연결이 가능한지 살펴보고 난 후, 

13번째 줄에서 DownloadJson이라는 AsyncTask를 상속받은 쓰레드 클래스를 실행하고 있다. 

만약 인터넷 연결이 안되어 있을 경우, Toast로 메시지를 출력하도록 구성했다. 

참고로 데이터로 가져올 URL은 이전 강좌인 PHP를 활용하여 DB 내용을 JSON으로 출력하기 를 참고하기 바란다.

AsyncTask를 상속 받은 웹 연결 쓰레드 코딩

앞서 설명한 doInBackground와 onPostExecute를 오버라이딩해서 구현한 소스는 다음과 같다. 

private class DownloadJson extends AsyncTask<String,String,String> { @Override protected String doInBackground(String... arg0) { try { return (String)getData((String) arg0[0]); } catch (Exception e) { return "Json download failed"; } } protected void onPostExecute(String result) { mTextView.setText(result); } private String getData(String strUrl) { StringBuilder sb = new StringBuilder(); try { BufferedInputStream bis = null; URL url = new URL(strUrl); HttpURLConnection con = (HttpURLConnection) url.openConnection(); int responseCode; con.setConnectTimeout(3000); con.setReadTimeout(3000); responseCode = con.getResponseCode(); if (responseCode == 200) { bis = new BufferedInputStream(con.getInputStream()); BufferedReader reader = new BufferedReader(new InputStreamReader(bis, "UTF-8")); String line = null; while ((line = reader.readLine()) != null) sb.append(line); bis.close(); } } catch (Exception e) { e.printStackTrace(); } return sb.toString(); } }

doInBackground에서는 getData라는 메소드를 호출해서 인터넷 연결해서 데이터를 가져오도록 했다. 

onPostExecute에서는 가져온 데이터를 텍스트뷰에 출력하는 역할을 한다. 

참고로 getData 메소드를 살펴보면 연결을 위해 HTTPURLConnection을 사용하고 있다. 

예전에는 아파치의 HttpClient나 DefaultHttpClient를 사용했으나 허니컴 이후 deprecated 되었다. 

JsonActivity.java의 전체 소스는 다음과 같다. 

public class JsonActivity extends Activity { private TextView mTextView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_json); mTextView = (TextView)findViewById(R.id.jsonData); } @Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.menu_json, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { // Handle action bar item clicks here. The action bar will // automatically handle clicks on the Home/Up button, so long // as you specify a parent activity in AndroidManifest.xml. int id = item.getItemId(); //noinspection SimplifiableIfStatement if (id == R.id.action_settings) { return true; } return super.onOptionsItemSelected(item); } // Called when send button is clicked public void sendData(View view) { // set the server URL String url = "http://www.word.pe.kr/keyword/testJson.php"; // call data from web URL try { ConnectivityManager conManager = (ConnectivityManager)getSystemService(Context.CONNECTIVITY_SERVICE); NetworkInfo netInfo = conManager.getActiveNetworkInfo(); if (netInfo != null && netInfo.isConnected()) { new DownloadJson().execute(url); } else { Toast toast = Toast.makeText(getApplicationContext(), "Network isn't connected", Toast.LENGTH_LONG); toast.show(); } } catch (Exception e) { e.printStackTrace(); } } private class DownloadJson extends AsyncTask<String,String,String> { @Override protected String doInBackground(String... arg0) { try { return (String)getData((String) arg0[0]); } catch (Exception e) { return "Json download failed"; } } protected void onPostExecute(String result) { mTextView.setText(result); } private String getData(String strUrl) { StringBuilder sb = new StringBuilder(); try { BufferedInputStream bis = null; URL url = new URL(strUrl); HttpURLConnection con = (HttpURLConnection) url.openConnection(); int responseCode; con.setConnectTimeout(3000); con.setReadTimeout(3000); responseCode = con.getResponseCode(); if (responseCode == 200) { bis = new BufferedInputStream(con.getInputStream()); BufferedReader reader = new BufferedReader(new InputStreamReader(bis, "UTF-8")); String line = null; while ((line = reader.readLine()) != null) sb.append(line); bis.close(); } } catch (Exception e) { e.printStackTrace(); } return sb.toString(); } } }