imetadatadocument.java

esri的ArcGIS Server超级学习模板程序（for java）

package com.esri.solutions.jitk.common.metadata;

/**
 * {@link IMetadataDocument} is an interface that objects can implement if they wish to represent a metadata document.
 * <p>
 * To retrieve fields from the metadata document, one must provide an {@link IMetadataExporter} implementation to this
 * document's {@link #export(IMetadataExporter)} method.  The exporter is responsible for extracting whatever information
 * that it requires from the document, coverting it to a meaningful representation, and providing access to that information.
 * </p>
 */
public interface IMetadataDocument {

	/**
	 * Retrieves the {@link IMetadataID} by which this document can be referenced.  
	 * @return The {@link IMetadataID}.  Will never be {@code null}.
	 */
	public IMetadataID getMetadataID();
	/**
	 * Uses the provided {@link IMetadataExporter} to convert the metadata to some meaningful format.
	 * @param exporter The {@link IMetadataExporter} to use.  Cannot be {@code null}
	 */
	public void export(IMetadataExporter exporter);
	/**
	 * Retrieves the {@link IMetadataProfile} of the catalog from which this document was retrieved.  Clients can 
	 * use this information to provide &quot;hints&quot; about the actual format of the metadata.
	 * @return The {@link IMetadataProfile}.  Will never be {@code null}.
	 */
	public IMetadataProfile getMetadataProfile();
	
}