Package org.apache.felix.metatype

Class MetaDataReader

java.lang.Object

org.apache.felix.metatype.MetaDataReader

@Deprecated(since="2021-05-27")
public class MetaDataReader
extends Object

Deprecated.

The Apache Felix metatype API is deprecated, please use the OSGi metatype API instead.

The MetaDataReader provides two methods to read meta type documents according to the MetaType schema (105.8 XML Schema). The parse(URL) and parse(InputStream) methods may be called multiple times to parse such documents.

While reading the XML document java objects are created to hold the data. These objects are created by factory methods. Users of this may extend this class by overwriting the the factory methods to create specialized versions. One notable use of this is the extension of the AD class to overwrite the AD.validate(String) method. In this case, the createAD() method would be overwritten to return an instance of the extending class.

This class is not thread safe. Using instances of this class in multiple threads concurrently is not supported and will fail.

Constructor Summary

Constructors

Constructor	Description
MetaDataReader()	Deprecated.

Method Summary

Modifier and Type	Method	Description
MetaData	parse(InputStream ins)	Deprecated. Parses the XML document in the given input stream.
MetaData	parse(URL url)	Deprecated. Parses the XML document provided by the url.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MetaDataReader

public MetaDataReader()

Deprecated.

Method Detail

parse

public MetaData parse(URL url)
               throws IOException

Deprecated.

Parses the XML document provided by the url. The XML document must be at the beginning of the stream contents.

This method is almost identical to return parse(url.openStream()); but also sets the string representation of the URL as a location helper for error messages.

Parameters:

url - The URL providing access to the XML document.

Returns:

A MetaData providing access to the raw contents of the XML document.

Throws:

IOException - If an I/O error occurs accessing the stream or parsing the XML document.

parse

public MetaData parse(InputStream ins)
               throws IOException

Deprecated.

Parses the XML document in the given input stream.

This method starts reading at the current position of the input stream and returns immediately after completely reading a single meta type document. The stream is not closed by this method.

Parameters:

ins - The InputStream providing the XML document

Returns:

A MetaData providing access to the raw contents of the XML document.

Throws:

IOException - If an I/O error occurs accessing the stream or parsing the XML document.