package org.eclipse.equinox.metatype.i1;

import java.util.List;

/**

 * A value for an attribute of an object.

 * 

 * An Attribute contains the data from a single <code>&lt;attribute&gt;</code> 

 * element within the metadata XML. It represents a value, whose intent and 

 * format are described by the associated {@link #getAttributeDefinition() 

 * attribute definition}, for a configuration dictionary.

 * 

 * @ThreadSafe

 * @noimplement This interface is not intended to be implemented by clients.

 */

public interface Attribute extends Extendable {

	/**

	 * Returns the attribute definition associated with this attribute as 

	 * defined by the <code>adref</code> attribute of the <code>

	 * &lt;attribute&gt;</code> element.

	 * 

	 * @return The attribute definition associated with this attribute.

	 */

	EquinoxAttributeDefinition getAttributeDefinition();

	/**

	 * Returns the values for this attribute as specified within the <code>

	 * content</code> attribute of the <code>&lt;attribute&gt;</code> element. 

	 * If there is more than one value, the returned string will be a 

	 * comma-delimited list. All escape characters are retained.

	 * 

	 * @return The values for this attribute.

	 */

	String getContent();

	/**

	 * Returns the list of values for this attribute as specified within zero 

	 * or more child <code>&lt;value&gt;</code> elements of the <code>

	 * &lt;attribute&gt;</code> element. The list order represents the element 

	 * order presented within the XML. The list will be empty if no <code>

	 * &lt;value&gt;</code> elements were present.

	 * 

	 * @return A list of values for this attribute.

	 */

	List<String> getValues();

}

package org.eclipse.equinox.metatype.i1;

public interface Designate extends Extendable {

	String getBundle();

	String getFactoryPid();

	boolean isMerge();

	boolean isOptional();

	DesignateObject getObject();

	String getPid();

}

package org.eclipse.equinox.metatype.i1;

import java.util.List;

public interface DesignateObject extends Extendable {

	List<Attribute> getAttributes();

	EquinoxObjectClassDefinition getObjectClassDefinition();

}

package org.eclipse.equinox.metatype.i1;

import org.osgi.service.metatype.AttributeDefinition;

public interface EquinoxAttributeDefinition extends AttributeDefinition, Extendable {

	// Empty interface to support extendable attribute definitions.

}

package org.eclipse.equinox.metatype.i1;

import org.osgi.service.metatype.MetaTypeInformation;

public interface EquinoxMetaTypeInformation extends MetaTypeInformation {

	EquinoxObjectClassDefinition getObjectClassDefinition(String id, String locale);

}

package org.eclipse.equinox.metatype.i1;

import org.osgi.framework.Bundle;

import org.osgi.service.metatype.MetaTypeService;

public interface EquinoxMetaTypeService extends MetaTypeService {

	EquinoxMetaTypeInformation getMetaTypeInformation(Bundle bundle);

}

package org.eclipse.equinox.metatype.i1;

import java.util.List;

import org.osgi.service.metatype.ObjectClassDefinition;

public interface EquinoxObjectClassDefinition extends ObjectClassDefinition, Extendable {

	List<Designate> getDesignates();

	EquinoxAttributeDefinition[] getAttributeDefinitions(int filter);

}

package org.eclipse.equinox.metatype.i1;

import java.util.Map;

import java.util.Set;

public interface Extendable {

	Map<String, String> getExtensionAttributes(String schema);

	Set<String> getExtensionSchemas();

}