1d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount/* 2d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * Copyright (C) 2015 The Android Open Source Project 3d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * 4d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * Licensed under the Apache License, Version 2.0 (the "License"); 5d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * you may not use this file except in compliance with the License. 6d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * You may obtain a copy of the License at 7d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * 8d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * http://www.apache.org/licenses/LICENSE-2.0 9d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * 10d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * Unless required by applicable law or agreed to in writing, software 11d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * distributed under the License is distributed on an "AS IS" BASIS, 12d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * See the License for the specific language governing permissions and 14d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * limitations under the License. 15d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 16d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mountpackage android.databinding; 17d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount 18d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount/** 19d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * A listener implemented by all two-way bindings to be notified when a triggering change happens. 20d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * For example, when there is a two-way binding for android:text, an implementation of 21d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <code>InverseBindingListener</code> will be generated in the layout's binding class. 22d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <pre> 23d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * private static class InverseListenerTextView implements InverseBindingListener { 24d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * @Override 25d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * public void onChange() { 26d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * mObj.setTextValue(mTextView.getText()); 27d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 28d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 29d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * </pre> 30d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <p> 31d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * A {@link BindingAdapter} should be used to assign the event listener. 32d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * For example, <code>android:onTextChanged</code> will need to trigger the event listener 33d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * for the <code>android:text</code> attribute. 34d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <pre> 35d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * @InverseBindingAdapter(attribute = "android:text", event = "android:textAttrChanged") 36d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * public static void captureTextValue(TextView view, ObservableField<CharSequence> value) { 37d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * CharSequence newValue = view.getText(); 38d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * CharSequence oldValue = value.get(); 39d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * if (oldValue == null) { 40d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * value.set(newValue); 41d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } else if (!contentEquals(newValue, oldValue)) { 42d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * value.set(newValue); 43d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 44d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 45f2b497e3dc3946fec708fb8e86a29e234bf0506cYigit Boyar * @BindingAdapter(value = {"android:beforeTextChanged", "android:onTextChanged", 46d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * "android:afterTextChanged", "android:textAttrChanged"}, 47d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * requireAll = false) 48d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * public static void setTextWatcher(TextView view, final BeforeTextChanged before, 49d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * final OnTextChanged on, final AfterTextChanged after, 50d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * final InverseBindingListener textAttrChanged) { 51d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * TextWatcher newValue = new TextWatcher() { 52d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * ... 53f2b497e3dc3946fec708fb8e86a29e234bf0506cYigit Boyar * @Override 54d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * public void onTextChanged(CharSequence s, int start, int before, int count) { 55d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * if (on != null) { 56d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * on.onTextChanged(s, start, before, count); 57d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 58d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * if (textAttrChanged != null) { 59d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * textAttrChanged.onChange(); 60d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 61d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 62d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 63d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * TextWatcher oldValue = ListenerUtil.trackListener(view, newValue, R.id.textWatcher); 64d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * if (oldValue != null) { 65d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * view.removeTextChangedListener(oldValue); 66d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 67d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * view.addTextChangedListener(newValue); 68d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * } 69d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * </pre> 70d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 71d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mountpublic interface InverseBindingListener { 72d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount /** 73d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * Notifies the data binding system that the attribute value has changed. 74d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 75d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount void onChange(); 76d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount} 77