001 /*
002 * JBoss DNA (http://www.jboss.org/dna)
003 * See the COPYRIGHT.txt file distributed with this work for information
004 * regarding copyright ownership. Some portions may be licensed
005 * to Red Hat, Inc. under one or more contributor license agreements.
006 * See the AUTHORS.txt file in the distribution for a full listing of
007 * individual contributors.
008 *
009 * JBoss DNA is free software. Unless otherwise indicated, all code in JBoss DNA
010 * is licensed to you under the terms of the GNU Lesser General Public License as
011 * published by the Free Software Foundation; either version 2.1 of
012 * the License, or (at your option) any later version.
013 *
014 * JBoss DNA is distributed in the hope that it will be useful,
015 * but WITHOUT ANY WARRANTY; without even the implied warranty of
016 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
017 * Lesser General Public License for more details.
018 *
019 * You should have received a copy of the GNU Lesser General Public
020 * License along with this software; if not, write to the Free
021 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
022 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
023 */
024 package org.jboss.dna.graph.property;
025
026 import java.util.Iterator;
027
028 /**
029 * @author Randall Hauch
030 */
031 public interface PropertyFactory {
032 /**
033 * Create a property with the supplied name and values
034 *
035 * @param name the property name; may not be null
036 * @param values the values
037 * @return the resulting property
038 */
039 Property create( Name name,
040 Object... values );
041
042 /**
043 * Create a property with the supplied name and values
044 *
045 * @param name the property name; may not be null
046 * @param values the values
047 * @return the resulting property
048 */
049 Property create( Name name,
050 Iterable<?> values );
051
052 /**
053 * Create a property with the supplied name and values
054 *
055 * @param name the property name; may not be null
056 * @param values the values
057 * @return the resulting property
058 */
059 Property create( Name name,
060 Iterator<?> values );
061
062 /**
063 * Create a property with the supplied name and values
064 *
065 * @param name the property name; may not be null
066 * @param desiredType the type that the objects should be converted to; if null, they will be used as is
067 * @param values the values
068 * @return the resulting property
069 */
070 Property create( Name name,
071 PropertyType desiredType,
072 Object... values );
073
074 /**
075 * Create a property with the supplied name and values
076 *
077 * @param name the property name; may not be null
078 * @param desiredType the type that the objects should be converted to; if null, they will be used as is
079 * @param values the values
080 * @return the resulting property
081 */
082 Property create( Name name,
083 PropertyType desiredType,
084 Iterable<?> values );
085
086 /**
087 * Create a property with the supplied name and values
088 *
089 * @param name the property name; may not be null
090 * @param desiredType the type that the objects should be converted to; if null, they will be used as is
091 * @param values the values
092 * @return the resulting property
093 */
094 Property create( Name name,
095 PropertyType desiredType,
096 Iterator<?> values );
097
098 }