단축URL을 생성하는 안드로이드 앱 만들기1




안드로이드 기본을 배운 다음에는 구글플레이에 자신이 만든 앱을 직접 올려보는 것이 실력향상에 도움이 됩니다.
만들고 싶은 앱을 정한 다음 구현하고 싶은 기능들을 검색하면서 이것저것 시도해보는 것이 많은 도움이 됩니다.
간단한 앱을 만들어보면서 안드로이드에 대해 좀 더 알아보겠습니다.

단축 URL 앱 기능

이번 포스트에서는 단축 URL을 생성하는 앱을 만들어보겠습니다.
이 앱을 만들면서 배울 수 있는 것은 다음과 같습니다
  1. 네트워크 라이브러리 retrofit 사용 방법
  2. gson 사용 방법
  3. 네이버 API 사용 방법
셈플 앱은 아래 링크에서 받아볼 수 있습니다.

Get it on Google Play

단축 URL 앱의 기능은 크게 두 가지 입니다.
  1. 입력받은 URL을 API 호출해서 단축URL로 만들기
  2. 단축 URL을 클립보드로 복사하거나 다른 앱으로 공유하기
사용자 URL 입력화면
사용자 URL 입력화면
단축URL 생성 후 클립보드 또는 다른 앱으로 공유하기
단축URL 생성 후 클립보드 또는 다른 앱으로 공유하기

API 사용 신청하기

우선 단축 URL을 만들기 위해서는 네이버 API가 필요합니다.
네이버 개발자센터에 들어가보면 서비스 API 항목에 단축URL 소개가 있습니다.
네이버에서 제공하는 API로 하루에 25,000 요청을 지원해줍니다.
오픈 API 신청버튼을 클릭하여 애플리케이션 이름, 사용 API를 입력하는 페이지가 나옵니다.

네이버 API 신청 페이지
네이버 API 신청 페이지

애플리케이션 이름은 개발하려는 앱 이름을 입력합니다.
사용 API에는 단축 URL 서비스를 선택합니다.
비로그인 오픈 API 서비스 환경 -> 앱 패키지 이름은 프로젝트의 패키지명을 입력합니다.
등록이 완료되면 내 애플리케이션 항목에 앱이 추가되고 Client ID와 Client Secret을 찾을 수 있습니다.

발급받은 Client ID와 Client Secret 키는 네이버 API를 사용할 때 필요합니다.
APK 키들을 한곳에 모아두는 것이 개발하거나 유지 보수할 때 편리하므로 클래스를 만들어 상수들을 모아둡니다.



retrofit 네트워크 라이브러리로 네이버 API 사용하기

숏컷 URL을 생성하는 API를 사용하기 위해서 네트워크 라이브러리를 사용해 보겠습니다.
retrofit 네트워크 라이브러리를 사용할 것입니다.
애플리케이션 프로젝트의 build.gradle에 retrofit과 json 파서인 gson 을 dependencies에 추가합니다.



그리고 retrofit은 서비스라는 interface를 만들어야 합니다.
이 interface는 GET 요청할 URL과 URL 파라미터를 인수로 받을 수 있고 헤더 영역을 정의할 수 있습니다.
네이버 API는 헤더 영역에 client id와 client secret 키를 넣어서 요청해야 됩니다.
그러므로 이전에 상수를 모아두었던 static final 변수를 참조해서 헤더 영역을 정의해 줍니다.
"X-Naver-Client-Id:NaverConsts.CLIENT_ID", "X-Naver-Client-Secret:NaverConsts.CLIENT_SECRET" 처럼 @Headers 에 정의합니다.
@GET("/v1/util/shorturl")처럼 GET 요청으로 path 영역을 설정합니다.
getShortUrl(@Query("url") String url) 메소드를 만들어서 URL 파라메터로 @Query으로 파라메터를 변수로 입력받아 API의 전문을 만들어 줄수 있습니다.
retrofit은 https://openapi.naver.com/v1/util/shorturl?url="타겟URL"로 요청을 보냅니다.



응답받은 json 데이터는 retrofit이 gson 객체로 만들어줄 수 있습니다.
네이버 API 문서에 나와 있듯이 우리가 사용할 데이터는 단축 URL을 담은 url 변수입니다. 이 변수는 json의 result 객체 안에 존재합니다.
아래 코드는 데이터 객체의 전문입니다.



이제 retrofit을 사용하기 위한 준비는 다 끝났습니다.
Retrofit.Builder()를 이용하여 baseUrl을 설정하고 GsonConverterFactory를 설정하여 응답받은 json 문자열을 NaverService.class 로 자동 생성해주도록 설정합니다.


Retrofit.Builder()로 만들어진 객체로 위에서 만든 NaverService#loadShortUrl(url, callBack)을 호출할 수 있습니다.
loadShortUrl()를 호출하면 Call<ShortUrlResult>으로 Call객체가 생성됩니다.
Call#enqueue()를 호출하는 시점에 GET요청을 보냅니다.
enqueue()는 retrofit의 쓰레드풀으로 요청을 보내는 것으로 이 메서드를 사용할 경우 따로 쓰레드를 관리할 필요가 없습니다.
Callback은 응답이 완료됬을 때 호출되며 onResponse(..., Response<ShortUrlResult> response) 로 gson으로 변환된 객체를 받을 수 있습니다.
아래 코드에서는 response.body().getResult()으로 ShortUrlCallBack에 전달하여 단축URL을 다른 앱에 공유하거나 클립보드로 복사할 수 있습니다.
ShortUrlCallBack는 Activity에서 받기위해 만든 interface입니다.


