레이아웃 및 바인딩 수식

표현식 언어를 사용하면 전달된 이벤트를 처리하는 표현식을 작성할 수 있습니다. 조회수 기준 데이터 결합 라이브러리는 필요한 클래스를 자동으로 생성하며 을 사용하여 레이아웃의 뷰를 데이터 객체와 결합할 수 있습니다.

데이터 결합 레이아웃 파일은 약간 다르며 layout, data 요소와 view 루트 요소가 뒤따릅니다. 현재 보기 요소는 결합되지 않은 레이아웃 파일에 있는 루트입니다. 다음 코드는 샘플 레이아웃 파일을 보여줍니다.

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
   <data>
       <variable name="user" type="com.example.User"/>
   </data>
   <LinearLayout
       android:orientation="vertical"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.firstName}"/>
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.lastName}"/>
   </LinearLayout>
</layout>

data 내의 user 변수는 이 레이아웃:

<variable name="user" type="com.example.User" />

레이아웃 내의 표현식은 @{} 문법 다음 예에서 TextView 텍스트가 user 변수의 firstName 속성:

<TextView android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="@{user.firstName}" />

데이터 객체

User 항목을 설명하는 일반 객체가 있다고 가정해 보겠습니다.

Kotlin

data class User(val firstName: String, val lastName: String)

자바


public class User {
  public final String firstName;
  public final String lastName;
  public User(String firstName, String lastName) {
      this.firstName = firstName;
      this.lastName = lastName;
  }
}

이 유형의 객체에는 변경되지 않는 데이터가 있습니다. 앱에서는 일반적으로 한 번 읽은 후에는 변경되지 않는 데이터입니다. 또한 일련의 규칙을 따르는 객체(예: 다음 예와 같이 Java 프로그래밍 언어로 코드를 작성합니다.

Kotlin

// Not applicable in Kotlin.
data class User(val firstName: String, val lastName: String)

자바

public class User {
  private final String firstName;
  private final String lastName;
  public User(String firstName, String lastName) {
      this.firstName = firstName;
      this.lastName = lastName;
  }
  public String getFirstName() {
      return this.firstName;
  }
  public String getLastName() {
      return this.lastName;
  }
}

데이터 결합의 관점에서 이러한 두 클래스는 동등합니다. 이 다음 표현식에 사용된 @{user.firstName} 표현식 android:text 속성은 이전 클래스의 firstName 필드에 액세스하고 getFirstName() 메서드를 호출합니다. 또한 firstName(): 이 메서드가 있는 경우.

데이터 결합

각 레이아웃 파일의 결합 클래스가 생성됩니다. 기본적으로 클래스는 레이아웃 파일의 이름을 기반으로 하며 파스칼 표기법으로 변환됩니다. Binding 서픽스가 추가되었습니다. 예를 들어 앞의 레이아웃 파일 이름은 activity_main.xml, 이에 상응하는 생성된 결합 클래스는 다음과 같습니다. ActivityMainBinding

이 클래스는 레이아웃 속성의 모든 결합을 보유합니다. 예를 들면 user 변수: 레이아웃의 뷰에 값을 할당하고 값을 할당하는 방법을 알고 있음 를 사용합니다. 확장하는 동안 결합을 만드는 것이 좋습니다. 다음과 같이 레이아웃을 지정할 수 있습니다.

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    val binding: ActivityMainBinding = DataBindingUtil.setContentView(
            this, R.layout.activity_main)

    binding.user = User("Test", "User")
}

자바

@Override
protected void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
   User user = new User("Test", "User");
   binding.setUser(user);
}

런타임 시 앱은 UI에 Test 사용자를 표시합니다. 또는 다음 작업을 수행할 수 있습니다. ViewModel을 사용하여 LayoutInflater 다음 예를 참고하세요.

Kotlin

val binding: ActivityMainBinding = ActivityMainBinding.inflate(getLayoutInflater())

자바

ActivityMainBinding binding = ActivityMainBinding.inflate(getLayoutInflater());

클래스 내에서 데이터 결합 항목을 사용하는 경우 Fragment님, ListView 또는 RecyclerView 이 경우 네트워크 연결 시에는 inflate() 결합 클래스의 메서드 또는 DataBindingUtil 클래스에 다음 코드 예를 참고하세요.

Kotlin

val listItemBinding = ListItemBinding.inflate(layoutInflater, viewGroup, false)
// or
val listItemBinding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false)

자바

ListItemBinding binding = ListItemBinding.inflate(layoutInflater, viewGroup, false);
// or
ListItemBinding binding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false);

