001// Licensed to the Apache License, Version 2.0 (the "License");
002// you may not use this file except in compliance with the License.
003// You may obtain a copy of the License at
004//
005//     http://www.apache.org/licenses/LICENSE-2.0
006//
007// Unless required by applicable law or agreed to in writing, software
008// distributed under the License is distributed on an "AS IS" BASIS,
009// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
010// See the License for the specific language governing permissions and
011// limitations under the License.
012
013package org.apache.tapestry5.commons;
014
015import org.apache.tapestry5.ioc.annotations.UsesOrderedConfiguration;
016
017/**
018 * <p>
019 * Interface implemented by classes which converts objects to
020 * {@link RecursiveValue} instances.
021 * </p>
022 * <p>
023 * This was contributed by <a href="https://www.pubfactory.com">KGL PubFactory</a>.
024 * </p>
025 * @since 5.9.0
026 */
027@UsesOrderedConfiguration(RecursiveValueProvider.class)
028public interface RecursiveValueProvider
029{
030
031    /**
032     * Returns a {@link RecursiveValue} for this <code>object</code> or
033     * returns <code>null</code> if the object isn't handled.
034     * @param object an {@link Object}.
035     * @return a {@link RecursiveValue} or <code>null</code>.
036     */
037    RecursiveValue<?> get(Object object);
038    
039}