다음장에서는...

이번 장에서는 네이버 단축 URL API 설정 방법과 retrofit을 이용한 네트워크 호출 방법을 설명했습니다.
다음 장에서는 응답받은 단축 URL을 클립보드로 복사하거나 다른 앱으로 공유하는 방법을 설명하겠습니다.
전체 소스는 2장에서 확인하실 수 있습니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

코틀린 (Kotlin) filter, map, all, any, count, find, groupBy, flatMap 함수 정리

filter 함수 filter 함수는 리스트를 이터레이션하면서 리턴이 true 인 값만 필터링합니다. var listInts = listOf(1,2,3,4) //filter listInts. filter { it % 2 == 0 } //출력 [2,4] map 함수 map 함수는 값을 변형해서 새로운 리스트를 생성합니다. var listInts = listOf(1,2,3,4) listInts. map { it * it } //출력 [1,4,9,16] val people = listOf(Person("A", 27), Person("B", 35), Person("C", 35)) listInts. map { it.name } //출력 [A, B, C] //심플한 방법 people. map (Person::name) //30살이상의 이름 출력 people. filter { it.age >= 30 }. map (Person::name) //가장 나이가 많은 사람들 모두 출력하기 //1. 최대값을 구하는 반복작업이 쓸데없이 많은 코드 people. filter { it.age == (people.maxBy(Person::age)!!.age) } //매번 maxBy 호출 //2. 계산이 중복되는것을 피하자. 람다안에 람다를 넣는것은 내부 로직을 매우 복잡하게 할 수 있음 val maxAge = people. maxBy (Person::age)!!.age //외부로 빼서 불필요한 반복 제거 people. filter { it.age == maxAge } //맵 사용 //map 에는 filterKeys, mapKeys 와 filterValues, mapValues 함수가 있음 val numbers = mapOf (0 to "zero", 1 to "one") val upperNumbers = numbers.ma
자세한 내용 보기

코틀린 (Kotlin) 인터페이스 정리

인터페이스 코틀린의 인터페이스는 자바와 같이 interface 로 시작합니다. interface Clickable {     fun click() } interface 를 구현할 때는 [클래스: 인터페이스] 형식으로 구현됩니다. extends(확장)과 implements(구현) 둘 다 :(콜론) 으로 구현합니다. 코틀린은 1개의 상속과 여러개의 인터페이스를 구현할 수 있습니다. 그리고 override 변경자를 사용해서 자바의 @Override 를 대신합니다. 만약에 override 된 함수 이름과 다른 함수 이름이 중복될경우 둘중 하나는 다른 이름을 사용해야 됩니다. //클래스 상속이나 구현은 : 으로 구분 class Button : Clickable, View { //Clickable은 interface, View 는 상속      override fun click() {           //구현시 override 필수     } } 디폴트 메소드 자바8 에서는 디폴트 메소드인경우 default 를 붙이지만 코틀린에서는 따로 추가되는 변경자가 없이 함수를 구현하면 됩니다. interface Clickable {     fun click()     fun showOff() = Log.d("Clickable showoff") //디폴트 메소드 } 디폴트 메소드는 override 를 하지않은 경우 디폴트로 사용되는 함수 입니다. 같은 함수 이름을 갖는 interface 디폴트 함수 이름이 같은 두개의 인터페이스를 구현해야되는 경우를 생각해봅니다. 디폴트 함수 이름이 같은 이름인 인터페이스를 정의하면 컴파일 에러 가 발생합니다. interface Clickable {     fun click()     fun showOff() = Log.d("Clickable showoff") } interface Focusable {     fu
자세한 내용 보기

코틀린 (Kotlin) object 키워드와 동반 객체 정리

코틀린 obeject 키워드 object 는 흔히 자바나 안드로이드에서 사용하는 무명 내부 클래스(anonymous inner class) 처럼 사용할 수 있습니다. object 키워드는 클래스를 정의하면서 객체를 생성 합니다. 코틀린 싱글턴 만들기 코틀린은 object 키워드를 이용해서 별다른 코드없이 싱글턴 구현을 지원합니다. 자바처럼 클래스를 만들고 static 객체로 한번만 할당해주는 코드가 object Payroll 이라고 클래스를 생성해 주기만하면 static 객체에 할당해주는 것을 자동으로 생성해줍니다. object Payroll { //object 클래스 생성으로 싱글턴을 구현     val allEmplyees = arrayListOf<Person> ()     fun calculateSalary() {         //...     } } //사용 Payroll.calculateSalary() //싱글턴처럼 . 으로 접근 Payroll.allEmplyees. add(Person( "zerog" , Company( "zerog" , Address( "" )))) object 생성자 object 객체는 주 생성자와 부 생성자 모두 사용할 수 없습니다. //ERROR!!! object 는 생성자를 사용할 수 없음 object Payroll(val a:String) {    ... } object 상속 object 객체는 상속이 가능합니다. 예를들어 멤버변수로 상태값을 저장하지않고 메소드만 override 하여 사용하는 클래스의 경우 object 로 상속을 받아 생성자없이 바로 사용가능하도록 만들수 있습니다. //object 로 구현한 경우 object CaseInsensitiveFileComparator: Comparator {     override fun compare(o1: File?, o2: F
자세한 내용 보기