표현식 언어

일반적인 기능

표현식 언어는 관리형 코드에서 볼 수 있는 표현식과 매우 비슷합니다. 나 표현식 언어에 다음 연산자와 키워드를 사용할 수 있습니다.

  • 수학: + - / * %
  • 문자열 연결: +
  • 논리: && ||
  • 바이너리: & | ^
  • 단항: + - ! ~
  • 변경: >> >>> <<
  • 비교: == > < >= <= (<&lt;로 이스케이프 처리해야 함)
  • instanceof
  • 그룹화: ()
  • 리터럴(예: 문자, 문자열, 숫자, null)
  • 전송
  • 메서드 호출
  • 필드 액세스
  • 배열 액세스: []
  • 삼항 연산자: ?:

다음은 몇 가지 예입니다.

android:text="@{String.valueOf(index + 1)}"
android:visibility="@{age > 13 ? View.GONE : View.VISIBLE}"
android:transitionName='@{"image_" + id}'

누락된 연산자

사용할 수 있는 표현식 구문에서 다음 연산이 누락되었습니다. :

  • this
  • super
  • new
  • 명시적 제네릭(Generic) 호출

Null 병합 연산자

null 병합 연산자 (??)는 왼쪽 피연산자가 null가 아니면 이 피연산자를 선택합니다. 전자가 null인 경우 오른쪽을 반환합니다.

android:text="@{user.displayName ?? user.lastName}"

기능적으로는 다음과 같습니다.

android:text="@{user.displayName != null ? user.displayName : user.lastName}"

속성 참조

표현식은 다음 형식을 사용하여 클래스의 속성을 참조할 수 있습니다. 이는 필드, getter, ObservableField 드림 객체:

android:text="@{user.lastName}"

null 포인터 예외 방지

생성된 데이터 결합 코드는 자동으로 null 값을 확인하고 null 포인터 예외입니다. 예를 들어 @{user.name} 표현식에서 user이 null이면 user.name에는 null의 기본값이 할당됩니다. 만약 age의 유형이 intuser.age를 참조한 경우 데이터 결합은 기본값은 0입니다.

뷰 참조

표현식은 다음을 사용하여 ID로 레이아웃의 다른 뷰를 참조할 수 있습니다. 구문:

android:text="@{exampleText.text}"

다음 예에서 TextView 뷰는 다음 위치에서 EditText 뷰를 참조합니다. 다음과 같습니다.

<EditText
    android:id="@+id/example_text"
    android:layout_height="wrap_content"
    android:layout_width="match_parent"/>
<TextView
    android:id="@+id/example_output"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@{exampleText.text}"/>

컬렉션

배열, 목록, 희소 목록 및 편의상 [] 연산자를 사용합니다.

<data>
    <import type="android.util.SparseArray"/>
    <import type="java.util.Map"/>
    <import type="java.util.List"/>
    <variable name="list" type="List&lt;String>"/>
    <variable name="sparse" type="SparseArray&lt;String>"/>
    <variable name="map" type="Map&lt;String, String>"/>
    <variable name="index" type="int"/>
    <variable name="key" type="String"/>
</data>
...
android:text="@{list[index]}"
...
android:text="@{sparse[index]}"
...
android:text="@{map[key]}"

또한 object.key 표기법을 사용하여 맵의 값을 참조할 수도 있습니다. 대상 예를 들어 앞의 예의 @{map[key]}@{map.key}

문자열 리터럴

속성 값을 작은따옴표로 묶을 수 있습니다. 이렇게 하면 다음 예와 같이 표현식에 큰따옴표를 사용합니다.

android:text='@{map["firstName"]}'

