1 /* 2 * Copyright 1999-2004 The Apache Software Foundation 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 package org.apache.commons.jxpath; 17 18 /** 19 * A generic mechanism for accessing collections of name/value pairs. 20 * Examples of such collections are HashMap, Properties, 21 * ServletContext. In order to add support for a new such collection 22 * type to JXPath, perform the following two steps: 23 * <ol> 24 * <li>Build an implementation of the DynamicPropertyHandler interface 25 * for the desired collection type.</li> 26 * <li>Invoke the static method {@link JXPathIntrospector#registerDynamicClass 27 * JXPathIntrospector.registerDynamicClass(class, handlerClass)}</li> 28 * </ol> 29 * JXPath allows access to dynamic properties using these three formats: 30 * <ul> 31 * <li><code>"myMap/myKey"</code></li> 32 * <li><code>"myMap[@name = 'myKey']"</code></li> 33 * <li><code>"myMap[name(.) = 'myKey']"</code></li> 34 * </ul> 35 * 36 * @author Dmitri Plotnikov 37 * @version $Revision: 1.5 $ $Date: 2004/02/29 14:17:42 $ 38 */ 39 public interface DynamicPropertyHandler { 40 41 /** 42 * Returns a list of dynamic property names for the supplied object. 43 */ 44 String[] getPropertyNames(Object object); 45 46 /** 47 * Returns the value of the specified dynamic property. 48 */ 49 Object getProperty(Object object, String propertyName); 50 51 /** 52 * Modifies the value of the specified dynamic property. 53 */ 54 void setProperty(Object object, String propertyName, Object value); 55 }