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 Mountimport java.lang.annotation.ElementType; 19d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mountimport java.lang.annotation.Target; 20d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount 21d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount/** 22d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * InverseBindingMethod is used to identify how to listen for changes to a View property and which 23d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * getter method to call. InverseBindingMethod should be associated with any class as part of 24d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * {@link InverseBindingMethods}. 25d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <p> 26d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <pre> 27d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * @InverseBindingMethods({@InverseBindingMethod( 28d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * type = android.widget.TextView.class, 29d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * attribute = "android:text", 30d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * event = "android:textAttrChanged", 31d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * method = "getText")}) 32d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * public class MyTextViewBindingAdapters { ... } 33d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * </pre> 34d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <p> 35d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <code>method</code> is optional. If it isn't provided, the attribute name is used to 36d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * find the method name, either prefixing with "is" or "get". For the attribute 37d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <code>android:text</code>, data binding will search for a 38d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <code>public CharSequence getText()</code> method on {@link android.widget.TextView}. 39d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <p> 40d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <code>event</code> is optional. If it isn't provided, the event name is assigned the 41d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * attribute name suffixed with <code>AttrChanged</code>. For the <code>android:text</code> 42d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * attribute, the default event name would be <code>android:textAttrChanged</code>. The event 43d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * should be set using a {@link BindingAdapter}. For example: 44d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * <pre> 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 Mount * @see InverseBindingAdapter 72d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * @see InverseBindingListener 73d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 74d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount@Target(ElementType.ANNOTATION_TYPE) 75d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mountpublic @interface InverseBindingMethod { 76d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount 77d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount /** 78d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * The View type that is associated with the attribute. 79d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 80d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount Class type(); 81d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount 82d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount /** 83d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * The attribute that supports two-way binding. 84d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 85d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount String attribute(); 86d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount 87d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount /** 88d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * The event used to notify the data binding system that the attribute value has changed. 89d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * Defaults to attribute() + "AttrChanged" 90d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 91d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount String event() default ""; 92d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount 93d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount /** 94d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * The getter method to retrieve the attribute value from the View. The default is 95d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount * the bean method name based on the attribute name. 96d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount */ 97d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount String method() default ""; 98d3f2b9229472c9dae9bf4ae8b3e2d653b5653b01George Mount} 99