큰따옴표를 사용하여 속성 값을 묶을 수도 있습니다. 이 때 문자열 리터럴은 다음과 같이 백틱 `로 묶어야 합니다. 여기:

android:text="@{map[`firstName`]}"

리소스

표현식은 다음 구문을 사용하여 앱 리소스를 참조할 수 있습니다.

android:padding="@{large? @dimen/largePadding : @dimen/smallPadding}"

다음과 같이 매개변수를 제공하여 형식 문자열과 복수형을 평가할 수 있습니다.

android:text="@{@string/nameFormat(firstName, lastName)}"
android:text="@{@plurals/banana(bananaCount)}"

속성 참조속성 보기 참조를 리소스 매개변수로 사용합니다.

android:text="@{@string/example_resource(user.lastName, exampleText.text)}"

복수형이 여러 매개변수를 사용하면 다음과 같이 모든 매개변수를 전달합니다.


  Have an orange
  Have %d oranges

android:text="@{@plurals/orange(orangeCount, orangeCount)}"

일부 리소스에는 다음과 같이 명시적 유형 평가가 필요합니다. 표:

유형 일반 참조 표현식 참조
String[] @array @stringArray
int[] @array @intArray
TypedArray @array @typedArray
Animator @animator @animator
StateListAnimator @animator @stateListAnimator
color int @color @color
ColorStateList @color @colorStateList

이벤트 처리

데이터 결합을 사용하면 예를 들어 onClick() 드림 메서드를 사용하여 축소하도록 요청합니다. 이벤트 속성 이름은 리스너 메서드의 이름, 몇 가지 예외가 있습니다 예를 들어 View.OnClickListener님이 onClick() 메서드이므로 이 이벤트의 속성은 android:onClick입니다.

클릭 이벤트를 위한 몇 가지 특수한 이벤트 핸들러는 속성을 사용하여 충돌을 피하세요.android:onClick 이 다음 속성을 사용하여 이러한 유형의 충돌을 방지하세요.

클래스 리스너 setter 속성
SearchView setOnSearchClickListener(View.OnClickListener) android:onSearchClick
ZoomControls setOnZoomInClickListener(View.OnClickListener) android:onZoomIn
ZoomControls setOnZoomOutClickListener(View.OnClickListener) android:onZoomOut

이 두 가지 메커니즘을 사용할 수 있습니다. 자세한 내용은 다음과 같이 이벤트를 처리합니다.

  • 메서드 참조: 표현식에서 다음을 수행할 수 있습니다. 리스너 메서드의 서명을 준수하는 참조 메서드를 호출합니다. 날짜 표현식이 메서드 참조로 평가되면 데이터 결합이 메서드를 래핑함 참조 및 소유자 객체를 만들고 타겟 뷰로 이동합니다. 표현식이 null로 평가되면 데이터 결합은 실행되지 않습니다. 대신 리스너를 만들고 null 리스너를 설정합니다.
  • 리스너 결합: 다음과 같은 람다 표현식입니다. 이벤트가 발생할 때 평가됩니다. 데이터 결합은 항상 리스너이며, 이는 뷰에서 설정합니다. 이벤트가 전달되면 리스너는 람다 표현식을 평가합니다.

메서드 참조

이벤트에서 직접 이벤트를 바인딩할 수 있습니다. 할당하다 android:onClick(으)로 메서드를 사용할 수 있습니다. 한 가지 장점은 View onClick 속성의 경우 표현식은 컴파일 시간에 처리됩니다. 따라서 메서드가 존재하지 않거나 서명이 올바르지 않으면 컴파일 시간 오류가 발생합니다.

메서드 참조와 리스너 결합의 주요 차이점은 실제 리스너 구현은 데이터가 바인딩될 때 생성됩니다. 이벤트가 트리거됩니다 이벤트가 리스너 결합을 사용하세요.

이벤트를 핸들러에 할당하려면 값은 호출할 메서드 이름입니다. 예를 들어 다음 예시를 살펴보세요. 레이아웃 데이터 객체:

Kotlin

class MyHandlers {
    fun onClickFriend(view: View) { ... }
}

자바

public class MyHandlers {
    public void onClickFriend(View view) { ... }
}

결합 표현식은 뷰의 클릭 리스너를 onClickFriend() 메서드를 사용해야 합니다.

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
   <data>
       <variable name="handlers" type="com.example.MyHandlers"/>
       <variable name="user" type="com.example.User"/>
   </data>
   <LinearLayout
       android:orientation="vertical"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.firstName}"
           android:onClick="@{handlers::onClickFriend}"/>
   </LinearLayout>
</layout>

리스너 결합

리스너 결합은 이벤트가 발생할 때 실행되는 결합 표현식입니다. 그들은 메서드 참조와 비슷하지만 임의의 데이터 결합을 실행할 수 있습니다. 식을 사용할 수 있습니다. 이 기능은 Gradle용 Android Gradle 플러그인에서 사용할 수 있습니다. 버전 2.0 이상이 필요합니다.

메서드 참조에서 메서드의 매개변수는 이벤트 리스너 리스너 결합에서는 반환 값만 void를 예상하지 않는 한 리스너의 예상 반환 값입니다. 대상 예를 들어 onSaveClick()가 있는 다음 프레젠터 클래스를 고려해 보세요. 메서드를 사용하여 축소하도록 요청합니다.

Kotlin

class Presenter {
    fun onSaveClick(task: Task){}
}

자바

public class Presenter {
    public void onSaveClick(Task task){}
}

다음과 같이 클릭 이벤트를 onSaveClick() 메서드에 결합할 수 있습니다.

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable name="task" type="com.android.example.Task" />
        <variable name="presenter" type="com.android.example.Presenter" />
    </data>
    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent">
        <Button android:layout_width="wrap_content" android:layout_height="wrap_content"
        android:onClick="@{() -> presenter.onSaveClick(task)}" />
    </LinearLayout>
</layout>

표현식에 콜백이 사용되면 데이터 결합이 자동으로 이벤트를 위해 등록합니다. 뷰가 이벤트가 발생하면 데이터 결합은 지정된 표현식을 평가합니다. 일반 바인딩과 동일 표현식의 경우 데이터 결합의 null 및 스레드 안전성을 얻고 리스너 표현식이 평가되고 있습니다.

앞의 예에서 onClick(View)에 전달되는 view 매개변수는 정의되지 않은 경우 발생합니다. 리스너 결합에서는 두 가지로 리스너 매개변수를 선택할 수 있습니다. 메서드의 모든 매개변수를 무시하거나 모든 매개변수의 이름을 지정할 수 있습니다. 원하는 경우 표현식에 이를 사용할 수 있습니다. 예를 들어 위 표현식을 다음과 같이 작성할 수 있습니다.

android:onClick="@{(view) -> presenter.onSaveClick(task)}"

표현식에 매개변수를 사용하려면 다음과 같이 할 수 있습니다.

Kotlin

class Presenter {
    fun onSaveClick(view: View, task: Task){}
}

자바

public class Presenter {
    public void onSaveClick(View view, Task task){}
}

android:onClick="@{(theView) -> presenter.onSaveClick(theView, task)}"

그리고 두 개 이상의 매개변수와 함께 람다 표현식을 사용할 수 있습니다.

Kotlin

class Presenter {
    fun onCompletedChanged(task: Task, completed: Boolean){}
}

자바

public class Presenter {
    public void onCompletedChanged(Task task, boolean completed){}
}

<CheckBox android:layout_width="wrap_content" android:layout_height="wrap_content"
      android:onCheckedChanged="@{(cb, isChecked) -> presenter.completeChanged(task, isChecked)}" />

수신 중인 이벤트가 void가 아닌 유형의 값을 반환하면 표현식도 동일한 유형의 값을 반환해야 합니다. 예를 들어 터치와 터치를 듣고 이벤트를 보류하는 경우 표현식은 부울입니다.

Kotlin

class Presenter {
    fun onLongClick(view: View, task: Task): Boolean { }
}

자바

public class Presenter {
    public boolean onLongClick(View view, Task task) { }
}

android:onLongClick="@{(theView) -> presenter.onLongClick(theView, task)}"

null 객체로 인해 표현식을 계산할 수 없으면 데이터 결합이 반환됩니다. 해당 유형의 기본값(예: 참조 유형의 경우 null,0 int 또는 boolean의 경우 false입니다.

조건자가 있는 표현식(예: 3항 - void를 기호로 사용할 수 있습니다.

android:onClick="@{(v) -> v.isVisible() ? doSomething() : void}"

복잡한 리스너 방지

리스너 표현식은 강력하며 코드를 더 쉽게 읽을 수 있습니다. 일 반면 복잡한 표현식이 포함된 리스너는 레이아웃을 더 어렵게 만듭니다. 읽기 및 유지보수가 가능합니다 사용 가능한 데이터를 전달하는 것처럼 표현식을 단순하게 유지 콜백 메서드로 전달됩니다. 비즈니스 로직을 콜백 메서드를 호출합니다.

가져오기, 변수 및 포함

데이터 결합 라이브러리는 가져오기, 변수 및 포함할 수 있습니다. 가져오기를 통해 레이아웃 파일 내에서 쉽게 참조할 수 있는 클래스를 만들 수 있습니다. 변수를 사용하면 결합 표현식에 사용할 수 있는 속성을 설명할 수 있습니다. 포함을 사용하면 앱 전체에서 복잡한 레이아웃을 재사용할 수 있습니다.

가져오기

가져오기를 사용하면 관리형 코드에서처럼 레이아웃 파일 내에서 클래스를 참조할 수 있습니다. data 요소 내에서 0개 이상의 import 요소를 사용할 수 있습니다. 이 다음 코드 예에서는 View 클래스를 레이아웃 파일로 가져옵니다.

<data>
    <import type="android.view.View"/>
</data>

View 클래스를 가져오면 결합 표현식에서 참조할 수 있습니다. 다음 예는 VISIBLEView 클래스의 GONE 상수:

<TextView
   android:text="@{user.lastName}"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:visibility="@{user.isAdult ? View.VISIBLE : View.GONE}"/>

유형 별칭

클래스 이름이 충돌하는 경우 클래스 중 하나의 이름을 별칭입니다. 다음 예는 View 클래스의 이름을 com.example.real.estate 패키지를 Vista에 추가합니다.

<import type="android.view.View"/>
<import type="com.example.real.estate.View"
        alias="Vista"/>

그런 다음 Vista를 사용하여 com.example.real.estate.ViewView를 참조할 수 있습니다. 레이아웃 파일 내에서 android.view.View를 참조합니다.

다른 클래스 가져오기

가져온 유형을 변수와 표현식에서 유형 참조로 사용할 수 있습니다. 이 다음 예는 변수 유형으로 사용되는 UserList를 보여줍니다.

<data>
    <import type="com.example.User"/>
    <import type="java.util.List"/>
    <variable name="user" type="User"/>
    <variable name="userList" type="List&lt;User>"/>
</data>

가져온 유형을 사용하여 표현식의 일부를 변환할 수 있습니다. 다음 다음 예는 connection 속성을 User 유형으로 변환합니다.

<TextView
   android:text="@{((User)(user.connection)).lastName}"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

또한 식을 사용할 수 있습니다. 다음 코드는 MyStringUtils 클래스 및 참조를 가져옵니다. capitalize 메서드:

<data>
    <import type="com.example.MyStringUtils"/>
    <variable name="user" type="com.example.User"/>
</data>
…
<TextView
   android:text="@{MyStringUtils.capitalize(user.lastName)}"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

관리형 코드에서와 마찬가지로 java.lang.*을 자동으로 가져옵니다.

변수

data 요소 내에서 여러 variable 요소를 사용할 수 있습니다. 각 variable 요소는 사용할 레이아웃에 설정할 수 있는 속성을 설명 을 사용합니다. 다음 예는 user, image, note 변수:

<data>
    <import type="android.graphics.drawable.Drawable"/>
    <variable name="user" type="com.example.User"/>
    <variable name="image" type="Drawable"/>
    <variable name="note" type="String"/>
</data>

변수 유형은 컴파일 시간에 검사되므로 변수가 Observable 또는 관측 가능한 컬렉션, 유형에 반영되어야 합니다. 변수가 기본 클래스 또는 인터페이스인 경우 Observable 인터페이스를 구현하지 않는 경우 변수는 아닙니다. 확인할 수 있습니다

다양한 구성 (예: 가로 모드 또는 세로 모드) 변수가 결합됩니다. 포함해서는 안 됩니다. 변수 정의가 충돌합니다.

생성된 바인딩 클래스에는 설명된 각 클래스의 setter 및 getter가 있습니다. 변수로 사용할 수 있습니다. 변수는 setter가 호출될 때까지 기본 관리형 코드 값을 사용합니다. 호출: 참조 유형의 경우 null, int의 경우 0, 다음의 경우 false boolean

결합 표현식에 사용하기 위해 context라는 이름의 특수 변수가 생성됩니다. 변경할 수 있습니다 context의 값은 Context 객체를 getContext() 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 이 context 변수가 다음과 같은 명시적 변수 선언으로 재정의됨 있습니다.

포함

포함하는 속성에 앱 네임스페이스와 변수 이름을 사용하여 레이아웃을 지정합니다. 이 다음 예는 username.xml contact.xml 레이아웃 파일:

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:bind="http://schemas.android.com/apk/res-auto">
   <data>
       <variable name="user" type="com.example.User"/>
   </data>
   <LinearLayout
       android:orientation="vertical"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
       <include layout="@layout/name"
           bind:user="@{user}"/>
       <include layout="@layout/contact"
           bind:user="@{user}"/>
   </LinearLayout>
</layout>

데이터 결합은 include를 병합 요소의 직접 하위 요소로 지원하지 않습니다. 예를 들어 다음 레이아웃은 지원되지 않습니다.

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:bind="http://schemas.android.com/apk/res-auto">
   <data>
       <variable name="user" type="com.example.User"/>
   </data>
   <merge><!-- Doesn't work -->
       <include layout="@layout/name"
           bind:user="@{user}"/>
       <include layout="@layout/contact"
           bind:user="@{user}"/>
   </merge>
</layout>

추가 리소스

데이터 결합에 관한 자세한 내용은 다음 추가 리소스를 참고하세요.

샘플

Codelab

블로그 게시물